Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

EQIBK

Prolog  

Control Block Contents  
   EQIBK DSECT

Storage Layout  

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

This information is based on z/VM V6R2.0. Last updated on 21 Nov 2011 at 11:35:53 EDT.
Copyright IBM Corporation, 1990, 2011