Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
SHPBK
Cross Reference (Contains links to field and bit definitions)
SHPBK Prolog
Name : HCPSHPBK DSECT : SHPBK Description: Map or Generate sys def table for CSE Notes : Invocation - HCPSHPBK LNAME=system-name, TYPE=M|S TQ1=tq1, IND=ind, CVMID=cvmid, ALIAS=alias, GENCODE=YES|NO where: "system-name" is the cross system node name of an associated system. TYPE=M means that the system being described is the main system, that is, the system on which this copy of the VM/XA SP control program with CSE active will run. TYPE=S means that the system being described is a secondary system, one associated with the main system in the complex. "tq1" is the number of seconds that associated system "system-name" will wait for a response before assuming that the system it was communicating with is down. The default timeout value is 12 seconds. "ind" is a numeric value from 1 to 8, the index of this entry in the associated system tables. "cvmid" is the user-id of the CSE Communication Virtual Machine (CVM). "alias" is another name for "system-name". GENCODE=YES will cause the actual table to be built. Otherwise a DSECT is generated, since GENCODE=NO is the default.
SHPBK Control Block Content
SHPBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure SHPBK Map/Generate CSE Sys Definition Table 0000 0 Character 8 SHPSYSNM Logical system name 0008 8 Character 8 SHPCVM CSE Communication VM name 0010 16 Character 8 SHPALIAS System name alias 0018 24 Signed 4 SHPNQ1 Number of entries in Q1 001C 28 Signed 4 SHPNQ2 Number of entries in Q2 0020 32 Signed 4 SHPNQ1T Number of times Q1 serviced 0024 36 Signed 4 SHPNQ2T Number of times Q2 serviced 0028 40 Signed 4 SHPQ1 Q1 chain 002C 44 Signed 4 SHPQ2 Q2 chain 0030 48 Signed 4 SHPADT1 Address of Q1 timer element 0034 52 Address 2 SHPLN Table length in bytes 0036 54 Signed 2 SHPQ1DEL Number of seconds to wait in Q1 0038 56 Bitstring 1 SHPTYPE S*1 System type (Main or Shared) .1.. .... SHPTYPES X'40' Associated system 1... .... SHPTYPEM X'80' Main system 0039 57 Bitstring 1 SHPSTAT S*2 System status field .... ...1 SHPCVMA X'01' The CVM is active .... ..1. SHPINIT X'02' CVM was initialized at least once .... .1.. SHPSYNCR X'04' Request synchronization .... 1... Q1TIMPOP X'08' Q1 is not being serviced ...1 .... SHPLKDR X'10' CVM has lost communication with System-B 1... .... SHPMSG X'80' Msg 972W was already sent 003A 58 Bitstring 1 SHPFLG1 S*3 First flag field .... ...1 SHPPOST X'01' The CVM has been posted .... ..1. SHPQ1TST X'02' Q1 timer is set .... .1.. SHPPOSTR X'04' Post the CVM for this system .... 1... SHPTIMDA X'08' Disable timer pops ...1 .... SHPTRFIN X'10' Incoming traffic received ..1. .... SHPWKQ2 X'20' Processing Q2 .1.. .... SHPDBACT X'40' Deferred buffer task is active 003B 59 Address 1 SHPINDEX S*4 System Index in bit map form 003C 60 Address 1 SHPLNSNM S*5 Length of system name 003D 61 Address 1 SHPLNUNM S*6 Length of the CVM name 003E 62 Address 1 SHPLNANM S*7 Length of system name alias 003F 63 Address 1 SHPBNDX S*8 System Index in binary 0040 64 Address 1 SHPISFRI S*9 CSE level code, if known .... .... SHPISFR0 X'00' CSE Release not known .... ...1 SHPISFR1 X'01' CSE level 1 .... ..1. SHPISFR2 X'02' CSE level 2 .... ..11 SHPISFR3 X'03' CSE level 3 .... .111 SHPISFR4 X'07' CSE level 4 0041 65 Bitstring 1 SHPSSTAT S*10 Spool sharing status byte 1... .... SHPNSHRS X'80' Cross system spooling with this system was disabled by SYSGEN. .1.. .... SHPNSHRQ X'40' Cross system spooling with this system was disabled by QITEM. ..1. .... SHPTROFF X'20' Stop CSE tracing. 0042 66 Bitstring 1 SHPGSDLK S*11 CSE command lock used by XCC 0043 67 Bitstring 1 SHPHPOOL RDR *SPL system index 0044 68 Bitstring 4 * Reserved for IBM use 0048 72 Signed 4 SHPDBANC Anchor of deferred buffer chain 004C 76 Signed 4 SHPDBLAS Pointer to last deferred buffer 0050 80 Signed 4 SHPVRANC Anchor of V=R guest device chain 0054 84 Signed 4 SHPVRLAS Pointer to last V=R guest device 0058 88 Dbl-Word 8 SHPLOCK (3) Used by spin lock logic 0070 112 Dbl-Word 8 * (2) Reserved for IBM use 0080 128 Dbl-Word 8 SHPEND (0) 00000080 SHPSZ (*-SHPSYSNM) 00000010 SHPSZD (*-SHPSYSNM)/8 Size in d-words ...1 .... SHPTRFRZ X'10' CSE tracing freeze bit. Stop tracing if we are going to sync.
SHPBK Storage Layout
*** SHPBK - Control Block in SHPBK * * +-------------------------------------------------------+ * 0 | SHPSYSNM | * +-------------------------------------------------------+ * 8 | SHPCVM | * +-------------------------------------------------------+ * 10 | SHPALIAS | * +---------------------------+---------------------------+ * 18 | SHPNQ1 | SHPNQ2 | * +---------------------------+---------------------------+ * 20 | SHPNQ1T | SHPNQ2T | * +---------------------------+---------------------------+ * 28 | SHPQ1 | SHPQ2 | * +---------------------------+-------------+-------------+ * 30 | SHPADT1 | SHPLN | SHPQ1DEL | * +------+------+------+------+------+------+------+------+ * 38 |:TYPE |:STAT |:FLG1 |:INDEX|:LNSNM|:LNUNM|:LNANM|:BNDX | * +------+------+------+------+------+------+------+------+ * 40 |:ISFRI|:SSTAT|:GSDLK|:HPOOL|///////////////////////////| * +------+------+------+------+---------------------------+ * 48 | SHPDBANC | SHPDBLAS | * +---------------------------+---------------------------+ * 50 | SHPVRANC | SHPVRLAS | * +---------------------------+---------------------------+ * 58 | | * = SHPLOCK = * | | * +-------------------------------------------------------+ * 70 |///////////////////////////////////////////////////////| * |///////////////////////////////////////////////////////| * +-------------------------------------------------------+ * 80 | | * = SHPEND = * | | * +-------------------------------------------------------+ * *** SHPBK - Control Block in SHPBK
SHPBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----Q1TIMPOP 0039 08
SHPADT1 0030
SHPALIAS 0010
SHPBNDX 003F
SHPCVM 0008
SHPCVMA 0039 01
SHPDBACT 003A 40
SHPDBANC 0048
SHPDBLAS 004C
SHPEND 0080
SHPFLG1 003A
SHPGSDLK 0042
SHPHPOOL 0043
SHPINDEX 003B
SHPINIT 0039 02
SHPISFRI 0040
SHPISFR0 0040 00
SHPISFR1 0040 01
SHPISFR2 0040 02
SHPISFR3 0040 03
SHPISFR4 0040 07
SHPLKDR 0039 10
SHPLN 0034
SHPLNANM 003E
SHPLNSNM 003C
SHPLNUNM 003D
SHPLOCK 0058
SHPMSG 0039 80
SHPNQ1 0018
SHPNQ1T 0020
SHPNQ2 001C
SHPNQ2T 0024
SHPNSHRQ 0041 40
SHPNSHRS 0041 80
SHPPOST 003A 01
SHPPOSTR 003A 04
SHPQ1 0028
SHPQ1DEL 0036
SHPQ1TST 003A 02
SHPQ2 002C
SHPSSTAT 0041
SHPSTAT 0039
SHPSYNCR 0039 04
SHPSYSNM 0000
SHPSZ 0080 00000080
SHPSZD 0080 00000010
SHPTIMDA 003A 08
SHPTRFIN 003A 10
SHPTRFRZ 0080 10
SHPTROFF 0041 20
SHPTYPE 0038
SHPTYPEM 0038 80
SHPTYPES 0038 40
SHPVRANC 0050
SHPVRLAS 0054
SHPWKQ2 003A 20
Last updated on 3 Aug 1999 at 13:57:00 EDT.
Copyright IBM Corporation, 1990, 1999