SHPBK | Back to Index page

| Prolog Control Block Contents SHPBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

SHPBK Prolog | Top of page

    Name       :  SHPBK
    DSECT      :  SHPBK
    Description:  Map/Generate CSE Sys Definition Table

SHPBK Control Block Content | Top of page

     SHPBK DSECT
    Top of page

    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 Address      4 SHPQ1          Q1 chain
    002C   44 Address      4 SHPQ2          Q2 chain
    0030   48 Address      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... ....      SHPTYPEM       X'80' SHPTYPEM Main system
              .1.. ....      SHPTYPES       X'40' SHPTYPES Associated system
    0039   57 Bitstring    1 SHPSTAT        S*2 System status field
              1... ....      SHPMSG         X'80' SHPMSG Msg 972W was already
                                            sent
              .1.. ....      SHPSYNTK       X'40' SHPSYNTK Synchronization
                                            task running
              ...1 ....      SHPLKDR        X'10' SHPLKDR CVM has lost
                                            communication with System-B
              .... 1...      Q1TIMPOP       X'08' Q1TIMPOP Q1 is not being
                                            serviced
              .... .1..      SHPSYNCR       X'04' SHPSYNCR Request
                                            synchronization
              .... ..1.      SHPINIT        X'02' SHPINIT CVM was initialized
                                            at least once
              .... ...1      SHPCVMA        X'01' SHPCVMA The CVM is active
                                            In an SSI environment CP is the
                                            CVM so it is always active, thus
                                            in the main SHPBK this bit is
                                            always set. In an associated
                                            SHPBK this bit is set if we have
                                            a socket open with that member.
    003A   58 Bitstring    1 SHPFLG1        S*3 First flag field
              .1.. ....      SHPDBACT       X'40' SHPDBACT Deferred buffer
                                            task is active
              ..1. ....      SHPWKQ2        X'20' SHPWKQ2 Processing Q2
              ...1 ....      SHPTRFIN       X'10' SHPTRFIN Incoming traffic
                                            received
              .... 1...      SHPTIMDA       X'08' SHPTIMDA Disable timer pops
              .... .1..      SHPPOSTR       X'04' SHPPOSTR Post the CVM for
                                            this system
              .... ..1.      SHPQ1TST       X'02' SHPQ1TST Q1 timer is set
              .... ...1      SHPPOST        X'01' SHPPOST The CVM has been
                                            posted (CSE) Transport thread
                                            running (SSI)
    003B   59 Bitstring    1 SHPINDEX       S*4 System Index in bit map form
    003C   60 Signed       1 SHPLNSNM       S*5 Length of system name
    003D   61 Signed       1 SHPLNUNM       S*6 Length of the CVM name
    003E   62 Signed       1 SHPLNANM       S*7 Length of system name alias
    003F   63 Signed       1 SHPBNDX        S*8 System Index in binary
    0040   64 Bitstring    1 SHPISFRI       S*9 CSE level code, if known
                                            defined for the other. In an SSI
                                            environment SHPISFRI is intended
                                            to be a counter not a bitmap and
                                            it should be tested with CLI not
                                            TM.
              .... ....      SHPISFR0       X'00' SHPISFR0 CSE Release not
                                            known
              .... ...1      SHPISFR1       X'01' SHPISFR1 CSE level 1
              .... ..1.      SHPISFR2       X'02' SHPISFR2 CSE level 2
              .... ..11      SHPISFR3       X'03' SHPISFR3 CSE level 3
              .... .111      SHPISFR4       X'07' SHPISFR4 CSE level 4
              .... ...1      SHPSSIR1       X'01' SHPSSIR1 SSI level 1 Notes
                                            : SHPISFRI is combined with
                                            SHPSSTAT (below) so the
    0041   65 Bitstring    1 SHPSSTAT       S*10 Spool sharing status byte
                                            defined for the other.
              1... ....      SHPNSHRS       X'80' SHPNSHRS Cross system
                                            spooling with this system was
                                            disabled by SYSGEN.
              .1.. ....      SHPNSHRQ       X'40' SHPNSHRQ Cross system
                                            spooling with this system was
                                            disabled by QITEM.
              ..1. ....      SHPTROFF       X'20' SHPTROFF Stop CSE tracing.
              ...1 ....      SHPTRFRZ       X'10' SHPTRFRZ CSE tracing freeze
                                            bit. Stop tracing if we are going
                                            to sync. Notes : SHPSSTAT is
                                            combined with SHPISFRI (above) so
                                            the
    0042   66 Bitstring    1 SHPGSDLK       S*11 CSE command lock used by XCC
    0043   67 Bitstring    1 SHPHPOOL       RDR *SPL system index
    0044   68 Address      4 *              Reserved for IBM use
    0048   72 Address      4 SHPDBANC       Anchor of deferred buffer chain
    004C   76 Address      4 SHPDBLAS       Pointer to last deferred buffer
    0050   80 Signed       4 SHPUSRS        Count of logged on users
    0054   84 Signed       4 SHPDIALD       Count of dialed users
    0058   88 Signed       4 SHPLUCNT       Count of SNA users
    005C   92 Signed       4 SHPSOCK        Socket identifier In the main
                                            system's SHPBK this socket handle
                                            is used for USRBK broadcasts. In
                                            an associate system's SHPBK this
                                            socket handle is used for CSE
                                            QITEMs.
    0060   96 Dbl-Word     8 SHPRETRY (0)   ** START of RETRY USRBK Fields **
                                            SHPRETRY updated with compare and
                                            swap double rather than via a
                                            lock
    0060   96 Dbl-Word     8 SHPLCSYS (0)   for LoCal SYStem:
    0060   96 Bitstring    4 SHPJFAL        Join FAiLed mask of systems
    0064  100 Bitstring    4 SHPJSUC        Join SUCcess mask of systems
    0060   96 Dbl-Word     8 SHPRMSYS (0)   for ReMote SYStems:
    0060   96 Address      4 SHPLPTR        List PoinTeR to retry userids
    0064  100 Bitstring    1 SHPRBY1        Retry BYte 1:
              1... ....      SHPRS          X'80' SHPRS Retry Scheduled DS X
                                            Reserved for IBM use
    0066  102 Signed       2 SHPLCNT        List CouNTer of users to retry
                                            **** END of RETRY USRBK Fields
    0068  104 Address      4 *              Reserved for IBM use
    006C  108 Address      4 *              Reserved for IBM use
    0070  112 Dbl-Word     8 SHPLOCK (6)    Used by spin lock logic Unless
                                            otherwise noted: Fields above
                                            this line are protected by the
                                            spin lock Fields below this line
                                            are protected by the defer lock
                                            If both are required the defer
                                            lock must be obtained first
    00A0  160 Dbl-Word     8 SHPDLOCK (3)   Used by defer lock logic
    00B8  184 Address      4 SHPRPG         A(RPAGES DSECT)
    00BC  188 Address      4 SHPCPEX        Sync CPEBK to stack, plus the
                                            SYNC1/2/3 byte. This byte must be
                                            cleared before the contents of
                                            SHPCPEX can be used to address
                                            the CPEBK. SHPCPEX updated with
                                            compare and swap rather than via
                                            a lock
    00C0  192 Address      8 *              Reserved for IBM use
    00C8  200 Address      4 *              Reserved for IBM use
    00CC  204 Address      4 *              Reserved for IBM use
    00D0  208 Dbl-Word     8 SHPEND (0)
              000000D0       SHPSZ          (*-SHPSYSNM)
              0000001A       SHPSZD         (*-SHPSYSNM)/8 Size in d-words

SHPBK Storage Layout | Top of page

    *** 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 |         SHPUSRS           |         SHPDIALD          |
    *     +---------------------------+---------------------------+
    *  58 |         SHPLUCNT          |         SHPSOCK           |
    *     +---------------------------+---------------------------+
    *  60 |         SHPJFAL           |         SHPJSUC           |
    *     +---------------------------+---------------------------+
    *  68
    *
    *** SHPBK - Control Block in SHPBK

    *** Overlay for SHPRETRY in SHPBK
    *
    *     +---------------------------+------+------+-------------+
    *  60 |         SHPLPTR           |:RBY1 |//////|  SHPLCNT    |
    *     +---------------------------+------+------+-------------+
    *  68 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *  70 |                                                       |
    *     =                       SHPLOCK                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  A0 |                                                       |
    *     =                       SHPDLOCK                        =
    *     |                                                       |
    *     +---------------------------+---------------------------+
    *  B8 |          SHPRPG           |         SHPCPEX           |
    *     +---------------------------+---------------------------+
    *  C0 |///////////////////////////////////////////////////////|
    *     +---------------------------+---------------------------+
    *  C8 |///////////////////////////|///////////////////////////|
    *     +---------------------------+---------------------------+
    *
    *** Overlay for SHPRETRY in SHPBK

SHPBK Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    Q1TIMPOP       0039 08
    SHPADT1        0030
    SHPALIAS       0010
    SHPBNDX        003F
    SHPCPEX        00BC
    SHPCVM         0008
    SHPCVMA        0039 01
    SHPDBACT       003A 40
    SHPDBANC       0048
    SHPDBLAS       004C
    SHPDIALD       0054
    SHPDLOCK       00A0
    SHPEND         00D0
    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
    SHPJFAL        0060
    SHPJSUC        0064
    SHPLCNT        0066
    SHPLCSYS       0060
    SHPLKDR        0039 10
    SHPLN          0034
    SHPLNANM       003E
    SHPLNSNM       003C
    SHPLNUNM       003D
    SHPLOCK        0070
    SHPLPTR        0060
    SHPLUCNT       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
    SHPRBY1        0064
    SHPRETRY       0060
    SHPRMSYS       0060
    SHPRPG         00B8
    SHPRS          0064 80
    SHPSOCK        005C
    SHPSSIR1       0040 01
    SHPSSTAT       0041
    SHPSTAT        0039
    SHPSYNCR       0039 04
    SHPSYNTK       0039 40
    SHPSYSNM       0000
    SHPSZ          00D0 000000D0
    SHPSZD         00D0 0000001A
    SHPTIMDA       003A 08
    SHPTRFIN       003A 10
    SHPTRFRZ       0041 10
    SHPTROFF       0041 20
    SHPTYPE        0038
    SHPTYPEM       0038 80
    SHPTYPES       0038 40
    SHPUSRS        0050
    SHPWKQ2        003A 20

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:32:55 EDT.
Copyright IBM Corporation, 1990, 2020