Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
CUIBK
Cross Reference (Contains links to field and bit definitions)
CUIBK Prolog
NAME : HCPCUIBK DESCRIPTION: CONTROL UNIT INFORMATION BLOCK DSECT : CUIBK FUNCTION : THE CONTROL UNIT INFORMATION BLOCK IS USED TO MANAGE DASD CONTROL UNIT INFORMATION. LOCATED BY : THE LIST OF CUIBKS IS ANCHORED IN SYSCUIPT CUINXTCU FIELD OF CUIBK - FORWARD CUIBK POINTER RDEVCUI FIELD OF RDEV - POINTER TO CUIBK ASSOCIATED WITH RDEV CREATED BY : CUIBK'S ARE CREATED DYNAMICALLY BY DEVICE INITIALIZATION PROCESSING. DELETED BY : CUIBK's are deleted by HCPZDRDV during RDEV delete processing and by HCPZRPPP during post-processing for the RDEVICE statement or SET RDEVICE command. Serialized : Addition and Deletion of a CUIBK from the CUIBK chain that hangs off SYSCUIPT in the System Common Area is serialized by obtaining the SYSCUILK in exclusive mode. Code that runs the SYSCUIPT CUIBK chain in an attempt to locate a specific CUIBK should obtain the SYSCUILK in shared mode to ensure the integrity of the chain. Serialization of fields in the CUIBK not related to the SYSCUIPT chain is handled either by running on the Master Processor or as described in the line comments below.
CUIBK Control Block Content
CUIBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure CUIBK CONTROL UNIT INFORMATION BLOCK 0000 0 Address 4 CUINXTCU NEXT CUIBK IN CHAIN 0004 4 Address 4 CUIRDEVS POINTER TO LIST OF RDEVS ASSOCIATED WITH THIS CONTROL UNIT 0008 8 Dbl-Word 8 * (0) 0008 8 Bitstring 24 CUIAQLCK SPIN LOCK FOR AEBK QUEUE (CUIAEBK) 0020 32 Address 4 CUIAEBK POINTER TO LIST OF AEBKS ASSOCIATED WITH THIS CONTROL UNIT 0024 36 Signed 4 CUIDEDCT NUMBER OF DEVICES ATTACHED TO THIS CONTROL UNIT WHICH ARE DEDICATED TO THE V=R GUEST (OR WHICH HE HAS LINKED AS A FULL-PACK MINI) NOTES : THIS FIELD IS SERIALIZED BY MEANS COMPARE AND SWAP LOGIC. ALL REFERENCES TO FIELD MUST BE MADE USING COMPARE AND SWAP 0028 40 Bitstring 1 CUIPOLL FLAG FOR POLLING 1... .... CUIPOLL1 X'80' USED TO INDICATE WHETHER ALL AEBKS ON THIS CUIBK HAVE BEEN POLLED THIS TIME (USED AS A TOGGLE IN CONJUNCTION WITH CUIPOLL2) .1.. .... CUIPOLL2 X'40' USED TO INDICATE WHETHER ALL AEBKS ON THIS CUIBK HAVE BEEN POLLED THIS TIME (USED AS A TOGGLE IN CONJUNCTION WITH CUIPOLL1) 0029 41 Bitstring 1 CUISFLG SPECIAL CONDITIONS FLAG 1... .... CUIGSCPY X'80' INDICATES DURING GUEST SURVIVAL THAT THIS CUIBK HAS ALREADY BEEN COPIED INTO A SHADOW IN V=R STORAGE 002A 42 Bitstring 14 CUISSID Subsystem ID for this control unit 0038 56 Dbl-Word 8 * (0) 0038 56 Bitstring 24 CUIDTLCK SPIN LOCK FOR SUBSYSTEM STATUS DATA FIELDS (CUISSID, CUICFWID, AND CUISFLGS) 0050 80 Signed 2 CUICFWID CURRENT CACHE FASTWRITE ID FOR THIS SUBSYSTEM 0052 82 Signed 2 CUIDVSC DEVICE NUMBER OF THE DEVICE WHICH MOST RECENTLY CAUSED THE INVOCATION OF STATE-CHANGE-TYPE PROCESSING 0054 84 Bitstring 1 CUISCAS SUBSYSTEM CACHING STATUS FLAG 1... .... CUISSCA X'80' CACHING IS ACTIVE .1.. .... CUISCTM X'40' CACHING TERMINATED ..1. .... CUISSCD X'20' CACHING IS DEACTIVATED ...1 .... CUISCPOF X'10' PENDING OFF FAILED 0055 85 Bitstring 1 CUISDCCO STORAGE DIRECTOR CACHING CONDITIONS FLAG 1... .... CUISSDM X'80' SUBSYSTEM STORAGE DISABLED FOR MAINTENANCE .1.. .... CUIIMLNA X'40' IML DEVICE NOT AVAILABLE ..1. .... CUICFWDA X'20' CACHE FAST WRITE DATA ACTIVATED ...1 .... CUICFWDD X'10' CACHE FAST WRITE DATA DEACTIVATED 0056 86 Bitstring 1 CUINVCAS NON-VOLATILE CACHE STATUS FLAG 1... .... CUINVCA X'80' NON-VOLATILE CACHE IS ACTIVATED .1.. .... CUINVTM X'40' NON-VOLATILE CACHE AVAILABILITY TERMINATED ..1. .... CUINVCD X'20' NON-VOLATILE CACHE DEACTIVATED ...1 .... CUINVPOF X'10' NON-VOLATILE CACHE PENDING OFF 0057 87 Bitstring 1 CUINVSCO NON-VOLATILE STORAGE CONDITIONS FLAG 1... .... CUINVDM X'80' NON-VOLATILE STORAGE DISABLED FOR MAINTENANCE .1.. .... CUINVPE X'40' NON-VOLATILE STORAGE PENDING BECAUSE OF ERROR ..1. .... CUINVOP X'20' NON-VOLATILE STORAGE OPERATIONAL *** CONTROL UNIT ID & MODEL NUMBER 0058 88 Bitstring 2 CUICUID CONTROL UNIT ID IN PACKED DECIMAL 005A 90 Bitstring 1 CUICUMN CONTROL UNIT MODEL NUMBER THIS BYTE IS USED AS A PLACE HOLDER. WHEN A DEVICE GOES FRO BEING A SECONDARY TO SIMPLEX, THIS INFORMATION WILL BE USED IN THE SETTING OF RDEVDP AND RDEVFEAT INFORMATION. 005B 91 Bitstring 1 CUIFEAT FEATURE INFORMATION FOR DUPLEX PAIRS 1... .... CUIGRPD X'80' PATHS ARE CURRENTLY GROUPED .... .1.. CUIRSRL X'04' RESERVE/RELEASE IS SUPPORTED .... ..1. CUIMPM X'02' MULTIPATH MODE DP WAS ESTABLISHED .... ...1 CUISPM X'01' MULITPATH MODE DP AS ESTABLISHED 005C 92 Signed 4 CUILSBK Pointer to library statistics block 0060 96 Signed 4 CUILSLN Length of library statistics block 0064 100 Signed 2 CUILIMGR (0) Status Bits 0064 100 Bitstring 2 CUIOPRS Referenced by HCPTAM 00008000 CUIAUTO X'8000' Referenced by HCPTAM 00004000 CUIPAUS X'4000' Referenced by HCPTAM 00002000 CUIMANM X'2000' Referenced by HCPTAM 00001000 CUIDGOP X'1000' Referenced by HCPTAM 00000800 CUISFTY X'0800' Referenced by HCPTAM 00000200 CUIOFFL X'0200' Referenced by HCPTAM 0066 102 Signed 2 CUIPMIH Primary MIH time-out value 0068 104 Bitstring 1 CUISCAS0 SUBSYSTEM CACHING STORAGE STATUS FLAG 1... .... CUISSCA0 X'80' CACHING IS ACTIVE .1.. .... CUISCTM0 X'40' CACHING TERMINATED (INT SUBSYS ERROR) ..1. .... CUISSCD0 X'20' CACHING IS DEACTIVATED ...1 .... CUISCPF0 X'10' PENDING OFF FAILED .... 1... CUISCMN0 X'08' CACHING DISABLED FOR MAINTENANCE 0069 105 Bitstring 1 CUISCAS1 SUBSYSTEM CACHING STORAGE STATUS FLAG 1... .... CUISSCA1 X'80' CACHING IS ACTIVE .1.. .... CUISCTM1 X'40' CACHING TERMINATED (INT SUBSYS ERROR) ..1. .... CUISSCD1 X'20' CACHING IS DEACTIVATED ...1 .... CUISCPF1 X'10' PENDING OFF FAILED .... 1... CUISCMN1 X'08' CACHING DISABLED FOR MAINTENANCE 006A 106 Bitstring 1 CUINVCS0 NON-VOLATILE STORAGE STATUS FLAG 1... .... CUINVCA0 X'80' NON-VOLATILE STOR. IS ACTIVATED .1.. .... CUINVTM0 X'40' NON-VOLATILE STOR. AVAIL TERMINATED ..1. .... CUINVCD0 X'20' NON-VOLATILE STOR. DEACTIVATED ...1 .... CUINVSM0 X'10' NON-VOLATILE STOR. IN MAINTENANCE 006B 107 Bitstring 1 CUINVCS1 NON-VOLATILE STORAGE STATUS FLAG 1... .... CUINVCA1 X'80' NON-VOLATILE CACHE IS ACTIVATED .1.. .... CUINVTM1 X'40' NON-VOLATILE CACHE AVAIL TERMINATED ..1. .... CUINVCD1 X'20' NON-VOLATILE CACHE DEACTIVATED ...1 .... CUINVSM1 X'10' NON-VOLATILE STOR. IN MAINTENANCE 006C 108 Bitstring 1 CUILEVEL FORMAT OF SENSE SUBSYSTEM STATUS 1... .... CUISCNVS X'80' FORMAT 0 OF SENSE SUBSYSTEM STATUS .1.. .... CUIDCNVS X'40' FORMAT 1 OF SENSE SUBSYSTEM STATUS 006D 109 Bitstring 1 CUISSFG Subsystem Flag 1... .... CUISNSS X'80' Control unit supports Sense Subsystem Status CCW 006E 110 Bitstring 1 CUIGLBST SUBSYSTEM STATUS(CACHE&DASD) fastwrite 1... .... CUISFWRE X'80' FAST WRITE (CACHE AND DASD) RESUMED .1.. .... CUISFWSU X'40' FAST WRITE (CACHE AND DASD) SUSPENDED 006F 111 Bitstring 1 CUILSACP LSA Capacity operating level 00000000 CUILSAHA X'00' Home Area subsystem 00000001 CUILSANM X'01' Normal: LSA subsystem is not capacity strained 00000003 CUILSAST X'03' Stressed: LSA subsystem is running beyond recommended capacity 00000005 CUILSACR X'05' Critical: LSA subsystem is almost out of space 00000007 CUILSAEM X'07' Emergency: LSA subsystem is totally full 0070 112 Signed 2 CUISMIH Secondary MIH time-out value 0072 114 Signed 2 * Reserved for IBM Use 0074 116 Address 4 CUITOKND Pointer to CDT structure (Token NED) 0078 120 Address 4 CUIGRSBK Pointer to list of guest response summaries 007C 124 Signed 4 * Reserved for IBM Use 0080 128 Dbl-Word 8 * (0) Doubleword aligned 0080 128 Bitstring 24 CUICDTLK Deferlock for CDT structure pointed to by CUITOKND 0098 152 Address 4 CUICUIRQ Pointer to first CUIR message task 009C 156 Address 4 CUICUILT Pointer to last CUIR message task 00A0 160 Dbl-Word 8 * (0) Doubleword aligned 00A0 160 Bitstring 24 CUIGQLCK Spin lock for Guest response summaries 00B8 184 Bitstring 4 CUICUIFG Flaf for CUIR message task 00BC 188 Bitstring 14 CUITTID Tape token NED id 00CA 202 Bitstring 14 CUITLID Tape library NED id 00D8 216 Address 4 CUIARSV Pointer to Diagnose X'254' pseudo VDEV if it exists. Serialized by ARSLOCKW in the HCPIOD25 data area. 00DC 220 Bitstring 4 * RESERVED 00E0 224 Dbl-Word 8 CUIBKEND (0) END OF CUIBK 0000001C CUISIZE (*-CUIBK+7)/8 SIZE OF CUIBK 002A 42 Bitstring 14 CUITSSID Tape Subsystem ID 002A 42 Bitstring 2 CUIDSSID DASD Subsystem ID
CUIBK Storage Layout
*** CUIBK - CONTROL UNIT INFORMATION BLOCK * * +---------------------------+---------------------------+ * 0 | CUINXTCU | CUIRDEVS | * +---------------------------+---------------------------+ * 8 | | * = CUIAQLCK = * | | * +---------------------------+---------------------------+ * 20 | CUIAEBK | CUIDEDCT | * +------+------+-------------+---------------------------+ * 28 |:POLL |:SFLG | CUISSID | * +------+------+ | * | | * +-------------------------------------------------------+ * 38 | | * = CUIDTLCK = * | | * +-------------+-------------+------+------+------+------+ * 50 | CUICFWID | CUIDVSC |:SCAS |:SDCCO|:NVCAS|:NVSCO| * +-------------+------+------+------+------+------+------+ * 58 | CUICUID |:CUMN |:FEAT | CUILSBK | * +-------------+------+------+-------------+-------------+ * 60 | CUILSLN | CUIOPRS | CUIPMIH | * +------+------+------+------+------+------+------+------+ * 68 |:SCAS0|:SCAS1|:NVCS0|:NVCS1|:LEVEL|:SSFG |:GLBST|:LSACP| * +------+------+------+------+------+------+------+------+ * 70 | CUISMIH |/////////////| CUITOKND | * +-------------+-------------+---------------------------+ * 78 | CUIGRSBK |///////////////////////////| * +---------------------------+---------------------------+ * 80 | | * = CUICDTLK = * | | * +---------------------------+---------------------------+ * 98 | CUICUIRQ | CUICUILT | * +---------------------------+---------------------------+ * A0 | | * = CUIGQLCK = * | | * +---------------------------+---------------------------+ * B8 | CUICUIFG | | * +---------------------------+ | * | CUITTID | * | +-----------------------------------------+ * C8 | | CUITLID | * +-------------+ | * | | * +---------------------------+---------------------------+ * D8 | CUIARSV |///////////////////////////| * +---------------------------+---------------------------+ * E0 | | * = CUIBKEND = * | | * +-------------------------------------------------------+ * *** CUIBK - CONTROL UNIT INFORMATION BLOCK *** Overlay for CUISSID in CUIBK * * +-----------------------------------------+ * 28 ... 2A | CUITSSID | * +-------------+ | * | | * +-------------------------------------------------------+ * 38 * *** Overlay for CUISSID in CUIBK *** Overlay for CUISSID in CUIBK * * +-------------+ * 28 ... 2A | CUIDSSID | 2C * +-------------+ * *** Overlay for CUISSID in CUIBK
CUIBK Cross Reference
(contains links to field and bit definitions)Symbol Dspl Value -------------- ---- -----CUIAEBK 0020
CUIAQLCK 0008
CUIARSV 00D8
CUIAUTO 0064 00008000
CUIBKEND 00E0
CUICDTLK 0080
CUICFWDA 0055 20
CUICFWDD 0055 10
CUICFWID 0050
CUICUID 0058
CUICUIFG 00B8
CUICUILT 009C
CUICUIRQ 0098
CUICUMN 005A
CUIDCNVS 006C 40
CUIDEDCT 0024
CUIDGOP 0064 00001000
CUIDSSID 002A
CUIDTLCK 0038
CUIDVSC 0052
CUIFEAT 005B
CUIGLBST 006E
CUIGQLCK 00A0
CUIGRPD 005B 80
CUIGRSBK 0078
CUIGSCPY 0029 80
CUIIMLNA 0055 40
CUILEVEL 006C
CUILIMGR 0064
CUILSACP 006F
CUILSACR 006F 00000005
CUILSAEM 006F 00000007
CUILSAHA 006F 00000000
CUILSANM 006F 00000001
CUILSAST 006F 00000003
CUILSBK 005C
CUILSLN 0060
CUIMANM 0064 00002000
CUIMPM 005B 02
CUINVCA 0056 80
CUINVCAS 0056
CUINVCA0 006A 80
CUINVCA1 006B 80
CUINVCD 0056 20
CUINVCD0 006A 20
CUINVCD1 006B 20
CUINVCS0 006A
CUINVCS1 006B
CUINVDM 0057 80
CUINVOP 0057 20
CUINVPE 0057 40
CUINVPOF 0056 10
CUINVSCO 0057
CUINVSM0 006A 10
CUINVSM1 006B 10
CUINVTM 0056 40
CUINVTM0 006A 40
CUINVTM1 006B 40
CUINXTCU 0000
CUIOFFL 0064 00000200
CUIOPRS 0064
CUIPAUS 0064 00004000
CUIPMIH 0066
CUIPOLL 0028
CUIPOLL1 0028 80
CUIPOLL2 0028 40
CUIRDEVS 0004
CUIRSRL 005B 04
CUISCAS 0054
CUISCAS0 0068
CUISCAS1 0069
CUISCMN0 0068 08
CUISCMN1 0069 08
CUISCNVS 006C 80
CUISCPF0 0068 10
CUISCPF1 0069 10
CUISCPOF 0054 10
CUISCTM 0054 40
CUISCTM0 0068 40
CUISCTM1 0069 40
CUISDCCO 0055
CUISFLG 0029
CUISFTY 0064 00000800
CUISFWRE 006E 80
CUISFWSU 006E 40
CUISIZE 00E0 0000001C
CUISMIH 0070
CUISNSS 006D 80
CUISPM 005B 01
CUISSCA 0054 80
CUISSCA0 0068 80
CUISSCA1 0069 80
CUISSCD 0054 20
CUISSCD0 0068 20
CUISSCD1 0069 20
CUISSDM 0055 80
CUISSFG 006D
CUISSID 002A
CUITLID 00CA
CUITOKND 0074
CUITSSID 002A
CUITTID 00BC
Last updated on 3 Aug 1999 at 11:49:11 EDT.
Copyright IBM Corporation, 1990, 1999