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

Prolog  

Control Block Contents  

CUIBK DSECT

Storage Layout  

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


This information is based on VM/ESA 2.4.0.
Last updated on 3 Aug 1999 at 11:49:11 EDT.
Copyright IBM Corporation, 1990, 1999