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