Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
NEDBK
Control Block Contents
NEDBK DSECT
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. RELOCATION CONSIDERATIONS : None 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
Copyright IBM Corporation, 1990, 2011