SDPL | Back to Index page

| Prolog Control Block Contents SDPL DSECT SDPG 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.

SDPL Prolog | Top of page

     NAME       : HCPSDPL
     DESCRIPTION: SNAP DATA PARAMETER LIST
     DSECT      : SDPL
     FUNCTION   : A SDPL LIST IS BUILT BY A CP MODULE WHICH ISSUES A
                  A SOFT ABEND TO INDICATE ADDITIONAL DATA AREA(S)
                  TO BE PRESERVED IN THE SOFT ABEND DUMP.
     LOCATED BY : BY REGISTER 1 FROM THE HCPABEND MACRO
     CREATED BY : THE CALLER OF THE SOFT ABEND PROCESSOR
     DELETED BY : THE CALLER OF THE SOFT ABEND PROCESSOR
     SERIALIZED : THE CALLER
     RELOCATION CONSIDERATIONS : None

SDPL Control Block Content | Top of page

     SDPL DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SDPL           SNAP DATA PARAMETER LIST
    0000    0 Character   12 SDPLIST (0)    SDPL ENTRY
    0000    0 Address      4 SDPLID         ADDRESS OF THE SNAP ID
    0004    4 Address      4 SDPLDA         ADDRESS OF SNAP DATA
    0008    8 Bitstring    1 SDPLFLG        Flag byte
              1... ....      SDPLADL        X'80' SDPLADL Snap ID and Data
                                            address length On = 64-bit, Off =
                                            31-bit
              .1.. ....      SDPLADT        X'40' SDPLADT Snap ID and Data
                                            address type On = host real, Off
                                            = host logical
    0009    9 Bitstring    1 SDPLIDLN       LENGTH OF SNAP ID (0-32 BYTES)
    000A   10 Signed       2 SDPLDALN       LENGTH OF SNAP DATA (1- 65K)
              0000000C       SDPLLN         *-SDPLID LENGTH OF SDPL ENTRY
    000C   12 Signed       4 SDPLNXT (0)    NEXT SNAP DATA LIST ENTRY
              0SDPLNXT       SDPLEOL        X'FFFFFFFF' SDPLEOL SNAP DATA
                                            PARAMTER END OF LIST INDICA
    000C   12 Signed       4 SDPLREST (0)   START OF VARIABLE LENGTH DATA
                                            THIS AREA CONTAINS AS MANY
                                            MULTIPLE COPIES OF THE ABOVE
                                            FIELDS (SDPLID-SDPLDALN) AS IS
                                            NECESSARY.

     SDPG DSECT
    Top of page

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      SDPG           SNAP DATA PARAMETER LIST
    0000    0 Dbl-Word     8 SDPGID         Address of the Snap ID
    0008    8 Bitstring    1 SDPGFLG        Flag byte
              1... ....      SDPGADL        X'80' SDPGADL Snap ID and Data
                                            address length On = 64-bit, Off =
                                            31-bit
              .1.. ....      SDPGADT        X'40' SDPGADT Snap ID and Data
                                            address type On = host real, Off
                                            = host logical
    0009    9 Bitstring    1 SDPGIDLN       Length of Snap ID (0-32 bytes)
    000A   10 Signed       2 SDPGDALN       Length of Snap Data (1- 65K) DS F
                                            Reserved for IBM use
    0010   16 Dbl-Word     8 SDPGDA         Address of Snap Data
              00000018       SDPGLN         *-SDPGID Length of SDPL entry
    0018   24 Dbl-Word     8 SDPGNXT (0)    Next Snap Data list entry
    0018   24 Dbl-Word     8 SDPGREST (0)   Start of variable length data.
                                            This area contains as many
                                            multiple copies of the above
                                            fields (SDPGID-SDPGDA) as is
                                            necessary.

SDPL Storage Layout | Top of page

    *** SDPL - SNAP DATA PARAMETER LIST
    *
    *     +---------------------------+---------------------------+
    *   0 |          SDPLID           |          SDPLDA           |
    *     +------+------+-------------+---------------------------+
    *   8 |:LFLG |:LIDLN|  SDPLDALN   |
    *     +------+------+-------------+
    *
    *** SDPL - SNAP DATA PARAMETER LIST

    *** SDPG - SNAP DATA PARAMETER LIST
    *
    *     +-------------------------------------------------------+
    *   0 |                        SDPGID                         |
    *     +------+------+-------------+---------------------------+
    *   8 |:GFLG |:GIDLN|  SDPGDALN   |///////////////////////////|
    *     +------+------+-------------+---------------------------+
    *  10 |                        SDPGDA                         |
    *     +-------------------------------------------------------+
    *
    *** SDPG - SNAP DATA PARAMETER LIST

SDPL Cross Reference | Top of page

    Symbol         Dspl Value
    -------------- ---- -----
    SDPGADL        0008 80
    SDPGADT        0008 40
    SDPGDA         0010
    SDPGDALN       000A
    SDPGFLG        0008
    SDPGID         0000
    SDPGIDLN       0009
    SDPGLN         0010 00000018
    SDPGNXT        0018
    SDPGREST       0018
    SDPLADL        0008 80
    SDPLADT        0008 40
    SDPLDA         0004
    SDPLDALN       000A
    SDPLEOL        000C 0SDPLNXT
    SDPLFLG        0008
    SDPLID         0000
    SDPLIDLN       0009
    SDPLIST        0000
    SDPLLN         000A 0000000C
    SDPLNXT        000C
    SDPLREST       000C

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