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

#### NEDBK

Prolog

Control Block Contents
NEDBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### NEDBK Prolog

     NAME       : HCPNEDBK
     DESCRIPTION: Node Element Descriptor Block
     DSECT      : NEDBK
     FUNCTION   : Describes the Contents of a Node Element
                  Desciptor.
     LOCATED BY : CUITOKND - Pointer to the Token NED in an I/O
                  Subsystem.  Other NEDs are linked using
                  the Boeblingen Building Block N-ary Tree
                  Structure.
     CREATED BY : HCPCDT - Configuration Data Table Services
     DELETED BY : None.
     SERIALIZED : This block will be serialized by the RDEV lock.
     COMMENTS   : Data map is hand drawn.

#### NEDBK Control Block Content

#### NEDBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      NEDBK          Node Element Descriptor Block
    0000    0 Bitstring   32 NEDDATA (0)    Node Element Data
    0000    0 Bitstring    1 NEDFLAGS       Flags.
              111. ....      NEDFNVAL       X'E0' NEDFNVAL Node-ID Validity.
                                            Describes the validity of the
                                            node ID in bytes 4-31.
              11.. ....      NEDFLDID       X'C0' NEDFLDID Field id = '11'b
              ..1. ....      NEDTOKEN       X'20' NEDTOKEN Token NED
                                            Indicator. If ON, the node
                                            described by this Node Element
                                            Descriptor (NED) is a Token NED.
              ...1 ....      NEDFTYP        X'10' NEDFTYP Node Type. If ON,
                                            the node described by this Node
                                            Element Descriptor (NED) is a
                                            Central Processing Complex (CPC)
                                            type node. If OFF, the node
                                            described by this NED is a Device
                                            Type node.
              .... 1...      NEDFINFT       X'08' NEDFINFT Interface Type. If
                                            ON, the attachable unit interface
                                            that determines this node is an
                                            internal interface. If OFF, the
                                            attachable unit interface that
                                            determines this node is an
                                            external interface.
              .... .1..      NEDFINFQ       X'04' NEDFINFQ Interface
                                            Qualifier. When (NEDFTYP = '1'B)
                                            & (NEDFINFT = '0'B) & (NEDFINFQ =
                                            '0'B) THEN the channel path
                                            interface has an associated
                                            CHPID. When (NEDFTYP = '1'B) &
                                            (NEDFINFT = '0'B) & (NEDFINFQ =
                                            '1'B) THEN the channel path
                                            interface has NO associated
                                            CHPID. For all other settings of
                                            flag bits 3 and 4, a zero in flag
                                            bit 5 has no meaning.
              .... ..1.      NEDFINVA       X'02' NEDFINVA Node ID is not
                                            valid. The CPC is not
              .... ...1      NEDFNCUR       X'01' NEDFNCUR Node ID is valid,
                                            but may not be current.
              .... ....      NEDFVALN       X'00' NEDFVALN Node ID is valid.
                                            able to obtain the requested node
                                            ID.
    0001    1 Bitstring    3 NEDNPARM       Node Parameters.
    0004    4 Bitstring    6 NEDTYPEN       TYPE NUMBER contains the EBCDIC
                                            type number (0-9) of the
                                            attachable unit.
    000A   10 Bitstring    3 NEDMODN        Model Number contains the EBCDIC
                                            model number (0-9 or upper case
                                            A-Z) of the attachable unit.
    000D   13 Bitstring    3 NEDMANUF       Manufacturer contains EBCDIC code
                                            (0-9 or upper-case A-Z) which
                                            identifies the manufacturer of
                                            the attachable unit e.g. "IBM".
    0010   16 Bitstring    2 NEDPMANF       Plant of Manufacture contains
                                            EBCDIC code (0-9 or upper-case
                                            A-Z) which identifies the plant
                                            of manufacture for the attach-
                                            able unit.
    0012   18 Bitstring   12 NEDSEQN (0)    Sequence Number.
    0012   18 Bitstring    7 NEDSEQN1       Sequence Number contains the
                                            EBCDIC code (0-9 or upper-case
                                            A-Z) which identifies the first 7
                                            chars of the sequence number of
                                            the attachable unit.
    0019   25 Bitstring    5 NEDSEQN2       Sequence Number contains the
                                            EBCDIC code (0-9 or upper-case
                                            A-Z) which identifies the last 5
                                            chars of the sequence number of
                                            the attachable unit.
    001E   30 Bitstring    2 NEDTAG         Tag contains physical identifier
                                            for an interface of the
                                            attachable unit.
    0020   32 Address      4 NEDSCPDT       NED Scope Function data which is
                                            used during the CDT Scope
                                            Function. Depending on the type
                                            of NED this block is used for,
                                            this filed will contain different
                                            data. If DNED, this field holds
                                            the RDEV address Otherwise, this
                                            field holds the CHPID list
                                            address.
                  Field Redefinitions
    0001    1 Bitstring    1 NEDTYPE        Type of NED
              00000001       NEDDEVND       X'01' NEDDEVND I/O device NED
              00000002       NEDCUNED       X'02' NEDCUNED Storage Control
                                            NED
    0002    2 Bitstring    1 * (2)          Reserved for future IBM use.
    0001    1 Bitstring    1 * (2)          Reserved for future IBM use.
    0003    3 Bitstring    1 NEDCHPID       Channel Path ID.
            Node parameter definition for a SWITCH Node
            Descriptor obtained from a Store Event Info
            CHSC after a link incident CRW was stored.
    0001    1 Bitstring    1 *              Reserved for future IBM use.
    0002    2 Bitstring    1 NEDCLASS       I/O Device Class
              .... 1.1.      NEDSWICH       X'0A' NEDSWICH Switch
    0003    3 Bitstring    1 NEDLINKA       Link Address
    0020   32 Address      4 NEDRDEV        RDEV address if Device NED
    0020   32 Address      4 NEDCHPTR       Otherwise, CHPID list pointer
    0024   36 Address      4 NEDMPPTR       Pointer to a BBLX linked list of
                                            multiparent NEDBK addresses.
                Mappings for NEDTAG
          For a Volume NED
    001E   30 Bitstring    1 NEDLCU         ESCON Logical CU number.
    001F   31 Bitstring    1 NEDUA          Unit address of the Volume.
              00000005       NEDSIZE        (*-NEDBK+7)/8 Size of NEDBK in
                                            doublewords.
              00000028       NEDLEN         (*-NEDBK) Size of NEDBK in bytes.

#### NEDBK Storage Layout

    *** NEDBK - Node Element Descriptor Block
    *
    *     +------+--------------------+---------------------------+
    *   0 |:FLAGS|     NEDNPARM       |        NEDTYPEN-          |
    *     +------+------+-------------+------+--------------------+
    *   8 |   -(004)    |      NEDMODN       |     NEDMANUF       |
    *     +-------------+--------------------+--------------------+
    *  10 |  NEDPMANF   |               NEDSEQN1-                 |
    *     +------+------+---------------------------+-------------+
    *  18 |-(012)|            NEDSEQN2              |   NEDTAG    |
    *     +------+--------------------+-------------+-------------+
    *  20 |         NEDSCPDT          |///////////////////////////|
    *     +---------------------------+---------------------------+
    *  28
    *
    *** NEDBK - Node Element Descriptor Block

    *** Overlay for NEDNPARM in NEDBK
    *
    *            +------+-------------+
    *   0 ..   1 |:TYPE |/////////////| 4
    *            +------+-------------+
    *
    *** Overlay for NEDNPARM in NEDBK

    *** Overlay for NEDNPARM in NEDBK
    *
    *            +-------------+------+
    *   0 ..   1 |/////////////|:CHPID| 4
    *            +-------------+------+
    *
    *** Overlay for NEDNPARM in NEDBK

    *** Overlay for NEDNPARM in NEDBK
    *
    *            +------+------+------+
    *   0 ..   1 |//////|:CLASS|:LINKA| 4
    *            +------+------+------+
    *
    *** Overlay for NEDNPARM in NEDBK

    *** Overlay for NEDSCPDT in NEDBK
    *
    *     +---------------------------+
    *  20 |         NEDRDEV           | 24
    *     +---------------------------+
    *
    *** Overlay for NEDSCPDT in NEDBK

    *** Overlay for NEDSCPDT in NEDBK
    *
    *     +---------------------------+---------------------------+
    *  20 |         NEDCHPTR          |         NEDMPPTR          |
    *     +---------------------------+---------------------------+
    *  28
    *
    *** Overlay for NEDSCPDT in NEDBK

    *** Overlay for NEDTAG in NEDBK
    *
    *                                               +------+------+
    *  18 ...                                    1E |NEDLCU|NEDUA |
    *                                               +------+------+
    *  20
    *
    *** Overlay for NEDTAG in NEDBK

#### NEDBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    NEDCHPID       0003
    NEDCHPTR       0020
    NEDCLASS       0002
    NEDCUNED       0001 00000002
    NEDDATA        0000
    NEDDEVND       0001 00000001
    NEDFINFQ       0000 04
    NEDFINFT       0000 08
    NEDFINVA       0000 02
    NEDFLAGS       0000
    NEDFLDID       0000 C0
    NEDFNCUR       0000 01
    NEDFNVAL       0000 E0
    NEDFTYP        0000 10
    NEDFVALN       0000 00
    NEDLCU         001E
    NEDLEN         001F 00000028
    NEDLINKA       0003
    NEDMANUF       000D
    NEDMODN        000A
    NEDMPPTR       0024
    NEDNPARM       0001
    NEDPMANF       0010
    NEDRDEV        0020
    NEDSCPDT       0020
    NEDSEQN        0012
    NEDSEQN1       0012
    NEDSEQN2       0019
    NEDSIZE        001F 00000005
    NEDSWICH       0002 0A
    NEDTAG         001E
    NEDTOKEN       0000 20
    NEDTYPE        0001
    NEDTYPEN       0004
    NEDUA          001F

This information is based on z/VM V6R1.0. Last updated on 18 Feb 2010 at 08:52:04 EDT.
Copyright IBM Corporation, 1990, 2008