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' GSDCFMDG DIAGNOSE CONSOLE
                                        FUNCTION BUFFER
          .1.. ....      GSDCFMCP       X'40' GSDCFMCP BUFFER CONTAINS
                                        #CP COMMAND ETC
          ..1. ....      GSDCFMTR       X'20' GSDCFMTR BUFFER FROM TRACE
                                        CMD OPERAND - GSD2305 IS FOR
                                        INTERFACE TO HCPIOESD
          ...1 ....      GSD2305        X'10' GSD2305 2305 IOR EXTENSION
                                        - FLAGS FOR LOGON AND IPL
          .... 1...      GSDREIPL       X'08' GSDREIPL GSDBK IS FOR
                                        ATTEMPTED RE-IPL COMMAND
          .... .1..      GSDIPLOG       X'04' GSDIPLOG COMMAND WAS
                                        GENERATED BY THE LOGON PROCES
          .... ..1.      GSDLOGIP       X'02' GSDLOGIP FIRST READ INPUT
                                        AFTER IPL
          .... ...1      GSDIRECT       X'01' GSDIRECT Command from User
                                        Directory
0009    9 Bitstring    1 GSDFLAG        GSDBLOK FLAGS
          .1.. ....      GSDCFMDY       X'40' GSDCFMDY DISPLAY COMMAND TO
                                        TERMINAL
          ..1. ....      GSDCFMDZ       X'20' GSDCFMDZ DISPLAY TO
                                        TERMINAL COMPLETE
          ...1 ....      GSDCFMRD       X'10' GSDCFMRD C.F. READ REQUEST
                                        IF RUN OFF
          .... 1...      GSDPWSUP       X'08' GSDPWSUP PASSWORD
                                        SUPPRESSION FOR THIS CMD
          .... .1..      GSDBUFWT       X'04' GSDBUFWT C.F. OUTPUT TO
                                        BUFFER FOR THIS CMD
          .... ..1.      GSDNCPRD       X'02' GSDNCPRD NO CP READ ON LINK
                                        COMMAND VIA DIAG 8
          .... ...1      GSDCFMFO       X'01' GSDCFMFO C.F. Output to
                                        GSDFORID for this command - FOR
                                        PROGRAM FUNCTION KEY SUPPORT
          1... ....      GSDPFIMM       X'80' GSDPFIMM THIS IS A IMMED PF
                                        KEY
          .1.. ....      GSDPFDEL       X'40' GSDPFDEL THIS IS A DELAY PF
                                        KEY
          ..1. ....      GSDPFNOD       X'20' GSDPFNOD THIS IS A NODISP
                                        PF KEY
          ...1 ....      GSDPFSUB       X'10' GSDPFSUB THIS IS A SUBSTITU
                                        PF KEY
          .... 1...      GSDPFTAB       X'08' GSDPFTAB THIS IS A TAB PF
                                        KEY
          .... .1..      GSDPFRTV       X'04' GSDPFRTV THIS IS A RETRIEVE
                                        PF KEY
          .... ..1.      GSDPFCPY       X'02' GSDPFCPY THIS IS A COPY PF
                                        KEY - FOR SPECIAL PRINTER
                                        HANDLING ON 2311..
          1... ....      GSDUSCB        X'80' GSDUSCB TYPE 1 BUFFER READ
                                        (UCSB)
          .1.. ....      GSDFCB         X'40' GSDFCB TYPE 2 BUFFER READ
                                        (FCB)
          ..1. ....      GSDPLB         X'20' GSDPLB TYPE 3 BUFFER READ
                                        (PLB) - FOR VIRTUAL UNIT RECORD
                                        DEVICE SIMULATION
          1... ....      GSDCCWO        X'80' GSDCCWO GSDBLOK CONTAINS
                                        CCWS ONLY
          ..1. ....      GSDCCWRT       X'20' GSDCCWRT CCW WRITE
                                        OPERATION - FOR INPUT DATA
                                        PROCESSING
          .... 1...      GSDPHIDE       X'08' GSDPHIDE PREVENT DISPLAY OF
                                        THIS DATA - FOR LOGON PROCESSING
          .... 1...      GSDINITP       X'08' GSDINITP ISSUE INITIAL
                                        LOGON PROMPTS
          .... .1..      GSDIGNPS       X'04' GSDIGNPS IGNORE PASSWORD
                                        SUPPRESSION
          .... ..1.      GSDINITU       X'02' GSDINITU INITIAL LOGON
                                        UNSUCCESSFUL
          .... ...1      GSDCMDPR       X'01' GSDCMDPR Data came from the
                                        COMMAND line of logo - FOR
                                        INTERFACE TO HCPIOPER
          1... ....      GSDNODSP       X'80' GSDNODSP Don't display
                                        message on terminal
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 Dbl-Word     8 GSDCFMBE       C.F. output buffer address
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 GSDBSCAN SCN PTR
                                        FOR C.F. CMD W/BUFFER
              FOR command, command GSDBK redefinitions
0010   16 Character    8 GSDFORID       User to receive output
0018   24 Address      4 GSDFORBK       The address of the user to
                                        receive output's FORBK control
                                        block. If this field is zero, the
                                        output is to go to that users
                                        console and the GSDFORPI field is
                                        not to be used as a path ID.
001C   28 Signed       2 GSDFORPI       *ASYNCMD path ID to use for
                                        output
001E   30 Signed       2 GSDFORIM       Count of IUCV msgs that were
                                        failed to be delivered over a
                                        *ASYNCMD path
0020   32 Character   16 GSDFORTK       User token associated with output
0030   48 Character    1 GSDFORDA (0)   Start of variable-length data
          ..1. ....      GSDFORSC       GSDFORDA-GSDDATA GSDFORSC Scan
                                        offset
          00000011       GSDDATA1       GSDDATA+1
0010   16 Character  120 GSDQYMSG
          00000011       GSDQYSIZ       (*-GSDBK+7)/8 GSDBK FOR 120 CHAR
                                        TEXT FIELD
              Error message GSDBK queueing redefinitions
0004    4 Bitstring    1 GSDEMF         Error message type
          1... ....      GSDEMFFE       X'80' GSDEMFFE DATATYPE=FULLEMSG
          .1.. ....      GSDEMFE        X'40' GSDEMFE 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' GSDRINIT 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
              Logon GSDBK redefinitions
0004    4 Signed       2 GSDLGN         Length of Logon command and
                                        userid
0006    6 Signed       2 *              Reserved

 

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 |                       GSDCFMBE                        |
*     +---------------------------+---------------------------+
*  18 |         GSDCFMBL          |
*     +---------------------------+
*
*** Overlay for GSDDATA in GSDBK
          
*** Overlay for GSDDATA in GSDBK
*
*     +-------------------------------------------------------+
*  10 |                       GSDFORID                        |
*     +---------------------------+-------------+-------------+
*  18 |         GSDFORBK          |  GSDFORPI   |  GSDFORIM   |
*     +---------------------------+-------------+-------------+
*  20 |                       GSDFORTK                        |
*     |                                                       |
*     +-------------------------------------------------------+
*
*** Overlay for GSDDATA in GSDBK
          
*** Overlay for GSDDATA in GSDBK
*
*     +-------------------------------------------------------+
*  10 |                                                       |
*     =                       GSDQYMSG                        =
*     |                                                       |
*     +-------------------------------------------------------+
*  88
*
*** 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
          
*** Overlay for GSDCPEX in GSDBK
*
*                                 +-------------+-------------+
*   0 ...                       4 |   GSDLGN    |/////////////|
*                                 +-------------+-------------+
*   8
*
*** Overlay for GSDCPEX in GSDBK

 

GSDBK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
GSDBDATA       001C
GSDBSCAN       001C 0C
GSDBUFWT       0009 04
GSDCCWO        0009 80
GSDCCWRT       0009 20
GSDCFMBE       0010
GSDCFMBL       0018
GSDCFMCP       0008 40
GSDCFMDG       0008 80
GSDCFMDY       0009 40
GSDCFMDZ       0009 20
GSDCFMFO       0009 01
GSDCFMRD       0009 10
GSDCFMTR       0008 20
GSDCMDPR       0009 01
GSDCPEX        0004
GSDDATA        0010
GSDDATA1       0030 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
GSDFORBK       0018
GSDFORDA       0030
GSDFORID       0010
GSDFORIM       001E
GSDFORPI       001C
GSDFORSC       0030 20
GSDFORTK       0020
GSDFRESZ       000A
GSDFSMFL       000D
GSDHLEN        000E 00000010
GSDHSIZE       000E 00000002
GSDIGNPS       0009 04
GSDINITP       0009 08
GSDINITU       0009 02
GSDIPLOG       0008 04
GSDIRECT       0008 01
GSDLGN         0004
GSDLGSIZ       000E 00000012
GSDLOGIP       0008 02
GSDMSACT       0005
GSDNCPRD       0009 02
GSDNEXT        0000
GSDNODSP       0009 80
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 00000011
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 V5R4.0. Last updated on 18 Feb 2010 at 03:44:59 EDT.
Copyright IBM Corporation, 1990, 2009