Programming Interface Information:
This page documents intended Programming
Interfaces that allow the customer to write programs
to obtain the services of VM/ESA.
|
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 CONSOLE QUERY MAPPING
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 - CONSOLE QUERY MAPPING
*
* +---------------------------+---------------------------+
* 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 - CONSOLE QUERY MAPPING
CQYSECT Cross Reference (contains links to field and bit definitions)
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 VM/ESA 2.4.0.
Last updated on 12 Aug 1999 at 11:17:40 EDT.
Copyright IBM Corporation, 1990, 1999
|
