Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
EQIBK
Control Block Contents
EQIBK DSECT
Cross Reference (Contains links to field and bit definitions)
EQIBK Prolog
NAME : HCPEQIBK DESCRIPTION: Equivalency Identification Block DSECT : EQIBK LOCATED BY : RDEVEQBK CREATED BY : HCPEQIBB DELETED BY : HCPEQIDC RELOCATION CONSIDERATIONS : None
EQIBK Control Block Content
EQIBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure EQIBK Equivalency Identification Block 0000 0 Bitstring 40 EQIDUID Device-specific Universal Identifier 0028 40 Dbl-Word 8 EQIEQID User-specified Equivalency ID 0030 48 Dbl-Word 8 EQIHSHKY DUID Hash Key 0038 56 Bitstring 1 EQIFLAGS Flag Byte 1... .... EQIUSRID X'80' EQIUSRID User-defined EQID present .... ..1. EQIEQHSH X'02' EQIEQHSH EQID is in EQID hash table .... ...1 EQIDUHSH X'01' EQIDUHSH DUID is in EQID hash table 0039 57 Bitstring 1 EQIDTYPE DUID Type Value 00000001 EQITYPWW 1 EQITYPWW DUID Constructed from SCSI LUN IEEEID 00000000 EQITYPDE 0 EQITYPDE DUID Constructed from default method 003A 58 Bitstring 2 * Reserved for future IBM use 003C 60 Signed 4 EQIRDEV Host logical address of RDEV block 0040 64 Signed 4 EQIRDEVN Real Device Number for associated dev. 0044 68 Address 4 EQINEXTE Address of the hash key of the next EQIBK in the EQID collision list. 0048 72 Address 4 EQINEXTD Address of the hash key of the next EQIBK in the DUID collision list. 004C 76 Bitstring 16 * RESERVED FOR FUTURE IBM USE 00000001 EQIEQISD (L'EQIEQID+7)/8 Size of EQID in DWords 00000005 EQIDUISD (L'EQIDUID+7)/8 Size of DUID in DWords 00000033 EQIDUPSZ EQIDUPRN+(2*EQIDUNPR)+1 Size of a printable DUID + 1 char for end-of- data marker (X'FF') 00000007 EQIDUPSD ((EQIDUPSZ+7)/8) DWord size of print DUID 00000001 EQIHSHSD (L'EQIHSHKY+7)/8 DWord size of DUID hash key 0000000C EQIDSIZE (*-EQIBK+7)/8 size in double words 0000005C EQIBSIZE (*-EQIBK) size in bytes EQIDUID Redefinitions Note that EQIDUID is divided into two sections -- an area that is printable EBCDIC and an area that is non-printable. When adding new fields to EQIDUID: - Be sure to increase the length of EQIDUID - Be sure to place the new field in the appropriate section (printable or non-printable) 0000 0 Bitstring 6 EQIDUTYP Type number of attachable unit 0006 6 Bitstring 3 EQIDUMDL Model number of attachable unit 0009 9 Bitstring 3 EQIDUMAN Manufacturer of attachable unit 000C 12 Bitstring 2 EQIDUPLT Manufacturing plant of unit 000E 14 Bitstring 4 EQIDUXTR Unused bytes in this form of a DUID. Reserved by IBM for future usage. 0012 18 Bitstring 12 EQIDUSEQ Serial number of attachable unit 0000001E EQIDUPRN *-EQIDUID Length of printable DUID area 001E 30 Bitstring 2 EQIDUTAG Physical Interface ID of unit 0020 32 Bitstring 8 EQIDUUIT Unique Identifier Token 0000000A EQIDUNPR *-EQIDUTAG Length of non-printable DUID area 0000 0 Bitstring 24 EQIDUHCO Ignored in this scope 0018 24 Bitstring 8 EQIDUKEY Hash Key info for default DUID 0020 32 Bitstring 8 EQIDUHCE Ignored in this scope 0000 0 Bitstring 32 EQIDUWWI IEEEID in printable chars 0020 32 Bitstring 8 EQIDUWUI UIT for EDEV DUIDs
EQIBK Storage Layout
*** EQIBK - Equivalency Identification Block * * +-------------------------------------------------------+ * 0 | | * = EQIDUID = * | | * +-------------------------------------------------------+ * 28 | EQIEQID | * +-------------------------------------------------------+ * 30 | EQIHSHKY | * +------+------+-------------+---------------------------+ * 38 |:FLAGS|:DTYPE|/////////////| EQIRDEV | * +------+------+-------------+---------------------------+ * 40 | EQIRDEVN | EQINEXTE | * +---------------------------+---------------------------+ * 48 | EQINEXTD |///////////////////////////| * +---------------------------+///////////////////////////| * |///////////////////////////////////////////////////////| * |///////////////////////////+---------------------------+ * |///////////////////////////| 5C * +---------------------------+ * *** EQIBK - Equivalency Identification Block *** Overlay for EQIDUID in EQIBK * * +-----------------------------------------+-------------+ * 0 | EQIDUTYP | EQIDUMDL- | * +------+--------------------+-------------+-------------+ * 8 |-(006)| EQIDUMAN | EQIDUPLT | EQIDUXTR- | * +------+------+-------------+-------------+-------------+ * 10 | -(00E) | EQIDUSEQ | * +-------------+ +-------------+ * 18 | | EQIDUTAG | * +-----------------------------------------+-------------+ * 20 | EQIDUUIT | * +-------------------------------------------------------+ * 28 * *** Overlay for EQIDUID in EQIBK *** Overlay for EQIDUID in EQIBK * * +-------------------------------------------------------+ * 0 | | * = EQIDUHCO = * | | * +-------------------------------------------------------+ * 18 | EQIDUKEY | * +-------------------------------------------------------+ * 20 | EQIDUHCE | * +-------------------------------------------------------+ * 28 * *** Overlay for EQIDUID in EQIBK *** Overlay for EQIDUID in EQIBK * * +-------------------------------------------------------+ * 0 | | * = EQIDUWWI = * | | * +-------------------------------------------------------+ * 20 | EQIDUWUI | * +-------------------------------------------------------+ * 28 * *** Overlay for EQIDUID in EQIBK
EQIBK Cross Reference
Symbol Dspl Value -------------- ---- ----- EQIBSIZE 004C 0000005C EQIDSIZE 004C 0000000C EQIDTYPE 0039 EQIDUHCE 0020 EQIDUHCO 0000 EQIDUHSH 0038 01 EQIDUID 0000 EQIDUISD 004C 00000005 EQIDUKEY 0018 EQIDUMAN 0009 EQIDUMDL 0006 EQIDUNPR 0020 0000000A EQIDUPLT 000C EQIDUPRN 0012 0000001E EQIDUPSD 004C 00000007 EQIDUPSZ 004C 00000033 EQIDUSEQ 0012 EQIDUTAG 001E EQIDUTYP 0000 EQIDUUIT 0020 EQIDUWUI 0020 EQIDUWWI 0000 EQIDUXTR 000E EQIEQHSH 0038 02 EQIEQID 0028 EQIEQISD 004C 00000001 EQIFLAGS 0038 EQIHSHKY 0030 EQIHSHSD 004C 00000001 EQINEXTD 0048 EQINEXTE 0044 EQIRDEV 003C EQIRDEVN 0040 EQITYPDE 0039 00000000 EQITYPWW 0039 00000001 EQIUSRID 0038 80
Copyright IBM Corporation, 1990, 2011