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


  GSDBK Prolog Top of page
 
 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.
 RELOCATION CONSIDERATIONS : This control block is relocated as part of a live
              guest relocation (LGR).  The bits and fields that
              need to be relocated are defined in the
              corresponding LGRGSDBK COPY file.  Whenever changes
              are made to this control block, consideration must
              be given to any effects these changes will have on
              a relocation.  If any new fields or bits are
              defined, they may need to be relocated.  If
              existing bits or fields are changed, corresponding
              modifications may be required in the LGR version of
              this control block.  Consider also the effects of
              these changes on a relocation involving a back-level
              release of CP.
  UEST RELOCATION and GSDFLAG
              The code which relocates GSDBKs during guest state
              relocation (HCPRLGGF/HCPRLGGU) does NOT treat GSDFLAG as
              individual bits - it relocates them unchanged.
              This is different from the way any other flag fields are
              treated during relocation, and is necessary because the
              bits in GSDFLAG are multiply-defined, and there is no way
              for the relocation code to know which set of definitions
              pertains to a given GSDBK.
              It is essential, therefore, that the current definitions
              for GSDFLAG never be changed. Definitions may be added or
              deleted, but the existing definitions must not be changed.
 
 
  GSDBK Control Block Content Top of page
 

 GSDBK DSECT Top of page
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 Virtual networking re-definitions 0010 16 Signed 4 GSDRMSGN Message number 0014 20 Signed 4 * reserved 0018 24 Character 1 GSDRDATA (0) Start of variable length 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 Top of page
 
          
*** 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 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 Top of page
 
 
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
GSDRDATA       0018
GSDREIPL       0008 08
GSDRMSGN       0010
GSDRTVI        000C
GSDSCAN        000C
GSDTYFL        0008
GSDTYPE        0008
GSDUSCB        0009 80
GSD2305        0008 10
 
This information is based on z/VM 7.3.0 Last updated on 22 Jun 2022 at 15:50:57 EDT.
Copyright IBM Corporation, 1990, 2022