SDSBK Back to Index page
 
Prolog 
Control Block Contents 
   SDSBK DSECT
   SDSLINE 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.


  SDSBK Prolog Top of page
  
 NAME       : HCPSDSBK
 DESCRIPTION: Stand-alone dump status record
 DSECT      : SDSBK
 FUNCTION   : The SDSBK describes the contents of the stand-alone dump
              status record which is an optional header record in a dump.
              It is created at stand-alone dump installation time and
              tracks the status of each DASD during install and dump.
 LOCATED BY : SDX_Stat_Rec field in SDXBK
 CREATED BY : Stand-alone dump installer.
 DELETED BY : Not applicable
 REFERENCES : HCPDLJ - part of DUMPLD2
 SERIALIZED : Single-threaded nature of stand-alone dump process
 RELOCATION CONSIDERATIONS : None
 COMPATIBILITY AND MIGRATION CONCERNS : None
 NOTES      : - Currently the SDSBK is a 4K structure.  It may grow
              to multiple 4K structures in the future.
 
 
  SDSBK Control Block Content Top of page
  




 SDSBK DSECT
Top of page


Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SDSBK          Stand-alone dump status record
       The following is header information for the table
0000    0 Character   16 SDS_ID         "HCPSDSBK V1.0"
0010   16 Character    8 SDS_EYE1       "STARTED "
0018   24 Dbl-Word     8 SDS_TODST      TOD when Dumper started
0020   32 Character    8 SDS_EYE2       "ENDED "
0028   40 Dbl-Word     8 SDS_TODEND     TOD when Dumper ended
0030   48 Character    8 SDS_EYE3       "DUMP_RC "
0038   56 Signed       4 SDS_RC         Overall RC from Dumper Possible
                                        Return Codes
          00000000       SDS_GOODCP     0
          00000001       SDS_BAD_VMCOREINFO
                                        1
          00000002       SDS_NO_PFXPG   2
          00000003       SDS_BAD_PFXPG  3
          00000004       SDS_BAD_FT     4
          00000005       SDS_WRITE_FAILED
                                        5
          00000006       SDS_SDW_FAILED 6
          00000007       SDS_HEADER_FAILED
                                        7
          00000008       SDS_NO_SPACE   8
003C   60 Signed       4 SDSBKREC       Record Number of SDSBK in Dump
0040   64 Dbl-Word     8 SDS_DMPSZ      Total Num of Recs. Filled in
                                        during dump load processing.
0048   72 Character  168 *              Reserved for IBM use. Currently
                                        blanks.
      Equates for the SDSBK header
          000000F0       SDSHDSIZ       *-SDSBK Size of header in bytes
         Currently, every place expects header to be 240.
      Dump Device Information
00F0  240 Character 3856 SDSDATA        Device information
          0000001E       SDSLIMIT       30 Max number of dump devices
          00000200       SDSBKDW        (*-SDSBK+7)/8 Size in double
                                        words
          00001000       SDSBSIZE       SDSBKDW*8 Size in bytes
       Format of each line of dump device information




 SDSLINE DSECT
Top of page


Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SDSLINE        Stand-alone dump status record
0000    0 Character    4 SDSTYPE        Device type - '3390' or 'SCSI'
0004    4 Character    1 *              blank
0005    5 Character    4 SDSVDEV        Virtual device number
0009    9 Character    1 *              blank
000A   10 Character    4 SDSRDEV        Real device number
000E   14 Character    1 *              blank
000F   15 Character   16 SDSWWPN        WWPN if SCSI. Else all hypens
001F   31 Character    1 *              blank
0020   32 Character   16 SDSLUN         LUN if SCSI. Else all hypens
0030   48 Character    1 *              blank
0031   49 Character    6 SDSLABEL       Volume label if 3390. Else hypens
0037   55 Character    1 *              blank
          00000038       SDSreadSZ      *-SDSLINE Size of readable
                                        section of SDSLINE
0038   56 Dbl-Word     8 SDSDumpPages   Number of pages dumped to this
                                        device
0040   64 Dbl-Word     8 SDSLoadPages   Number of pages loaded from this
                                        device
0048   72 Signed       4 SDSDUMP        Dumper status code of this device
                                        Defined Codes
          00000001       SDSLINE_BAD_LABEL
                                        1 Unexpected label at dump time
          00000002       SDSLINE_NOT_ACC
                                        2 Disk wasn't there.
          00000003       SDSLINE_NOT_RW 3 Couldn't mount disk R/W
          00000004       SDSLINE_OPEN_FAILED
                                        4 Couldn't open the partition for
                                        writing
          00000005       SDSLINE_SDW_FAILED
                                        5 Couldn't write the final SDWBK
004C   76 Signed       4 SDSLOAD        Dump load status code of this
                                        device
0050   80 Signed       4 SDSdumpStart   Dump starting CCHH if 3390. Dump
                                        starting block number if SCSI.
0054   84 Signed       4 SDSdumpEnd     Dump ending CCHH if 3390. Dump
                                        ending block number if SCSI.
0058   88 Character    4 *              Reserved for IBM use
005C   92 Character    4 SDSVdevFBA     Vdev of attached Edev if SCSI
0060   96 Character   32 *              Reserved for IBM use
          00000080       SDSLSIZE       *-SDSLINE Size of each line in
                                        bytes
         Currently, every place expects each line to 128.
         Current limit is 1 page
 
 
  SDSBK Storage Layout Top of page
  
          
*** SDSBK - Stand-alone dump status record
*
*     +-------------------------------------------------------+
*   0 |                        SDS_ID                         |
*     |                                                       |
*     +-------------------------------------------------------+
*  10 |                       SDS_EYE1                        |
*     +-------------------------------------------------------+
*  18 |                      SDS_TODST                        |
*     +-------------------------------------------------------+
*  20 |                       SDS_EYE2                        |
*     +-------------------------------------------------------+
*  28 |                      SDS_TODEND                       |
*     +-------------------------------------------------------+
*  30 |                       SDS_EYE3                        |
*     +---------------------------+---------------------------+
*  38 |          SDS_RC           |         SDSBKREC          |
*     +---------------------------+---------------------------+
*  40 |                      SDS_DMPSZ                        |
*     +-------------------------------------------------------+
*  48 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  F0 |                                                       |
*     =                       SDSDATA                         =
*     |                                                       |
*     +-------------------------------------------------------+
*1000
*
*** SDSBK - Stand-alone dump status record
          
*** SDSLINE - Stand-alone dump status record
*
*     +---------------------------+------+--------------------+
*   0 |         SDSTYPE           |//////|     SDSVDEV-       |
*     +------+------+-------------+------+------+------+------+
*   8 |-(005)|//////|         SDSRDEV           |//////|      |
*     +------+------+---------------------------+------+      |
*     |                       SDSWWPN                         |
*     |                                                +------+
*  18 |                                                |//////|
*     +------------------------------------------------+------+
*  20 |                        SDSLUN                         |
*     |                                                       |
*     +------+-----------------------------------------+------+
*  30 |//////|                SDSLABEL                 |//////|
*     +------+-----------------------------------------+------+
*  38 |                     SDSDUMPPAGES                      |
*     +-------------------------------------------------------+
*  40 |                     SDSLOADPAGES                      |
*     +---------------------------+---------------------------+
*  48 |         SDSDUMP           |         SDSLOAD           |
*     +---------------------------+---------------------------+
*  50 |       SDSDUMPSTART        |        SDSDUMPEND         |
*     +---------------------------+---------------------------+
*  58 |///////////////////////////|        SDSVDEVFBA         |
*     +---------------------------+---------------------------+
*  60 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*  80
*
*** SDSLINE - Stand-alone dump status record
 
 
  SDSBK Cross Reference Top of page
  
 
Symbol         Dspl Value
-------------- ---- -----
SDS_BAD_FT     0038 00000004
SDS_BAD_PFXPG  0038 00000003
SDS_BAD_VMCOREINFO
               0038 00000001
SDS_DMPSZ      0040
SDS_EYE1       0010
SDS_EYE2       0020
SDS_EYE3       0030
SDS_GOODCP     0038 00000000
SDS_HEADER_FAILED
               0038 00000007
SDS_ID         0000
SDS_NO_PFXPG   0038 00000002
SDS_NO_SPACE   0038 00000008
SDS_RC         0038
SDS_SDW_FAILED
               0038 00000006
SDS_TODEND     0028
SDS_TODST      0018
SDS_WRITE_FAILED
               0038 00000005
SDSdumpEnd     0054
SDSdumpStart   0050
SDSreadSZ      0037 00000038
SDSBKDW        00F0 00000200
SDSBKREC       003C
SDSBSIZE       00F0 00001000
SDSDumpPages   0038
SDSDATA        00F0
SDSDUMP        0048
SDSHDSIZ       0048 000000F0
SDSLoadPages   0040
SDSLABEL       0031
SDSLIMIT       00F0 0000001E
SDSLINE_BAD_LABEL
               0048 00000001
SDSLINE_NOT_ACC
               0048 00000002
SDSLINE_NOT_RW
               0048 00000003
SDSLINE_OPEN_FAILED
               0048 00000004
SDSLINE_SDW_FAILED
               0048 00000005
SDSLOAD        004C
SDSLSIZE       0060 00000080
SDSLUN         0020
SDSRDEV        000A
SDSTYPE        0000
SDSVdevFBA     005C
SDSVDEV        0005
SDSWWPN        000F
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:55:00 EDT.
Copyright IBM Corporation, 1990, 2022