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

#### GSDBK

Prolog

Control Block Contents
GSDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### GSDBK Prolog

     NAME       : HCPGSDBK
     DESCRIPTION: GENERAL SYSTEM DATA BLOCK
     DSECT      : GSDBK
     FUNCTION   : THE GSDBK CONTAINS DATA TO BE PROCESSED BY CP,
                  OR TO BE PASSED TO A VIRTUAL MACHINE.
     LOCATED BY : GSDNEXT CHAINED
                  BSCRPTR FIELD OF HCPBSCBK
                  VDSGSDVC FIELD OF HCPVDSBK (WORK)
                  VDSGSDW FIELD OF HCPVDSBK (HCPVSP WORK)
                  VDSGSDI FIELD OF HCPVDSBK (INPUT)
                  VDSGSDO FIELD OF HCPVDSBK (OUTPUT)
                  VDSGSDT FIELD OF HCPVDSBK (TAG)
     CREATED BY : HCPCFM, HCPDAE, HCPDAS, HCPGRF, HCPGSV,
                  HCPHVC, HCPREC, HCPRSE, HCPRSP, HCPVCN,
                  HCPVSP, HCPVUR, HCPISU, HCPIOP, HCPITM,
                  HCPWRM, HCPERM, HCPCFS, HCPCQA, HCPCQE,
                  HCPCQO, HCPCQT, HCPCQU, HCPCQW, HCPCRC,
                  HCPCSO, HCPCST, HCPPWD, HCPSFR, HCPSFV,
                  HCPTRA, HCPTRI, HCPVEX, HCPXCC, HCPRFC
                  HCPWAC, HCPZNL
     DELETED BY : HCPCFM, HCPDAE, HCPDAS, HCPGIN, HCPGRF,
                  HCPREC, HCPRSE, HCPRSP, HCPVCN, HCPVSP,
                  HCPVUR, HCPIOP, HCPERM, HCPCFS, HCPCQA,
                  HCPCQD, HCPCQE, HCPCQO, HCPCQT, HCPCQW,
                  HCPCRC, HCPCSO, HCPCST, HCPDTD, HCPPWD,
                  HCPSFR, HCPSFV, HCPTRA, HCPTRI, HCPUSO,
                  HCPVEX, HCPXCC, HCPZPR
     NOTES      : Fields used by the Cross System Extensions are defined in
                  the HCPGSXBK which overlays GSDDATA.

#### GSDBK Control Block Content

#### GSDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      GSDBK          GENERAL SYSTEM DATA BLOCK
    0000    0 Signed       4 GSDNEXT        POINTER TO NEXT GSDBLOK
    0004    4 Signed       4 GSDCPEX        POINTER TO CPEXBLOK - FOR
                                            INTERFACE TO HCPCFMRD
    0008    8 Signed       2 GSDTYFL (0)    GSDTYPE AND GSDFLAG PARAMETERS
    0008    8 Bitstring    1 GSDTYPE        GSDBLOK TYPE - FOR INTERFACE TO
                                            HCPCFMRD
              1... ....      GSDCFMDG       X'80' DIAGNOSE CONSOLE FUNCTION
                                            BUFFER
              .1.. ....      GSDCFMCP       X'40' BUFFER CONTAINS #CP COMMAND
                                            ETC
              ..1. ....      GSDCFMTR       X'20' BUFFER FROM TRACE CMD
                                            OPERAND - GSD2305 IS FOR
                                            INTERFACE TO HCPIOESD
              ...1 ....      GSD2305        X'10' 2305 IOR EXTENSION - FLAGS
                                            FOR LOGON AND IPL
              .... 1...      GSDREIPL       X'08' GSDBK IS FOR ATTEMPTED
                                            RE-IPL COMMAND
              .... .1..      GSDIPLOG       X'04' COMMAND WAS GENERATED BY
                                            THE LOGON PROCESSOR
              .... ..1.      GSDLOGIP       X'02' FIRST READ INPUT AFTER IPL
    0009    9 Bitstring    1 GSDFLAG        GSDBLOK FLAGS
              1... ....      GSDCFMAD       X'80' COMMAND TRANSFERRED FROM
                                            ADJUNCT
              .1.. ....      GSDCFMDY       X'40' DISPLAY COMMAND TO TERMINAL
              ..1. ....      GSDCFMDZ       X'20' DISPLAY TO TERMINAL
                                            COMPLETE
              ...1 ....      GSDCFMRD       X'10' C.F. READ REQUEST IF RUN
                                            OFF
              .... 1...      GSDPWSUP       X'08' PASSWORD SUPPRESSION FOR
                                            THIS CMD
              .... .1..      GSDBUFWT       X'04' C.F. OUTPUT TO BUFFER FOR
                                            THIS CMD
              .... ..1.      GSDNCPRD       X'02' NO CP READ ON LINK COMMAND
                                            VIA DIAG 8 - FOR PROGRAM FUNCTION
                                            KEY SUPPORT
              1... ....      GSDPFIMM       X'80' THIS IS A IMMED PF KEY
              .1.. ....      GSDPFDEL       X'40' THIS IS A DELAY PF KEY
              ..1. ....      GSDPFNOD       X'20' THIS IS A NODISP PF KEY
              ...1 ....      GSDPFSUB       X'10' THIS IS A SUBSTITU PF KEY
              .... 1...      GSDPFTAB       X'08' THIS IS A TAB PF KEY
              .... .1..      GSDPFRTV       X'04' THIS IS A RETRIEVE PF KEY
              .... ..1.      GSDPFCPY       X'02' THIS IS A COPY PF KEY - FOR
                                            SPECIAL PRINTER HANDLING ON
                                            2311..
              1... ....      GSDUSCB        X'80' TYPE 1 BUFFER READ (UCSB)
              .1.. ....      GSDFCB         X'40' TYPE 2 BUFFER READ (FCB)
              ..1. ....      GSDPLB         X'20' TYPE 3 BUFFER READ (PLB) -
                                            FOR VIRTUAL UNIT RECORD DEVICE
                                            SIMULATION
              1... ....      GSDCCWO        X'80' GSDBLOK CONTAINS CCWS ONLY
              ..1. ....      GSDCCWRT       X'20' CCW WRITE OPERATION - FOR
                                            INPUT DATA PROCESSING
              .... 1...      GSDPHIDE       X'08' PREVENT DISPLAY OF THIS
                                            DATA - FOR LOGON PROCESSING
              .... 1...      GSDINITP       X'08' ISSUE INITIAL LOGON PROMPTS
              .... .1..      GSDIGNPS       X'04' IGNORE PASSWORD SUPPRESSION
              .... ..1.      GSDINITU       X'02' INITIAL LOGON UNSUCCESSFUL
              .... ...1      GSDCMDPR       X'01' Data came from the COMMAND
                                            line of logo
    000A   10 Signed       2 GSDFRESZ       GSDBLOK BLOCK SIZE IN DOUBLE
                                            WORDS
    000C   12 Signed       2 GSDSCAN        BYTE DISP OF NEXT FIELD IN
                                            GSDDATA
    000E   14 Signed       2 GSDDCNT        LENGTH OF GSDDATA IN BYTES
              00000010       GSDHLEN        *-GSDBK GSDBK SIZE IN BYTES
              00000002       GSDHSIZE       (*-GSDBK+7)/8 GSDBK SIZE IN
                                            DOUBLE-WORDS
              00000012       GSDLGSIZ       GSDHSIZE+16 LARGE GSDBK FOR 2305
                                            USE
    0010   16 Character    1 GSDDATA (0)    START OF VARIABLE LENGTH DATA
    000C   12 Signed       2 GSDRTVI        Size & direction of retrieve
                                            request Valid only if GSDPFRTV is
                                            on
    000C   12 Bitstring    1 GSDQCNFL       PARAMETER FLAGS FOR HCPQCN
    000D   13 Bitstring    1 GSDFSMFL       FULL SCREEN PARMS FOR HCPQCN
    0010   16 Signed       4 *              Reserved for IBM
    0014   20 Signed       4 GSDCFMBA       C.F. output buffer address - 390
    0018   24 Signed       4 GSDCFMBL       C.F. OUTPUT BUFFER LENGTH
    001C   28 Character    1 GSDBDATA (0)   START OF VARIABLE LENGTH DATA
                                            W/BUFFER
              .... 11..      GSDBSCAN       GSDBDATA-GSDDATA SCN PTR FOR C.F.
                                            CMD W/BUFFER
              00000011       GSDDATA1       GSDDATA+1
    0010   16 Character   80 GSDQYMSG
              0000000C       GSDQYSIZ       (*-GSDBK+7)/8 GSDBK FOR 80 CHAR
                                            TEXT FIELD
         Error message GSDBK queueing redefinitions
    0004    4 Bitstring    1 GSDEMF         Error message type
              1... ....      GSDEMFFE       X'80' DATATYPE=FULLEMSG
              .1.. ....      GSDEMFE        X'40' DATATYPE=EMSG
    0005    5 Character    1 GSDMSACT       Message action character
    0006    6 Signed       2 GSDEMSGN       Error message return code
         RECORDING SYSTEM SERVICE RE-DEFINITIONS
    0004    4 Signed       2 GSDUSCNT       SYSTEM RECORD USE COUNT
    0009    9 Bitstring    1 GSDRID         SYSTEM RECORD ID
         GSDRID DEFINITIONS
              .... ...1      GSDRACNT       X'01' ACCOUNTING RECORD
              .... ..1.      GSDRIOER       X'02' EREP (LOGREC) RECORD
              .... ..11      GSDRSYMP       X'03' SYMPTOM RECORD
              .... .1..      GSDRCNFG       X'04' CONFIGURATION RECORD
              1111 1111      GSDRTAB        X'FF' RECORDING TABLE
    000C   12 Bitstring    1 GSDRFLAG       RECORDING SYSTEM SERVICE FLAGS
              1... ....      GSDRINIT       X'80' RECORDING TABLE UPDATE
                                            COMPLETED FOR THIS ENTRY
    000D   13 Bitstring    1 GSDRVERS       Version number for RSSBK overlays
         GSDRVERS Definitions
              .... ...1      GSDRCURV       X'01' Current RSSBK version
                                            number
    0010   16 Signed       4 GSDRMSGN       Message number in RSSBK
    0014   20 Signed       4 *              reserved
              00000018       GSDRHLEN       *-GSDBK GSDBK header for RSSBK
                                            overlay
              00000003       GSDRHSIZ       (*-GSDBK+7)/8 Doubleword header
                                            size for RSSBK overlay
    0018   24 Character    1 GSDRDATA (0)   Start of variable length system
                                            record data
    0010   16 Signed       4 GSDDVLA (20)
              00000060       GSDDVEND       *
              0000000C       GSDDVSIZ       (*-GSDBK+7)/8 GSDBK for Device
                                            List Anchors

#### GSDBK Storage Layout

    *** GSDBK - GENERAL SYSTEM DATA BLOCK
    *
    *     +---------------------------+---------------------------+
    *   0 |         GSDNEXT           |         GSDCPEX           |
    *     +------+------+-------------+-------------+-------------+
    *   8 |:TYPE |:FLAG |  GSDFRESZ   |  GSDSCAN    |  GSDDCNT    |
    *     +------+------+-------------+-------------+-------------+
    *
    *** GSDBK - GENERAL SYSTEM DATA BLOCK

    *** Overlay for GSDSCAN in GSDBK
    *
    *                                 +-------------+
    *   8 ...                       C |  GSDRTVI    | E
    *                                 +-------------+
    *
    *** Overlay for GSDSCAN in GSDBK

    *** Overlay for GSDSCAN in GSDBK
    *
    *                                 +------+------+
    *   8 ...                       C |:QCNFL|:FSMFL| E
    *                                 +------+------+
    *
    *** Overlay for GSDSCAN in GSDBK

    *** Overlay for GSDDATA in GSDBK
    *
    *     +---------------------------+---------------------------+
    *  10 |///////////////////////////|         GSDCFMBA          |
    *     +---------------------------+---------------------------+
    *  18 |         GSDCFMBL          |
    *     +---------------------------+
    *
    *** Overlay for GSDDATA in GSDBK

    *** Overlay for GSDDATA in GSDBK
    *
    *     +-------------------------------------------------------+
    *  10 |                                                       |
    *     =                       GSDQYMSG                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  60
    *
    *** Overlay for GSDDATA in GSDBK

    *** Overlay for GSDCPEX in GSDBK
    *
    *                                 +------+------+-------------+
    *   0 ...                       4 |GSDEMF|:MSACT|  GSDEMSGN   |
    *                                 +------+------+-------------+
    *   8
    *
    *** Overlay for GSDCPEX in GSDBK

    *** Overlay for GSDCPEX in GSDBK
    *
    *                                 +-------------+
    *   0 ...                       4 |  GSDUSCNT   | 6
    *                                 +-------------+
    *
    *** Overlay for GSDCPEX in GSDBK

    *** Overlay for GSDFLAG in GSDBK
    *
    *            +------+
    *   8 ..   9 |GSDRID| A
    *            +------+
    *
    *** Overlay for GSDFLAG in GSDBK

    *** Overlay for GSDSCAN in GSDBK
    *
    *                                 +------+------+
    *   8 ...                       C |:RFLAG|:RVERS| E
    *                                 +------+------+
    *
    *** Overlay for GSDSCAN in GSDBK

    *** Overlay for GSDDATA in GSDBK
    *
    *     +---------------------------+---------------------------+
    *  10 |         GSDRMSGN          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *
    *** Overlay for GSDDATA in GSDBK

    *** Overlay for GSDDATA in GSDBK
    *
    *     +-------------------------------------------------------+
    *  10 |                                                       |
    *     =                       GSDDVLA                         =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  60
    *
    *** Overlay for GSDDATA in GSDBK

#### GSDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    GSDBDATA       001C
    GSDBSCAN       001C 0C
    GSDBUFWT       0009 04
    GSDCCWO        0009 80
    GSDCCWRT       0009 20
    GSDCFMAD       0009 80
    GSDCFMBA       0014
    GSDCFMBL       0018
    GSDCFMCP       0008 40
    GSDCFMDG       0008 80
    GSDCFMDY       0009 40
    GSDCFMDZ       0009 20
    GSDCFMRD       0009 10
    GSDCFMTR       0008 20
    GSDCMDPR       0009 01
    GSDCPEX        0004
    GSDDATA        0010
    GSDDATA1       001C 00000011
    GSDDCNT        000E
    GSDDVEND       0010 00000060
    GSDDVLA        0010
    GSDDVSIZ       0010 0000000C
    GSDEMF         0004
    GSDEMFE        0004 40
    GSDEMFFE       0004 80
    GSDEMSGN       0006
    GSDFCB         0009 40
    GSDFLAG        0009
    GSDFRESZ       000A
    GSDFSMFL       000D
    GSDHLEN        000E 00000010
    GSDHSIZE       000E 00000002
    GSDIGNPS       0009 04
    GSDINITP       0009 08
    GSDINITU       0009 02
    GSDIPLOG       0008 04
    GSDLGSIZ       000E 00000012
    GSDLOGIP       0008 02
    GSDMSACT       0005
    GSDNCPRD       0009 02
    GSDNEXT        0000
    GSDPFCPY       0009 02
    GSDPFDEL       0009 40
    GSDPFIMM       0009 80
    GSDPFNOD       0009 20
    GSDPFRTV       0009 04
    GSDPFSUB       0009 10
    GSDPFTAB       0009 08
    GSDPHIDE       0009 08
    GSDPLB         0009 20
    GSDPWSUP       0009 08
    GSDQCNFL       000C
    GSDQYMSG       0010
    GSDQYSIZ       0010 0000000C
    GSDRACNT       0009 01
    GSDRCNFG       0009 04
    GSDRCURV       000D 01
    GSDRDATA       0018
    GSDREIPL       0008 08
    GSDRFLAG       000C
    GSDRHLEN       0014 00000018
    GSDRHSIZ       0014 00000003
    GSDRID         0009
    GSDRINIT       000C 80
    GSDRIOER       0009 02
    GSDRMSGN       0010
    GSDRSYMP       0009 03
    GSDRTAB        0009 FF
    GSDRTVI        000C
    GSDRVERS       000D
    GSDSCAN        000C
    GSDTYFL        0008
    GSDTYPE        0008
    GSDUSCB        0009 80
    GSDUSCNT       0004
    GSD2305        0008 10

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 16:34:33 EDT.
Copyright IBM Corporation, 1990, 2002