|
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
COPYRIGHT -
THIS MODULE IS "RESTRICTED MATERIALS OF IBM"
5654-030 (C) COPYRIGHT IBM CORP. - 1983, 1998
LICENSED MATERIALS - PROPERTY OF IBM
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.
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' data to be sent to an
alternate user
...1 .... COMREDSP X'10' this is input redisplay
data
.... 1... COMIOCOM X'08' return when I/O is
completed
.... .1.. COMSCRFL X'04' return if data can fit on
current scrn
.... ..1. COMDIAG X'02' this is a diagnose request
0005 5 Bitstring 1 COMPARM CALLING PARMS (SEE EQUATES COPY)
1... .... COMDROP X'80' LOGOFF & DROP line after
message
..1. .... COMHIPRI X'20' hipriority message
...1 .... COMVMIO X'10' virtual machine I/O
.... 1... COMHIDE X'08' do not display the data
.... .1.. COMNOCR X'04' suppress automatic carriage
return
.... ..1. COMALRM X'02' sound the audible alarm
.... ...1 COMCRDR X'01' data is expected from a
cardreader
.... .1.. COMEDIT X'04' 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' 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' OUTPUT COMBK
.1.. .... COMRESP X'40' RESPONSE EXPECTED FROM THIS
COMBK
..1. .... COMACTV X'20' COMBK IS ACTIVE ON REAL
DEVICE
...1 .... COMCNTL X'10' THIS IS A CONTROL COMBK
ONLY
.... 1... COMESCP X'08' COMBK CONTAINS DEVICE
DEPENDENT DATA
.... .1.. COMLOALM X'04' 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' OUTPUT DATA BEING SPLIT
.... ...1 COMSYNC X'01' COMBK FOR SYNCHRONIZATION
ONLY
0011 17 Bitstring 1 COMDFLAG DIAGNOSE DISPLAY FLAG
000000FF COMCNCL 255 DISPLAY - CANCEL FUNCTION
REQUESTED
000000FE COMCLEAR 254 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' DISPLAY - CLEAR SCREEN
BEFORE OUTPUT
.1.. .... COMFSRQ X'40' DISPLAY - FULL-SCREEN
CONTROL REQUEST
..11 1111 COMLMSK X'3F' DISPLAY - MASK FOR BITS IN
LINE NUM
0012 18 Bitstring 1 COMCNTRL CONTROL FLOW FLAGS
1... .... COMHOLD X'80' DISPLAY - SCREEN STATUS
HOLDING
.1.. .... COMWRTRD X'40' TERM - COMBK CONTAINS
WRITE/READ
..1. .... COMMORE X'20' TERM - 'MORE' COMBK
...1 .... COMPFWRT X'10' TERM - ECHO WRITE COMBK
.... 1... COMPFDEL X'08' TERM - PF DELAY WRITE COMBK
.... .1.. COMEXTHC X'04' EXTENDED COLOR AND EXTENDED
HIGHLIGHTING ATTRIBUTES ARE TO BE
ADDED INTO THIS COMBK
.... ..1. COMHIGH X'02' HILIGHTING ATTRIBUTES ARE
TO BE ADDED INTO THIS COMBK
.... ...1 COMIMMED X'01' 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' DBCS output requested
.... ..1. COMCMND X'02' COMMAND OUTPUT FLAG
.... .1.. COMINITP X'04' SEND OF INITIAL LOGON
PROMPTS
.... 1... COMPRND X'08' PROMPT FOLLOWED BY A READ
NODISPLAY
...1 .... COMLED X'10' Limited Edit Write
Requested
..1. .... COMFIRST X'20' First COMBK on RDEVCON
queue
.1.. .... COMDOCR X'40' Do carriage return
1... .... COMRPRMT X'80' 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 * Reserved for IBM use
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' CHAIN DATA ADDRESS AND
COUNT
.1.. .... CCWCC X'40' COMMAND CHAIN
..1. .... CCWSILI X'20' SUPPRESS INCORRECT LENGTH
...1 .... CCWSKIP X'10' SUPPRESS INBOUND DATA
TRANSFER
.... 1... CCWPCIR X'08' REQUEST PC INTERRUPTION
.... .1.. CCWIDA X'04' INDIRECT DATA ADDRESSING
.... ..11 CCWINVAL X'03' I/O UNDEFINED PAIR OF BITS
.... ..1. CCWSUSPN X'02' I/O SUSPENSION/RESUMPTION
.... ...1 CCWUNDEF X'01' I/O UNDEFINED BIT
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 |///////////////////////////|
* +---------------------------+---------------------------+
* 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 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 COM1NEXT 0028
Copyright IBM Corporation, 1990, 2002