Programming Interface Information:
This page documents intended Programming
Interfaces that allow the customer to write programs to obtain the services of VM/ESA. |
CQYSECT
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
Last updated on 12 Aug 1999 at 11:17:40 EDT.
Copyright IBM Corporation, 1990, 1999