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 GSDCFMBA       C.F. OUTPUT BUFFER ADDRESS
0014   20 Signed       4 GSDCFMBL       C.F. OUTPUT BUFFER LENGTH
0018   24 Character    1 GSDBDATA (0)   START OF VARIABLE LENGTH DATA
                                        W/BUFFER
          .... 1...      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 Bitstring    1 *              Reserved
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          |         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|//////|  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       0018
GSDBSCAN       0018 08
GSDBUFWT       0009 04
GSDCCWO        0009 80
GSDCCWRT       0009 20
GSDCFMAD       0009 80
GSDCFMBA       0010
GSDCFMBL       0014
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       0018 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
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 V4R2.0. Last updated on 17 Oct 2001 at 15:23:11 EDT.
Copyright IBM Corporation, 1990, 2001