|
Programming Interface Information:
This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM. |
CQYSECT
Control Block Contents
CQYSECT DSECT
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
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
Last updated on 1 May 2002 at 14:12:09 EDT.
Copyright IBM Corporation, 1990, 2002