Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### CQYSECT

Prolog

Control Block Contents
CQYSECT DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### CQYSECT Prolog

     NAME       : CQYSECT
     DESCRIPTION: CONSOLE QUERY MAPPING
     DSECT      : CQYSECT
     FUNCTION   : THE CONSOLE QUERY DSECT MAPS A
                  USER'S BUFFER WITH INFORMATION ABOUT A PATH
                  AND/OR DEVICE. A BUFFER MAY BE SPECIFIED FOR
                  THE 'OPEN' OR 'QUERY' FUNCTIONS, AND THE
                  INFORMATION WILL BE STORED IN THIS BUFFER BY
                  THE CONSOLE FACILITY. OPERATION : LENGTH OF THE
                  PATH AND DEVICE SECTIONS IS CONTAINED IN THE
                  HEADER. IF THE LENGTH OF THE PATH SECTION IS 0,
                  THEN DIAGNOSE X'8C' INFO FOLLOWS THE DEVICE
                  SECTION. OTHERWISE, THE SEQUENCE IS: HEADER
                  FOLLOWED BY DEVICE SECTION, FOLLOWED BY PATH
                  INFO, FOLLOWED BY DIAGNOSE X'8C' INFORMATION.
                  THE POINTER TO THE DIAGNOSE X'8C' INFO IS IN
                  THE DEVICE SECTION.
     DEPENDENCIES - FIELDS CONTAINED WITHIN THE CQYDEV(DEVICE DATA
                  SECTION ) STRUCTURE MUST MAP 1 FOR 1 WITH THE
                  FIELDS IN THE QUERY SECTION OF THE CDEV CONTROL
                  BLOCK (CDEVCQY). ANY CHANGES MUST BE CHECKED
                  AGAINST MACROS DMSCDEV AND DMSCDEVP.

#### CQYSECT Control Block Content

#### CQYSECT DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CQYSECT        QUERY RETURN INFORMATION
    0000    0 Dbl-Word     8 CQYHEAD (0)    REPLY BUFFER HEADER
    0000    0 Signed       4 CQYHPLEN       LENGTH OF PATH SECTION
    0004    4 Signed       4 CQYHDLEN       LENGTH OF DEVICE SECTION
              00000008       CQYHEADL       *-CQYHEAD REPLY BUFFER HEADER
                                            LENGTH ** Device Section
    0008    8 Dbl-Word     8 CQYDEV (0)     DEVICE DATA SECTION
    0008    8 Signed       4 CQYDUSCT       NO. PATHS OPENED TO THIS DEVICE
    000C   12 Signed       4 CQYDNUMB       VIRTUAL DEVICE NUMBER DIAGNOSE
                                            X'24' INFO
    0010   16 Bitstring    4 CQYDVIRT (0)   VIRTUAL DEVICE INFO
    0010   16 Bitstring    1 CQYDVCLS       VIRTUAL DEV TYPE CLASS
    0011   17 Bitstring    1 CQYDVTYP       VIRTUAL DEVICE TYPE
    0012   18 Bitstring    1 CQYDVSTT       VIRTUAL DEVICE STATUS
    0013   19 Bitstring    1 CQYDVFLG       VIRTUAL DEVICE FLAGS
    0014   20 Bitstring    4 CQYDREAL (0)   REAL DEVICE INFO
    0014   20 Bitstring    1 CQYDRCLS       REAL DEVICE TYPE CLASS
    0015   21 Bitstring    1 CQYDRTYP       REAL DEVICE TYPE
    0016   22 Bitstring    1 CQYDRMDL       REAL MODEL NUMBER
    0017   23 Bitstring    1 CQYDRFTR       REAL FEATURE CODE
    0018   24 Bitstring    2 CQYDVCNS (0)   MORE DIAG X'24' INFO
    0018   24 Bitstring    1 CQYDLLEN       VIRT. CONSOLE LINE LENGTH
    0019   25 Bitstring    1 CQYDTMCD       VIRT. CONSOLE TERMINAL CODE
    001A   26 Bitstring    1 CQYDATTR       DEVICE ATTRIBUTE FLAGS
              .... .1..      CQYDARMT       X'04' DEV. IS A REMOTE 3270
              .... ..1.      CQYDADSP       X'02' DEV. IS A DISPLAY
              .... ...1      CQYDAVCN       X'01' DEV. IS THE VIRTUAL CONSOLE
    001B   27 Bitstring    1 CQYDSTAT       DEVICE STATUS FLAG 1
              1... ....      CQYDATTN       X'80' ATTENTION PENDING
              .1.. ....      CQYDDISC       X'40' DEVICE IS DISCONNECTED
              ..1. ....      CQYDLINE       X'20' VIRTUAL CONSOLE STATE AT
                                            LAST I/O INTERRUPT (1=LINEMODE,
                                            0=FSCR)
              0000001C       CQYDQR         * FIRST 6 BYTES DIAG X'8C' INFO
    001C   28 Bitstring    1 CQYDQRFL       FLAGS
              1... ....      CQYDQREC       X'80' EXTENDED COLOR SUPPORTED
              .1.. ....      CQYDQREH       X'40' EXTENDED HIGHLIGHT
                                            SUPPORTED
              ..1. ....      CQYDQRPS       X'20' PSS SUPPORTED
              .... ..1.      CQYDQREF       X'02' 3270 EMULATION FEATURE
              .... ...1      CQYDQR14       X'01' 14-BIT ADDRESSING SUPPORTED
    001D   29 Bitstring    1 CQYDQRPN       NUMBER OF PARTITIONS
    001E   30 Signed       2 CQYDQRCL       NUMBER OF COLUMNS
    0020   32 Signed       2 CQYDQRRW       NUMBER OF ROWS
    0022   34 Bitstring    1 CQYDQYCD       DEVICE QUERY CODE
    0023   35 Bitstring    1 *              RESERVED
    0024   36 Signed       4 CQYD8CL        LENGTH OF REMAINING DIAG X'8C'
                                            INFO
    0028   40 Address      4 CQYD8CP        PTR TO WSF INFO AFTER THE 1ST 6
                                            BYTES OF DIAG 8C INFO
    002C   44 Signed       4 *              RESERVED
              00000028       CQYDEVL        *-CQYDEV LENGTH OF DEVICE SECTION
              00000030       CQYDHL         (CQYHEADL+CQYDEVL) LENGTH OF DEV
                                            + HDR SECTIONS ** Path Section
    0030   48 Dbl-Word     8 CQYPATH (0)    PATH DATA SECTION
    0030   48 Address      4 CQYPEXIT       USER EXIT ADDRESS
    0034   52 Signed       4 CQYPXWRD       USER WORD
    0038   56 Bitstring    1 CQYPFLG        PATH FLAG
              1... ....      CQYPLIO        X'80' PATH DID LAST I/O
              ...1 ....      CQYPNRST       X'10' NO DEVICE RESET REQUESTED
    0039   57 Bitstring    3 *              RESERVED
    003C   60 Signed       4 *              RESERVED
    0040   64 Bitstring   12 CQYPSCSW (0)   CHANNEL STATUS WORD
    0040   64 Bitstring    1 CQYPSLCC       LOGOUT PENDING/COND. CODES
              1111 1...      CQYPKSL        X'F8' KEY/SUSPEND/LOG BITS
              .... .1..      CQYPLOG        X'04' LOGOUT PENDING
              .... ..11      CQYPCC         X'03' DEFERRED CONDITION CODE
    0041   65 Bitstring    3 CQYPCTL        ORB AND SUBCHANNEL CONTROL BITS
    0044   68 Signed       4 CQYPCCW        LAST CCW EXECUTED
    0048   72 Bitstring    1 CQYPUST        UNIT STATUS BYTE
              1... ....      CQYPATTN       X'80' ATTENTION
              .1.. ....      CQYPSTMD       X'40' STATUS MODIFIER
              ..1. ....      CQYPCUE        X'20' CONTROL UNIT END
              ...1 ....      CQYPBUSY       X'10' BUSY
              .... 1...      CQYPCHEN       X'08' CHANNEL END
              .... .1..      CQYPDVEN       X'04' DEVICE END
              .... ..1.      CQYPUNCK       X'02' UNIT CHECK
              .... ...1      CQYPUNEX       X'01' UNIT EXCEPTION
    0049   73 Bitstring    1 CQYPCST        CHANNEL STATUS BYTE
              1... ....      CQYPPCI        X'80' PROGRAM-CONTROLLED
                                            INTERRUPTION
              .1.. ....      CQYPICL        X'40' INCORRECT LENGTH
              ..1. ....      CQYPPGCK       X'20' PROGRAM CHECK
              ...1 ....      CQYPPRCK       X'10' PROTECTION CHECK
              .... 1...      CQYPCDCK       X'08' CHANNEL DATA CHECK
              .... .1..      CQYPCCCK       X'04' CHANNEL CONTROL CHECK
              .... ..1.      CQYPICCK       X'02' INTERFACE CONTROL CHECK
              .... ...1      CQYPCHCK       X'01' CHAINING CHECK
    004A   74 Signed       2 CQYPRCT        RESIDUAL COUNT
    004C   76 Signed       4 CQYPSCNT       SENSE COUNT
    0050   80 Bitstring   32 CQYPSDTA       SENSE DATA
              00000040       CQYPATHL       *-CQYPATH PATH SECTION LENGTH
              00000070       CQYSIZE        (CQYHEADL+CQYDEVL+CQYPATHL) TOTAL
                                            CQYSECT LENGTH
              0000000E       CQYDBSZ        ((CQYSIZE+7)/8) SIZE OF ALL
                                            SECTIONS IN DBWRDS

#### CQYSECT Storage Layout

    *** CQYSECT - Control Block in CQYSECT
    *
    *     +---------------------------+---------------------------+
    *   0 |         CQYHPLEN          |         CQYHDLEN          |
    *     +---------------------------+---------------------------+
    *   8 |         CQYDUSCT          |         CQYDNUMB          |
    *     +------+------+------+------+------+------+------+------+
    *  10 |:DVCLS|:DVTYP|:DVSTT|:DVFLG|:DRCLS|:DRTYP|:DRMDL|:DRFTR|
    *     +------+------+------+------+------+------+------+------+
    *  18 |:DLLEN|:DTMCD|:DATTR|:DSTAT|:DQRFL|:DQRPN|  CQYDQRCL   |
    *     +------+------+------+------+------+------+-------------+
    *  20 |  CQYDQRRW   |:DQYCD|//////|         CQYD8CL           |
    *     +-------------+------+------+---------------------------+
    *  28 |         CQYD8CP           |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  30 |         CQYPEXIT          |         CQYPXWRD          |
    *     +------+--------------------+---------------------------+
    *  38 |:PFLG |////////////////////|///////////////////////////|
    *     +------+--------------------+---------------------------+
    *  40 |:PSLCC|      CQYPCTL       |         CQYPCCW           |
    *     +------+------+-------------+---------------------------+
    *  48 |:PUST |:PCST |  CQYPRCT    |         CQYPSCNT          |
    *     +------+------+-------------+---------------------------+
    *  50 |                                                       |
    *     =                       CQYPSDTA                        =
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  70
    *
    *** CQYSECT - Control Block in CQYSECT

#### CQYSECT Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CQYDADSP       001A 02
    CQYDARMT       001A 04
    CQYDATTN       001B 80
    CQYDATTR       001A
    CQYDAVCN       001A 01
    CQYDBSZ        0050 0000000E
    CQYDDISC       001B 40
    CQYDEV         0008
    CQYDEVL        002C 00000028
    CQYDHL         002C 00000030
    CQYDLINE       001B 20
    CQYDLLEN       0018
    CQYDNUMB       000C
    CQYDQR         001B 0000001C
    CQYDQRCL       001E
    CQYDQREC       001C 80
    CQYDQREF       001C 02
    CQYDQREH       001C 40
    CQYDQRFL       001C
    CQYDQRPN       001D
    CQYDQRPS       001C 20
    CQYDQRRW       0020
    CQYDQR14       001C 01
    CQYDQYCD       0022
    CQYDRCLS       0014
    CQYDREAL       0014
    CQYDRFTR       0017
    CQYDRMDL       0016
    CQYDRTYP       0015
    CQYDSTAT       001B
    CQYDTMCD       0019
    CQYDUSCT       0008
    CQYDVCLS       0010
    CQYDVCNS       0018
    CQYDVFLG       0013
    CQYDVIRT       0010
    CQYDVSTT       0012
    CQYDVTYP       0011
    CQYD8CL        0024
    CQYD8CP        0028
    CQYHDLEN       0004
    CQYHEAD        0000
    CQYHEADL       0004 00000008
    CQYHPLEN       0000
    CQYPATH        0030
    CQYPATHL       0050 00000040
    CQYPATTN       0048 80
    CQYPBUSY       0048 10
    CQYPCC         0040 03
    CQYPCCCK       0049 04
    CQYPCCW        0044
    CQYPCDCK       0049 08
    CQYPCHCK       0049 01
    CQYPCHEN       0048 08
    CQYPCST        0049
    CQYPCTL        0041
    CQYPCUE        0048 20
    CQYPDVEN       0048 04
    CQYPEXIT       0030
    CQYPFLG        0038
    CQYPICCK       0049 02
    CQYPICL        0049 40
    CQYPKSL        0040 F8
    CQYPLIO        0038 80
    CQYPLOG        0040 04
    CQYPNRST       0038 10
    CQYPPCI        0049 80
    CQYPPGCK       0049 20
    CQYPPRCK       0049 10
    CQYPRCT        004A
    CQYPSCNT       004C
    CQYPSCSW       0040
    CQYPSDTA       0050
    CQYPSLCC       0040
    CQYPSTMD       0048 40
    CQYPUNCK       0048 02
    CQYPUNEX       0048 01
    CQYPUST        0048
    CQYPXWRD       0034
    CQYSIZE        0050 00000070

This information is based on z/VM V4R4.0.
Last updated on 28 Jul 2003 at 08:13:28 EDT.
Copyright IBM Corporation, 1990, 2003