SHPBK - 32-bit CP - V4R4.0

Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### SHPBK

Prolog

Control Block Contents
SHPBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### 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.
              ...1 ....      SHPTRFRZ       X'10' CSE tracing freeze bit.
                                            Stop tracing if we are going to
                                            sync.
    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

#### 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 |///////////////////////////////////////////////////////|
    *     |///////////////////////////////////////////////////////|
    *     +-------------------------------------------------------+
    *
    *** SHPBK - Control Block in SHPBK

#### SHPBK Cross Reference

    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       0041 10
    SHPTROFF       0041 20
    SHPTYPE        0038
    SHPTYPEM       0038 80
    SHPTYPES       0038 40
    SHPVRANC       0050
    SHPVRLAS       0054
    SHPWKQ2        003A 20

This information is based on z/VM V4R4.0. Last updated on 29 Jul 2003 at 16:16:22 EDT.
Copyright IBM Corporation, 1990, 2003