EQIBK | Back to Index page

| Prolog Control Block Contents EQIBK DSECT Storage Layout Cross Reference (Contains links to field and bit definitions) |
Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

EQIBK Prolog | Top of page

     NAME       : HCPEQIBK
     DESCRIPTION: Equivalency Identification Block
     DSECT      : EQIBK
     LOCATED BY : RDEVEQBK
     CREATED BY : HCPEQIBB
     DELETED BY : HCPEQIDC
     RELOCATION CONSIDERATIONS : None

EQIBK Control Block Content | Top of page

     EQIBK DSECT
    Top of page

    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
                                            Type1 SCSI 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
    0000    0 Bitstring    8 EQIVEND        Vendor ID
    0008    8 Bitstring   16 EQIPROD        Product ID
    0018   24 Bitstring    8 EQISERNO       Serial Number
    0020   32 Bitstring    8 EQIDUWUI       UIT for EDEV DUIDs
              ...1 1...      EQIVPLEN       L'EQIVEND+L'EQIPROD EQIVPLEN Len
                                            of Vendor & Prod ID's

EQIBK Storage Layout | Top of page

    *** 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
    *
    *** Overlay for EQIDUID in EQIBK

    *** Overlay for EQIDUWWI in EQIBK
    *
    *     +-------------------------------------------------------+
    *   0 |                       EQIVEND                         |
    *     +-------------------------------------------------------+
    *   8 |                       EQIPROD                         |
    *     |                                                       |
    *     +-------------------------------------------------------+
    *  18 |                       EQISERNO                        |
    *     +-------------------------------------------------------+
    *  20 |                       EQIDUWUI                        |
    *     +-------------------------------------------------------+
    *  28
    *
    *** Overlay for EQIDUWWI in EQIBK

EQIBK Cross Reference | Top of page

    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
    EQIPROD        0008
    EQIRDEV        003C
    EQIRDEVN       0040
    EQISERNO       0018
    EQITYPDE       0039 00000000
    EQITYPWW       0039 00000001
    EQIUSRID       0038 80
    EQIVEND        0000
    EQIVPLEN       0020 18

This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:32:19 EDT.
Copyright IBM Corporation, 1990, 2020