|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
GSDBK
Control Block Contents
GSDBK DSECT
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.
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
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 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
*** 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
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
Copyright IBM Corporation, 1990, 2011