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

#### SDPL

Prolog

Control Block Contents
SDPL DSECT
SDPG DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### SDPL Prolog

     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

#### SDPL Control Block Content

#### SDPL DSECT

####

####

####

    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' Snap ID and Data address
                                            length On = 64-bit, Off = 31-bit
              .1.. ....      SDPLADT        X'40' 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' SNAP DATA PARAMTER
                                            END OF LIST INDICATOR
    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

    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' Snap ID and Data address
                                            length On = 64-bit, Off = 31-bit
              .1.. ....      SDPGADT        X'40' 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

    *** 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

    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 V5R2.0.
    Last updated on 12 Apr 2006 at 17:22:57 EDT.

    Copyright IBM Corporation, 1990, 2005