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.2.0 Last updated on 24 Jun 2020 at 09:30:23 EDT.
Copyright IBM Corporation, 1990, 2020