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

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

          
*** 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 V5R3.0. Last updated on 25 Jun 2007 at 17:24:55 EDT.
Copyright IBM Corporation, 1990, 2007