|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
COMBK
Control Block Contents
COMBK DSECT
Cross Reference (Contains links to field and bit definitions)
COMBK Prolog
NAME : HCPCOMBK
DESCRIPTION: Console Communications Control Block
DSECT : COMBK
FUNCTION : Contains data and control information pertinent to the
control and communication between virtual and real
terminal console tasks and command streams.
LOCATED BY : COMPNT - chained
RDEVCON - field in HCPRDEV
CREATED BY : HCPQCN - whenever a read or write is to be done.
HCPGFS - to clear the screen when switching from
full-screen mode to CP mode.
HCPGRF - for APL/TEXT translations, and
to clear the screen when switching from
full-screen mode to CP mode.
HCPGIN - for uppercase translation.
HCPTTY - to update the status area to indicate
***MORE***.
HCPVCYSM - for VM/VTAM terminal processing.
DELETED BY : HCPQCOET - general system routine to return COMBKs
to free storage.
HCPQCN - when a message won't be displayed on the
terminal screen or when a COMBK is split
into two or more COMBKS.
HCPGIN - when uppercase translation is completed.
HCPGRF - when APL/TEXT translation is completed.
RELOCATION CONSIDERATIONS : None
REFERENCES : HCPEQUAT - equate symbols
HCPHCCW - host channel control word
COMBK Control Block Content
COMBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure COMBK Console Communications Control Block 0000 0 Signed 4 COMPNT POINTER TO NEXT COMBK 0004 4 Signed 2 COMHPARM (0) CALLING PARMS (SEE EQUATES COPY) 0004 4 Bitstring 1 COMBPARM BYTE 1 OF CALLING PARMS ..1. .... COMALTVM X'20' COMALTVM data to be sent to an alternate user ...1 .... COMREDSP X'10' COMREDSP this is input redisplay data .... 1... COMIOCOM X'08' COMIOCOM return when I/O is completed .... .1.. COMSCRFL X'04' COMSCRFL return if data can fit on current scrn .... ..1. COMDIAG X'02' COMDIAG this is a diagnose request 0005 5 Bitstring 1 COMPARM CALLING PARMS (SEE EQUATES COPY) 1... .... COMDROP X'80' COMDROP LOGOFF & DROP line after message ..1. .... COMHIPRI X'20' COMHIPRI hipriority message ...1 .... COMVMIO X'10' COMVMIO virtual machine I/O .... 1... COMHIDE X'08' COMHIDE do not display the data .... .1.. COMNOCR X'04' COMNOCR suppress automatic carriage return .... ..1. COMALRM X'02' COMALRM sound the audible alarm .... ...1 COMCRDR X'01' COMCRDR data is expected from a cardreader .... .1.. COMEDIT X'04' COMEDIT the input line will be edited for logical line end, line delete, charactr delete, and escape characters according to the user's logical line editing character setting. .... ..1. COMUPPR X'02' COMUPPR translate all characters on the input line to upper case 0006 6 Signed 2 COMTSKSZ COMBK SIZE IN DOUBLE WORDS 0008 8 Signed 4 COMRETN POINTER TO SAVEAREA FOR RETURN 000C 12 Signed 4 COMUSER ADDRESS OF VMDBK FOR DESTINATION USER 0010 16 Bitstring 1 COMSTAT COMBK STATUS CONTROL FLAGS 1... .... COMOUTPT X'80' COMOUTPT OUTPUT COMBK .1.. .... COMRESP X'40' COMRESP RESPONSE EXPECTED FROM THIS COMBK ..1. .... COMACTV X'20' COMACTV COMBK IS ACTIVE ON REAL DEVICE ...1 .... COMCNTL X'10' COMCNTL THIS IS A CONTROL COMBK ONLY .... 1... COMESCP X'08' COMESCP COMBK CONTAINS DEVICE DEPENDENT DATA .... .1.. COMLOALM X'04' COMLOALM THIS COMBK HAS BEEN INHIBITED FROM BREAKING INTO FULL SCREEN MODE AND THE ALARM HAS ALREADY BEEN RUNG TO NOTIFY THE USER .... ..1. COMSPLT X'02' COMSPLT OUTPUT DATA BEING SPLIT .... ...1 COMSYNC X'01' COMSYNC COMBK FOR SYNCHRONIZATION ONLY 0011 17 Bitstring 1 COMDFLAG DIAGNOSE DISPLAY FLAG 000000FF COMCNCL 255 COMCNCL DISPLAY - CANCEL FUNCTION REQUESTED 000000FE COMCLEAR 254 COMCLEAR DISPLAY - CLEAR FUNCTION REQUESTED ERASE THE ENTIRE SCREEN, REWRITE THE ATTRIBUTE BYTES FOR CP SCREEN FORMAT, AND RESET THE CURSOR TO THE BEGINNING OF THE INPUT AREA 1... .... COMCLRS X'80' COMCLRS DISPLAY - CLEAR SCREEN BEFORE OUTPUT .1.. .... COMFSRQ X'40' COMFSRQ DISPLAY - FULL-SCREEN CONTROL REQUEST ..11 1111 COMLMSK X'3F' COMLMSK DISPLAY - MASK FOR BITS IN LINE NUM 0012 18 Bitstring 1 COMCNTRL CONTROL FLOW FLAGS 1... .... COMHOLD X'80' COMHOLD DISPLAY - SCREEN STATUS HOLDING .1.. .... COMWRTRD X'40' COMWRTRD TERM - COMBK CONTAINS WRITE/READ ..1. .... COMMORE X'20' COMMORE TERM - 'MORE' COMBK ...1 .... COMPFWRT X'10' COMPFWRT TERM - ECHO WRITE COMBK .... 1... COMPFDEL X'08' COMPFDEL TERM - PF DELAY WRITE COMBK .... .1.. COMEXTHC X'04' COMEXTHC EXTENDED COLOR AND EXTENDED HIGHLIGHTING ATTRIBUTES ARE TO BE ADDED INTO THIS COMBK .... ..1. COMHIGH X'02' COMHIGH HILIGHTING ATTRIBUTES ARE TO BE ADDED INTO THIS COMBK .... ...1 COMIMMED X'01' COMIMMED IF THE USER IS IN FULL SCREEN MODE, THIS COMBK WILL BREAK IN IMMEDIATELY 0013 19 Bitstring 1 COMLINO DIAGNOSE DISPLAY LINE NO 0014 20 Bitstring 1 COMWORK TEMPORARY WORK FIELD 0015 21 Bitstring 1 COMFLG2 MISC. FLAGS .... ...1 COMDBCS X'01' COMDBCS DBCS output requested .... ..1. COMCMND X'02' COMCMND COMMAND OUTPUT FLAG .... .1.. COMINITP X'04' COMINITP SEND OF INITIAL LOGON PROMPTS .... 1... COMPRND X'08' COMPRND PROMPT FOLLOWED BY A READ NODISPLAY ...1 .... COMLED X'10' COMLED Limited Edit Write Requested ..1. .... COMFIRST X'20' COMFIRST First COMBK on RDEVCON queue .1.. .... COMDOCR X'40' COMDOCR Do carriage return 1... .... COMRPRMT X'80' COMRPRMT This COMBK is a read prompt for the integrated console 0016 22 Bitstring 1 * (2) RESERVED FOR FUTURE IBM USE 0018 24 Signed 4 COMFSCBK Address of FSCBK 001C 28 Signed 4 COM1HLAD Host logical address of 1st CCW data 0020 32 Dbl-Word 8 COMCCW1 FIRST CONSOLE I/O CCW 0028 40 Dbl-Word 8 COMCCW2 SECOND CONSOLE I/O CCW 0030 48 Dbl-Word 8 COMCCW3 THIRD CONSOLE I/O CCW 0038 56 Dbl-Word 8 COMCCW4 FOURTH CONSOLE I/O CCW 0040 64 Dbl-Word 8 COMDEVA Device dependent area 0048 72 Dbl-Word 8 * (0) ALIGNMENT 00000009 COMSIZE (*-COMBK)/8 COMBK HEADER SIZE IN DOUBLE WORDS 0048 72 Character 1 COMDATA (0) START OF VARIABLE LENGTH DATA COMCCW1 REDEFINITION 0020 32 Bitstring 1 COM1CMND CCW COMMAND CODE *** (AT HEX DISPLACEMENT: 1) 0021 33 Bitstring 1 COM1FLAG CCW FLAG BITS 1... .... CCWDC X'80' CCWDC CHAIN DATA ADDRESS AND COUNT .1.. .... CCWCC X'40' CCWCC COMMAND CHAIN ..1. .... CCWSILI X'20' CCWSILI SUPPRESS INCORRECT LENGTH ...1 .... CCWSKIP X'10' CCWSKIP SUPPRESS INBOUND DATA TRANSFER .... 1... CCWPCIR X'08' CCWPCIR REQUEST PC INTERRUPTION .... .1.. CCWIDA X'04' CCWIDA INDIRECT DATA ADDRESSING .... ..11 CCWINVAL X'03' CCWINVAL I/O UNDEFINED PAIR OF BITS .... ..1. CCWSUSPN X'02' CCWSUSPN I/O SUSPENSION/RESUMPTION The CCWUNDEF definition is left here because some code still uses this field where the CCWMIDA bit is not applicable. .... ...1 CCWUNDEF X'01' CCWUNDEF I/O UNDEFINED BIT .... ...1 CCWMIDA X'01' CCWMIDA Modified-CCW-indirect-data-addres sing 0022 34 Signed 2 COM1CNT CCW DATA COUNT 0024 36 Address 4 COM1ADDR CCW DATA ADDRESS 00000027 COM1ADRX *-1 CCW FINAL BYTE OF ADDRESS 0028 40 Dbl-Word 8 COM1NEXT (0) CCW FOLLOWING CURRENT CCW 0000000F COMWIS B'1111' ICM/STCM MASK FOR 31 BIT ADDRESS 00000004 COMWMC 04 MVC/CLC LENGTH FOR 31 BIT ADDRESS 00000080 COMWIDAL B'10000000' IDAL INVALID BIT MASK 00000008 COMWLEN 8 LENGTH OF A SINGLE CCW (8 BYTES) REDEFINITION - CLASTERM DEVICES 0040 64 Dbl-Word 8 COMCCW5 Additional CCW for start/stop devices REDEFINITION - CLASGRAF DEVICES 0040 64 Bitstring 1 * (3) RESERVED FOR FUTURE IBM USE 0043 67 Bitstring 1 COMRCMD 3270 COMMAND CHARACTER 0044 68 Bitstring 1 COMRWCC 3270 WRITE CONTROL CHARACTER 0045 69 Bitstring 1 COMRSBA 3270 'SBA' ORDER CHARACTER 0046 70 Signed 2 COMBUFA 3270 BUFFER ADDRESS CHARACTERS REDEFINITION OF COMBUFA 0046 70 Bitstring 1 COMBUFAD BUFFER ADDRESS 0047 71 Bitstring 1 COMBUFLC LOCATION ON THE HEADER
COMBK Storage Layout
*** COMBK - Console Communications Control Block
*
* +---------------------------+------+------+-------------+
* 0 | COMPNT |:BPARM|:PARM | COMTSKSZ |
* +---------------------------+------+------+-------------+
* 8 | COMRETN | COMUSER |
* +------+------+------+------+------+------+-------------+
* 10 |:STAT |:DFLAG|:CNTRL|:LINO |:WORK |:FLG2 |/////////////|
* +------+------+------+------+------+------+-------------+
* 18 | COMFSCBK | COM1HLAD |
* +---------------------------+---------------------------+
* 20 | COMCCW1 |
* +-------------------------------------------------------+
* 28 | COMCCW2 |
* +-------------------------------------------------------+
* 30 | COMCCW3 |
* +-------------------------------------------------------+
* 38 | COMCCW4 |
* +-------------------------------------------------------+
* 40 | COMDEVA |
* +-------------------------------------------------------+
*
*** COMBK - Console Communications Control Block
*** Overlay for COMCCW1 in COMBK
*
* +------+------+-------------+---------------------------+
* 20 |:1CMND|:1FLAG| COM1CNT | COM1ADDR |
* +------+------+-------------+---------------------------+
*
*** Overlay for COMCCW1 in COMBK
*** Overlay for COMDEVA in COMBK
*
* +-------------------------------------------------------+
* 40 | COMCCW5 |
* +-------------------------------------------------------+
* 48
*
*** Overlay for COMDEVA in COMBK
*** Overlay for COMDEVA in COMBK
*
* +--------------------+------+------+------+-------------+
* 40 |////////////////////|:RCMD |:RWCC |:RSBA | COMBUFA |
* +--------------------+------+------+------+-------------+
* 48
*
*** Overlay for COMDEVA in COMBK
*** Overlay for COMBUFA in COMBK
*
* +------+------+
* 40 ... 46 |:BUFAD|:BUFLC|
* +------+------+
* 48
*
*** Overlay for COMBUFA in COMBK
COMBK Cross Reference
Symbol Dspl Value -------------- ---- ----- CCWCC 0021 40 CCWDC 0021 80 CCWIDA 0021 04 CCWINVAL 0021 03 CCWMIDA 0021 01 CCWPCIR 0021 08 CCWSILI 0021 20 CCWSKIP 0021 10 CCWSUSPN 0021 02 CCWUNDEF 0021 01 COMACTV 0010 20 COMALRM 0005 02 COMALTVM 0004 20 COMBPARM 0004 COMBUFA 0046 COMBUFAD 0046 COMBUFLC 0047 COMCCW1 0020 COMCCW2 0028 COMCCW3 0030 COMCCW4 0038 COMCCW5 0040 COMCLEAR 0011 000000FE COMCLRS 0011 80 COMCMND 0015 02 COMCNCL 0011 000000FF COMCNTL 0010 10 COMCNTRL 0012 COMCRDR 0005 01 COMDATA 0048 COMDBCS 0015 01 COMDEVA 0040 COMDFLAG 0011 COMDIAG 0004 02 COMDOCR 0015 40 COMDROP 0005 80 COMEDIT 0005 04 COMESCP 0010 08 COMEXTHC 0012 04 COMFIRST 0015 20 COMFLG2 0015 COMFSCBK 0018 COMFSRQ 0011 40 COMHIDE 0005 08 COMHIGH 0012 02 COMHIPRI 0005 20 COMHOLD 0012 80 COMHPARM 0004 COMIMMED 0012 01 COMINITP 0015 04 COMIOCOM 0004 08 COMLED 0015 10 COMLINO 0013 COMLMSK 0011 3F COMLOALM 0010 04 COMMORE 0012 20 COMNOCR 0005 04 COMOUTPT 0010 80 COMPARM 0005 COMPFDEL 0012 08 COMPFWRT 0012 10 COMPNT 0000 COMPRND 0015 08 COMRCMD 0043 COMREDSP 0004 10 COMRESP 0010 40 COMRETN 0008 COMRPRMT 0015 80 COMRSBA 0045 COMRWCC 0044 COMSCRFL 0004 04 COMSIZE 0048 00000009 COMSPLT 0010 02 COMSTAT 0010 COMSYNC 0010 01 COMTSKSZ 0006 COMUPPR 0005 02 COMUSER 000C COMVMIO 0005 10 COMWIDAL 0028 00000080 COMWIS 0028 0000000F COMWLEN 0028 00000008 COMWMC 0028 00000004 COMWORK 0014 COMWRTRD 0012 40 COM1ADDR 0024 COM1ADRX 0024 00000027 COM1CMND 0020 COM1CNT 0022 COM1FLAG 0021 COM1HLAD 001C COM1NEXT 0028
Copyright IBM Corporation, 1990, 2011