Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
IRBLK
Control Block Contents
IRBLK DSECT
Cross Reference (Contains links to field and bit definitions)
IRBLK Prolog
NAME : HCPIRBLK DESCRIPTION: INTERRUPTION RESPONSE BLOCK MAPPING DSECT : IRBLK FUNCTION : PROVIDE SYMOLIC REFERENCES FOR THE FIELDS RETURNED IN RESPONSE TO A TSCH INSTRUCTION THAT SETS CONDITION CODE ZERO. LOCATED BY : N/A CREATED BY : N/A DELETED BY : N/A
IRBLK Control Block Content
IRBLK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IRBLK INTERRUPTION RESPONSE BLOCK MAPPING 0000 0 Bitstring 12 IRBSCSW (0) EXTENDED STATUS CSW 0000 0 Signed 4 IRBWORD0 (0) IRB WORD 0 0000 0 Bitstring 1 IRBSKEY KEY, EXTENDED STATUS AND DEFERRED CC 1111 .... CSWKEY X'F0' CSWKEY KEY OF I/O OPERATION (0-15) .... 1... CSWSRENA X'08' CSWSRENA SUSPEND-RESUME ENABLEMENT ORB only fields .... .1.. CSWSMCTL X'04' CSWSMCTL Streaming Mode Cntrl(ORB Word 1,Bit 5) .... ..1. CSWMODCT X'02' CSWMODCT Modification Control(ORB Word 1,Bit 6) .... ...1 CSWSYNCH X'01' CSWSYNCH Synchronize Control (ORB Word 1,Bit 7) IRB only fields .... .1.. CSWESTAT X'04' CSWESTAT 1=EXTENDED STATUS, 0=TIME .... ..11 CSWDFCC X'03' CSWDFCC DEFERRED CC EXTRACT MASK .... .... CSWCC0 X'00' CSWCC0 DEFERRED CC CODE 0 .... ...1 CSWCC1 X'01' CSWCC1 DEFERRED CC CODE 1 .... ..1. CSWCC2 X'02' CSWCC2 DEFERRED CC CODE 2 .... ..11 CSWCC3 X'03' CSWCC3 DEFERRED CC CODE 3 0001 1 Bitstring 1 IRBFPIZN CCW CONTROLS AND INITIAL RESPONSES 1111 1... CSWSUMRY X'F8' CSWSUMRY Summary test field. These bits will appe both the ORB and IRB 1111 1.11 CSWMESUM X'FB' CSWMESUM z/Arch mode summary test field. This mask includes bits that only appear in the ORB 1... .... CSWFORMT X'80' CSWFORMT FORMAT OF CCW .1.. .... CSWPREF X'40' CSWPREF UNLIMITED PREFETCH ALLOWED. ..1. .... CSWRESPN X'20' CSWRESPN INITIAL STATUS RESPONSE PRESENTED ...1 .... CSWLMODE X'10' CSWLMODE ADDRESS LIMIT IS IN EFFECT .... 1... CSWSUPSI X'08' CSWSUPSI SUPPRESS SUSPENDED INTERRUPTION .... ..1. CSWF2IDA X'02' CSWF2IDA ORB "H" bit - Format-2 IDAW control: when set, Format-2 (64-bit/31-bit data address, representing 4K of data) IDAWs are provided for all channel commands of the designated channel program which have the Indirect Data Addressing flag set to one. .... ...1 CSW2KIDA X'01' CSW2KIDA ORB "T" bit - only meaningful if the Form bit(H) is set. 64 bit/31 bit data addresses are used, however data is moved in 2K blocks per IDAW. .... .1.. CSWZCC X'04' CSWZCC CONFIRMED ZERO CONDITION CODE .... ..1. CSWELOG X'02' CSWELOG EXTENDED I/O LOGOUT STORED .... ...1 CSWPNOPR X'01' CSWPNOPR NOT-OPERATION PATH ENCOUNTERED 0002 2 Bitstring 1 IRBFCTL FUNCTION CONTROL BYTE 1... .... CSWQDIOA X'80' CSWQDIOA QDIO-Active (V) .1.. .... CSWSFCN X'40' CSWSFCN START SUBCHANNEL FUNCTION ..1. .... CSWHFCN X'20' CSWHFCN HALT SUBCHANNEL FUNCTION ...1 .... CSWCFCN X'10' CSWCFCN CLEAR SUBCHANNEL FUNCTION .... 1... CSWRPND X'08' CSWRPND RESUME SUBCHANNEL PENDING .... .1.. CSWSPND X'04' CSWSPND START SUBCHANNEL PENDING .... ..1. CSWHPND X'02' CSWHPND HALT SUBCHANNEL PENDING .... ...1 CSWCPND X'01' CSWCPND CLEAR SUBCHANNEL PENDING 0003 3 Bitstring 1 IRBACTL ACTIVITY CONTROL BYTE 1... .... CSWSCACT X'80' CSWSCACT SUBCHANNEL ACTIVE .1.. .... CSWDVACT X'40' CSWDVACT DEVICE ACTIVE ..1. .... CSWSUSPN X'20' CSWSUSPN SUBCHANNEL SUSPENDED ...1 .... CSWALERT X'10' CSWALERT ALERT STATUS .... 1... CSWISTAT X'08' CSWISTAT INTERMEDIATE STATUS .... .1.. CSWPSTAT X'04' CSWPSTAT PRIMARY STATUS .... ..1. CSWNSTAT X'02' CSWNSTAT SECONDARY STATUS .... ...1 CSWSTPND X'01' CSWSTPND STATUS PENDING 0004 4 Signed 4 IRBCCWA Absolute address of CCW at interrupt. (+8) 0008 8 Bitstring 4 IRBCSC (0) COMBINED DEVICE STATUS, SUBCHANNEL STATUS, AND RESIDUAL COUNT FIELDS 0008 8 Bitstring 1 IRBDVST DEVICE STATUS FLAGS 1... .... CSWATTN X'80' CSWATTN ATTENTION .1.. .... CSWSM X'40' CSWSM STATUS MODIFIER ..1. .... CSWCUE X'20' CSWCUE CONTROL UNIT END ...1 .... CSWBUSY X'10' CSWBUSY BUSY .... 1... CSWCE X'08' CSWCE CHANNEL END .... .1.. CSWDE X'04' CSWDE DEVICE END .... ..1. CSWUC X'02' CSWUC UNIT CHECK .... ...1 CSWUE X'01' CSWUE UNIT EXCEPTION .... 11.. CSWCEDE X'0C' CSWCEDE CHANNEL END AND DEVICE END ..1. 11.. CSWCEDC X'2C' CSWCEDC CHANNEL END,DEVICE END,AND CUE .1.1 .... CSWSMBSY X'50' CSWSMBSY CONTROL UNIT BUSY .111 .... CSWCBS X'70' CSWCBS CONTROL UNIT BUSY AND END 1... .1.. CSWDEA X'84' CSWDEA DEVICE END AND ATTENTION 0009 9 Bitstring 1 IRBSCST SUBCHANNEL STATUS FLAGS 1... .... CSWPCI X'80' CSWPCI PROGRAM CONTROLLED INTERRUPTION .1.. .... CSWIL X'40' CSWIL INCORRECT LENGTH INDICATION ..1. .... CSWPRG X'20' CSWPRG CHANNEL PROGRAM CHECK ...1 .... CSWPROT X'10' CSWPROT STORAGE PROTECTION CHECK .... 1... CSWCDC X'08' CSWCDC CHANNEL DATA CHECK .... .1.. CSWCCC X'04' CSWCCC CHANNEL CONTROL CHECK .... ..1. CSWIFCC X'02' CSWIFCC INTERFACE CONTROL CHECK .... ...1 CSWCHC X'01' CSWCHC CHANNEL CHAINING CHECK .... 111. CSWHCE X'0E' CSWHCE CDC+CCC+IFCC HARDWARE ERRORS ..11 ...1 CSWPCE X'31' CSWPCE PRG+CHC+PROT PROGRAM ERRORS 000A 10 Signed 2 IRBCNT UNEXPIRED COUNT IN CCW 000C 12 Signed 4 IRBXSTAT (0) EXTENDED STATUS/TIME WORD 000C 12 Bitstring 1 IRBECF CHANNEL PROGRAM ERROR CHECK FLAGS .1.. .... CSWKEYCK X'40' CSWKEYCK INVALID CBC ON STORAGE KEY ..1. .... CSWMBPCK X'20' CSWMBPCK ADDRESSING EXCEPTION ON MBI ...1 .... CSWMBDCK X'10' CSWMBDCK INVALID CBC ON MEASURE BLOCK .... 1... CSWMBACK X'08' CSWMBACK ACCESS EXCEPTION OF MEASURE BLK .... .1.. CSWCCWCK X'04' CSWCCWCK INVALID CBC ON CCW FIELDS .... ..1. CSWIDACK X'02' CSWIDACK INVALID CBC ON IDAL FIELDS .... ...1 CSWSALCK X'01' CSWSALCK INVALID ADDRESS LIMIT SET 000D 13 Bitstring 1 IRBLPUM LAST-PATH-USED MASK .... 11.1 IRBCPID IRBLPUM IRBCPID *** TEMPORARY UNTIL CODE CHANGE *** 000E 14 Signed 2 IRBDCTI (0) DEVICE CONNECT TIME INTERVAL 000E 14 Bitstring 1 IRBFVF TERMINATION CODE VALIDATION BITS 1... .... CSWFVFAR X'80' CSWFVFAR Ancillary report bit in the ESW .1.. .... CSWFVFLP X'40' CSWFVFLP LAST-PATH-USED IS VALID ..1. .... CSWFVFTC X'20' CSWFVFTC TERMINATION CODE IS VALID ...1 .... CSWFVFSC X'10' CSWFVFSC SEQUENCE CODE IS VALID .... 1... CSWFVFDS X'08' CSWFVFDS DEVICE STATUS IS VALID .... .1.. CSWFVFCA X'04' CSWFVFCA CCW ADDRESS IS VALID .... ..11 CSWSACOD X'03' CSWSACOD STORAGE ACCESS CODE: .... .... CSWSAUNK X'00' CSWSAUNK 00 - UNKNOWN TYPE .... ...1 CSWSARD X'01' CSWSARD 01 - READ .... ..1. CSWSAWRT X'02' CSWSAWRT 02 - WRITE .... ..11 CSWSARDB X'03' CSWSARDB 03 - READ BACKWARDS .... ..1. CSWFVFCN X'02' CSWFVFCN S/370-ONLY: CHANNEL # VALID .... ...1 CSWFVFDN X'01' CSWFVFDN S/370-ONLY: DEVICE # VALID ...1 11.. CSWFVFCM CSWFVFSC+CSWFVFDS+CSWFVFCA CSWFVFCM common fields 000F 15 Bitstring 1 IRBTMSEQ TERMINATION,ALERT AND SEQUENCE CODES 11.. .... CSWTMCOD X'C0' CSWTMCOD TERMINATION CODE : .... .... CSWTMCID X'00' CSWTMCID 00 - INTERFACE DISCONNECT .1.. .... CSWTMCST X'40' CSWTMCST 01 - STOP, STACK, NORMAL TERM 1... .... CSWTMCSR X'80' CSWTMCSR 10 - SELECTIVE RESET 11.. .... CSWTMXXX X'C0' CSWTMXXX 11 - RESERVED ..1. .... CSWLCLAR X'20' CSWLCLAR Ancillary report bit in the limited channel logout area ...1 .... CSWSECER X'10' CSWSECER SECONDARY ERROR .... 1... CSWEALRT X'08' CSWEALRT LOGOUT IS FROM I/O ERROR ALERT .... .111 CSWSQCOD X'07' CSWSQCOD SEQUENCE CODE : .... .... CSWSQXXX X'00' CSWSQXXX 000 - RESERVED .... ...1 CSWSQCOA X'01' CSWSQCOA 001 - COMMAND-OUT & ADDRESS-IN .... ..1. CSWSQCAC X'02' CSWSQCAC 010 - COMMAND ACCEPTED .... ..11 CSWSQDTR X'03' CSWSQDTR 011 - DATA TRANSFERRED .... .1.. CSWSQCNA X'04' CSWSQCNA 100 - COMMAND NOT ACCEPTED .... .1.1 CSWSQCAQ X'05' CSWSQCAQ 101 - COMMAND ACCEPTED BUT DATA TRANSFER UNKNOWN .... .11. CSWSQYYY X'06' CSWSQYYY 110 - RESERVED .... .111 CSWSQZZZ X'07' CSWSQZZZ 111 - RESERVED 0010 16 Signed 4 IRBERW (0) Extended Report Word for Format 0 ESW 0010 16 Bitstring 1 IRBERWB0 ERW Byte 0 .... 1... CSWPVRQ X'08' CSWPVRQ Path verification required .... ...1 CSWERWCS X'01' CSWERWCS Sense data stored in extended control word 0011 17 Bitstring 1 IRBERWB1 ERW Byte 1 1... .... CSW2CCWV X'80' CSW2CCWV Secondary CCW address validity bit .1.. .... CSWFSAFM X'40' CSWFSAFM Failing storage address Format =1 Indicates format-2 addr =0 Indicates format-1 addr ..11 1111 CSWCSCNT X'3F' CSWCSCNT Concurrent Sense Count extract mask 0012 18 Bitstring 1 * (2) Reserved for future hardware use 0014 20 Signed 4 * RESERVED FOR FUTURE HARDWARE USE 0018 24 Signed 4 * RESERVED FOR FUTURE HARDWARE USE 001C 28 Signed 4 IRB2DCCW Secondary CCW absolute address. 00000020 IRBLEN (*-IRBLK) LENGTH OF THE IRB WITHOUT XLOGOUT 0020 32 Bitstring 32 IRBXTLOG EXTENDED LOGOUT INFORMATION 00000040 IRBLENG (*-IRBLK) LENGTH OF ARCHITECTED IRB IN BYTES 0040 64 Bitstring 32 IRBXMEAS (0) Extended Measurement information 0040 64 Signed 4 IRBXCNTI Device-Connect Time 0044 68 Signed 4 IRBXFPTI Function-Pending Time 0048 72 Signed 4 IRBXDDTI Device-Disconnect Time 004C 76 Signed 4 IRBXCQTI Control-Unit-Queuing Time 0050 80 Signed 4 IRBXDATI Device-Active-Only-Time 0054 84 Signed 4 IRBXDBTI Device-Busy Time 0058 88 Signed 4 IRBXIRTI Initial-Command-Response Time 005C 92 Signed 4 * Reserved for future IBM use 00000060 IRBLENGM (*-IRBLK) Len of architected IRB w/ext meas info 0000000C IRBSIZE (IRBLENGM+7)/8 SIZE IN BYTES FOR CP ALLOCATION 0000 0 Bitstring 1 IRBDKEY CHSC Subchannel CRQBK Storage Key 0001 1 Bitstring 1 * 0002 2 Bitstring 2 IRBDFASC (0) FCTL (BIT 17-19) ACTL (BIT 20-26) 0002 2 Bitstring 1 IRBDFCTL 0003 3 Bitstring 1 IRBDACTL 0004 4 Bitstring 4 IRBDCRQ Absolute address of Communication Request BLK 0008 8 Bitstring 1 * 0009 9 Bitstring 1 IRBDSC CHSC Status Control 000A 10 Bitstring 2 *
IRBLK Storage Layout
*** IRBLK - INTERRUPTION RESPONSE BLOCK MAPPING * * +------+------+------+------+---------------------------+ * 0 |:SKEY |:FPIZN|:FCTL |:ACTL | IRBCCWA | * +------+------+------+------+------+------+------+------+ * 8 |:DVST |:SCST | IRBCNT |IRBECF|:LPUM |IRBFVF|:TMSEQ| * +------+------+-------------+------+------+------+------+ * 10 |:ERWB0|:ERWB1|/////////////|///////////////////////////| * +------+------+-------------+---------------------------+ * 18 |///////////////////////////| IRB2DCCW | * +---------------------------+---------------------------+ * 20 | | * = IRBXTLOG = * | | * +---------------------------+---------------------------+ * 40 | IRBXCNTI | IRBXFPTI | * +---------------------------+---------------------------+ * 48 | IRBXDDTI | IRBXCQTI | * +---------------------------+---------------------------+ * 50 | IRBXDATI | IRBXDBTI | * +---------------------------+---------------------------+ * 58 | IRBXIRTI |///////////////////////////| * +---------------------------+---------------------------+ * 60 * *** IRBLK - INTERRUPTION RESPONSE BLOCK MAPPING *** Overlay for IRBSCSW in IRBLK * * +------+------+------+------+---------------------------+ * 0 |:DKEY |//////|:DFCTL|:DACTL| IRBDCRQ | * +------+------+------+------+---------------------------+ * 8 |//////|IRBDSC|/////////////| C * +------+------+-------------+ * *** Overlay for IRBSCSW in IRBLK
IRBLK Cross Reference
Symbol Dspl Value -------------- ---- ----- CSWALERT 0003 10 CSWATTN 0008 80 CSWBUSY 0008 10 CSWCBS 0008 70 CSWCCC 0009 04 CSWCCWCK 000C 04 CSWCC0 0000 00 CSWCC1 0000 01 CSWCC2 0000 02 CSWCC3 0000 03 CSWCDC 0009 08 CSWCE 0008 08 CSWCEDC 0008 2C CSWCEDE 0008 0C CSWCFCN 0002 10 CSWCHC 0009 01 CSWCPND 0002 01 CSWCSCNT 0011 3F CSWCUE 0008 20 CSWDE 0008 04 CSWDEA 0008 84 CSWDFCC 0000 03 CSWDVACT 0003 40 CSWEALRT 000F 08 CSWELOG 0001 02 CSWERWCS 0010 01 CSWESTAT 0000 04 CSWFORMT 0001 80 CSWFSAFM 0011 40 CSWFVFAR 000E 80 CSWFVFCA 000E 04 CSWFVFCM 000E 1C CSWFVFCN 000E 02 CSWFVFDN 000E 01 CSWFVFDS 000E 08 CSWFVFLP 000E 40 CSWFVFSC 000E 10 CSWFVFTC 000E 20 CSWF2IDA 0001 02 CSWHCE 0009 0E CSWHFCN 0002 20 CSWHPND 0002 02 CSWIDACK 000C 02 CSWIFCC 0009 02 CSWIL 0009 40 CSWISTAT 0003 08 CSWKEY 0000 F0 CSWKEYCK 000C 40 CSWLCLAR 000F 20 CSWLMODE 0001 10 CSWMBACK 000C 08 CSWMBDCK 000C 10 CSWMBPCK 000C 20 CSWMESUM 0001 FB CSWMODCT 0000 02 CSWNSTAT 0003 02 CSWPCE 0009 31 CSWPCI 0009 80 CSWPNOPR 0001 01 CSWPREF 0001 40 CSWPRG 0009 20 CSWPROT 0009 10 CSWPSTAT 0003 04 CSWPVRQ 0010 08 CSWQDIOA 0002 80 CSWRESPN 0001 20 CSWRPND 0002 08 CSWSACOD 000E 03 CSWSALCK 000C 01 CSWSARD 000E 01 CSWSARDB 000E 03 CSWSAUNK 000E 00 CSWSAWRT 000E 02 CSWSCACT 0003 80 CSWSECER 000F 10 CSWSFCN 0002 40 CSWSM 0008 40 CSWSMBSY 0008 50 CSWSMCTL 0000 04 CSWSPND 0002 04 CSWSQCAC 000F 02 CSWSQCAQ 000F 05 CSWSQCNA 000F 04 CSWSQCOA 000F 01 CSWSQCOD 000F 07 CSWSQDTR 000F 03 CSWSQXXX 000F 00 CSWSQYYY 000F 06 CSWSQZZZ 000F 07 CSWSRENA 0000 08 CSWSTPND 0003 01 CSWSUMRY 0001 F8 CSWSUPSI 0001 08 CSWSUSPN 0003 20 CSWSYNCH 0000 01 CSWTMCID 000F 00 CSWTMCOD 000F C0 CSWTMCSR 000F 80 CSWTMCST 000F 40 CSWTMXXX 000F C0 CSWUC 0008 02 CSWUE 0008 01 CSWZCC 0001 04 CSW2CCWV 0011 80 CSW2KIDA 0001 01 IRBACTL 0003 IRBCCWA 0004 IRBCNT 000A IRBCPID 000D 0D IRBCSC 0008 IRBDACTL 0003 IRBDCRQ 0004 IRBDCTI 000E IRBDFASC 0002 IRBDFCTL 0002 IRBDKEY 0000 IRBDSC 0009 IRBDVST 0008 IRBECF 000C IRBERW 0010 IRBERWB0 0010 IRBERWB1 0011 IRBFCTL 0002 IRBFPIZN 0001 IRBFVF 000E IRBLEN 001C 00000020 IRBLENG 0020 00000040 IRBLENGM 005C 00000060 IRBLPUM 000D IRBSCST 0009 IRBSCSW 0000 IRBSIZE 005C 0000000C IRBSKEY 0000 IRBTMSEQ 000F IRBWORD0 0000 IRBXCNTI 0040 IRBXCQTI 004C IRBXDATI 0050 IRBXDBTI 0054 IRBXDDTI 0048 IRBXFPTI 0044 IRBXIRTI 0058 IRBXMEAS 0040 IRBXSTAT 000C IRBXTLOG 0020 IRB2DCCW 001C
Copyright IBM Corporation, 1990, 2008