IBM: STPL

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.

STPL

Prolog

Control Block Contents

STPL DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

STPL Prolog
 Name       : DMSSTPL
 Description: CMSSTOR parameter list macro
 DSECT      : STPL
 Function   : Mapping macro which maps the
              parameters generated by the CMSSTOR macro.

STPL Control Block Content


STPL DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      STPL           CMSSTOR parameter list macro
     NOTES : On a SVC invocation of CMSSTOR data is passed to storage
     management via the USEUFLG in USAVE. This is done for the purpose of
     reentrancy. The CMSCALL expansion in CMSSTOR will set these bits in R15
     and DMSITS will place them in USEUFLG. The STPLUFCO bit is used to
     determine if we should abend on error conditions. On BALR linkgae this
     is determined by the entry point invoked. The STPLBYLO bit is used to
     determine "where" to find the BYTES/DWORDS bit. On BALR linkage the
     BYTES/DWORDS bit is always bit 32 of R1. The STPLUFBY is the SVC
     counterpart to bit 32 of R1 on a BALR. It may or may not be used
     depending upon the setting of STPLBYLO. If it is not used, STPLBYT in
     STPLFG2 will be used instead. This happens when BYTES/DWRODS was
     specified on the list form of the macro instead of the E form or
     standard form.
     EQUATES used for mapping USEUFLG in USAVE on SVC invocation
          1... ....      STPLUFCO       X'80' Conditional Request - Don't
                                        ABEND.
          .1.. ....      STPLBYLO       X'40' Use STPLUFBY to test for
                                        BYTES/DWORDS, else use STPLBYT
                                        for the test.
          ..1. ....      STPLUFBY       X'20' BYTES is in R0, else
                                        DWORDS.
0000    0 Character    8 STPLEPN        Entry Point Name
0008    8 Character    8 STPLSPN        Subpool Name
0010   16 Signed       4 STPLSIZ        Storage size in Bytes or D-Words
0014   20 Signed       4 STPLMIN        Minimum value for a variable
                                        request
0018   24 Signed       4 STPLADR        Address of Storage on call
001C   28 Bitstring    1 STPLFG1        For both OBTAIN and RELEASE
          1... ....      STPLSPS        X'80' The subpool name was
                                        specified
          .1.. ....      STPLGBL        X'40' Global was specified on the
                                        name
          ...1 ....      STPLMSG        X'10' The MSG parameter was
                                        specified as NO
          .... 1...      STPLADD        X'08' The ADDR parameter was
                                        specified
          .... ..11      STPLBEL        X'03' LOC=BELOW was specified
          .... ..1.      STPLABV        X'02' LOC=ABOVE was specified
          .... ...1      STPLANY        X'01' LOC=ANY was specified
          .... ....      STPLSAM        X'00' LOC=SAME was specified
001D   29 Bitstring    1 STPLFG2        For OBTAIN only
          1... ....      STPLMNM        X'80' "min" was specified for
                                        BYTES/DWORDS
          .1.. ....      STPLPAG        X'40' Page alignment was
                                        requested
          .... 1...      STPLSST        X'08' Subpool='xxxxxxxx'
                                        specified. DO NOT search
                                        preferred subpools in DMSFRO
          .... .1..      STPLMRG        X'04' Value for MIN in plist is a
                                        Register Number
          .... ..1.      STPLARG        X'02' Value for ADDR in plist is
                                        a Register Number
          .... ...1      STPLBYT        X'01' Bytes was specified on LIST
                                        form
001E   30 Bitstring    1 STPLSPC        Code byte when preferred subpool
                                        used
001F   31 Bitstring    1 *              Reserved
0020   32 Character    8 *              Plist Fence
          00000028       STPLSZB        *-STPL Size of parameter list in
                                        bytes
          00000005       STPLSZD        (STPLSZB+7)/8 Size of parameter
                                        list in dwords MACRO DMSSPPL
                                        (CREATED: 07/11/86 20:51:02)

STPL Storage Layout

*** STPL - CMSSTOR parameter list macro
*
*     +-------------------------------------------------------+
*   0 |                       STPLEPN                         |
*     +-------------------------------------------------------+
*   8 |                       STPLSPN                         |
*     +---------------------------+---------------------------+
*  10 |         STPLSIZ           |         STPLMIN           |
*     +---------------------------+------+------+------+------+
*  18 |         STPLADR           |:LFG1 |:LFG2 |:LSPC |//////|
*     +---------------------------+------+------+------+------+
*  20 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  28
*
*** STPL - CMSSTOR parameter list macro