Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

COMBK

Prolog  

Control Block Contents  
   COMBK DSECT

Storage Layout  

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.
 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

This information is based on z/VM V4R2.0. Last updated on 17 Oct 2001 at 14:54:22 EDT.
Copyright IBM Corporation, 1990, 2001