Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
IPNBK
Control Block Contents
IPNBK DSECT
Cross Reference (Contains links to field and bit definitions)
IPNBK Prolog
NAME : HCPIPNBK DESCRIPTION: IP Node block DSECT : IPNBK FUNCTION : The IPNBK structure defines a relationship between a specific IP Address and a specific network device (represented by a NIDBK). When a device is subscribed to an IP Address, the IPNBK can be found by looking up the IP Address in the LAN IP Table or by following the subscription chain anchored within the NIDBK (NIDIPNHD). LOCATED BY - LANIPTBL - LAN IP Table structure. NIDIPTBL - Device IP Table structure. LANBCTBL - LAN Broadcast Table NIDBCTBL - Device Broadcast IPNBK entries LANMCTBL - LAN Multicast Router Table NIDMCTBL - Device Router IPNBK entries CREATED BY : IP Address functions in module HCPIPN. DELETED BY : IP Address functions in module HCPIPN.
IPNBK Control Block Content
IPNBK DSECT
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure IPNBK IP Node block IP Table Node (for an IP Unicast/Multicast entry). 0000 0 Character 1 IPNTYPE IPNBK Type 000000E4 IPNTYPUC C'U' Unicast IPNBK 000000D4 IPNTYPMC C'M' Multicast IPNBK 000000C2 IPNTYPBC C'B' Broadcast IPNBK 000000D9 IPNTYPRX C'R' Router IPNBK IPNPROTO represents the IP Protocol (see HCPIPABK IPAIPVER) 0001 1 Bitstring 1 IPNPROTO IPNBK Protocol (IPv4/IPv6) 00000004 IPNIPV4 4 IPv4 Protocol 00000006 IPNIPV6 6 IPv6 Protocol IPNARPFL represents SETIP Flag byte 3 (see HCPIPABK). Notes : IPABK defines IPAIPARP as 0 but the IP Assist document indicates x'01'. In practice, this is the default so it does not matter. I am using a value of x'01' because it seems more consistent with the general structure of the IP Assists. 0002 2 Bitstring 1 IPNARPFL SETIP Flag byte 3 (ARP flags) .... ...1 IPNARPRQ B'00000001' ARP this request (normal) .... ..1. IPNNARP B'00000010' DO NOT ARP this req (takeover) .... .1.. IPNNFAIL B'00000100' DO NOT FAIL a matching ARP req 0003 3 Bitstring 1 IPNFLAGS IPNBK Flags 1... .... IPNDEACT X'80' DEACTIVATED from LAN IP Table .1.. .... IPNLOCAL X'40' LOCAL to this LAN Segment ..1. .... IPNREMOT X'20' Remote (soft) IP Entry ...1 .... IPNPROXY X'10' Set by ARP Add Address Entry .... 1... IPNINUSE X'08' Indicate recent activity 0004 4 Address 4 IPNLINK Pointer to associated device Linkage for Device IP Table chain. 0008 8 Address 4 IPNFPNT Pointer to next Device IPNBK 000C 12 Address 4 IPNBPNT Pointer to previous Device IPNBK Linkage for LANBK IP Table chain. 0010 16 Address 4 IPNXFPNT Pointer to next LAN IPNBK 0014 20 Address 4 IPNXBPNT Pointer to previous LAN IPNBK IP Node Identification. 0018 24 Bitstring 16 IPNXID Space for IP Node Identification Common fields. 0028 40 Bitstring 2 IPNMSKNN Netmask bits 002A 42 Bitstring 6 IPNMACAD MACADDR registered 0030 48 Bitstring 2 IPNOSID OSID value 0032 50 Bitstring 2 IPNVLAN Current VLAN ID 0034 52 Bitstring 4 * Reserved 0038 56 Bitstring 8 IPNTOD TOD Clock created/refreshed End of the IPNBK. 0040 64 Dbl-Word 8 IPN$END (0) End of the IPNBK structure 00000040 IPNBKLN *-IPNBK Length of IPNBK in bytes 00000008 IPNBKSZ (*-IPNBK+7)/8 Size of IPNBK in doublewords IP Multicast Address (IPM) indicator. When the IP Address byte 0 is in the range of 224-239 (x'E0'-x'EF') it designates an IP Multicast address. To determine if an IP Address is an IPM Address: (1) TM byte0,IPNMCON; If cc<3 it is NOT an IPM (2) TM byte0,IPNMCOFF; If cc>0 it is NOT an IPM The address must pass BOTH tests to be accepted as a Multicast IP Address. 1111 .... IPNMCMSK X'F0' IPM Byte 0 - Significant bits 111. .... IPNMCON X'E0' IPM Byte 0 - These bits are ON ...1 .... IPNMCOFF X'10' IPM Byte 0 - These bits are OFF Redefine IPNXID for a generic IP Address (right-justified). 0018 24 Bitstring 16 IPNADDR Generic IP Address (128 bits) Redefine IPNXID for an IPv4 IP Address. 0018 24 Bitstring 12 IPNIPXV4 IPv4 (unused bits) 0024 36 Bitstring 4 IPNIPAV4 IPv4 Address (32 bits) Redefine IPNXID for an IPv6 IP Address. 0018 24 Bitstring 16 IPNIPAV6 IPv6 Address (128 bits) Redefine IPNXID for a Broadcast/Routing device entry. 0018 24 Character 8 IPNXUSER Userid of device owner 0020 32 Bitstring 2 IPNXDVNO Binary (16-bit) vdev address 0022 34 Bitstring 6 * Unused
IPNBK Storage Layout
*** IPNBK - IP Node block * * +------+------+------+------+---------------------------+ * 0 |:TYPE |:PROTO|:ARPFL|:FLAGS| IPNLINK | * +------+------+------+------+---------------------------+ * 8 | IPNFPNT | IPNBPNT | * +---------------------------+---------------------------+ * 10 | IPNXFPNT | IPNXBPNT | * +---------------------------+---------------------------+ * 18 | IPNXID | * | | * +-------------+-----------------------------------------+ * 28 | IPNMSKNN | IPNMACAD | * +-------------+-------------+---------------------------+ * 30 | IPNOSID | IPNVLAN |///////////////////////////| * +-------------+-------------+---------------------------+ * 38 | IPNTOD | * +-------------------------------------------------------+ * *** IPNBK - IP Node block *** Overlay for IPNXID in IPNBK * * +-------------------------------------------------------+ * 18 | IPNADDR | * | | * +-------------------------------------------------------+ * 28 * *** Overlay for IPNXID in IPNBK *** Overlay for IPNXID in IPNBK * * +-------------------------------------------------------+ * 18 | IPNIPXV4 | * | +---------------------------+ * 20 | | IPNIPAV4 | * +---------------------------+---------------------------+ * 28 * *** Overlay for IPNXID in IPNBK *** Overlay for IPNXID in IPNBK * * +-------------------------------------------------------+ * 18 | IPNIPAV6 | * | | * +-------------------------------------------------------+ * 28 * *** Overlay for IPNXID in IPNBK *** Overlay for IPNXID in IPNBK * * +-------------------------------------------------------+ * 18 | IPNXUSER | * +-------------+-----------------------------------------+ * 20 | IPNXDVNO |/////////////////////////////////////////| * +-------------+-----------------------------------------+ * 28 * *** Overlay for IPNXID in IPNBK
IPNBK Cross Reference
Symbol Dspl Value -------------- ---- ----- IPN$END 0040 IPNADDR 0018 IPNARPFL 0002 IPNARPRQ 0002 01 IPNBKLN 0040 00000040 IPNBKSZ 0040 00000008 IPNBPNT 000C IPNDEACT 0003 80 IPNFLAGS 0003 IPNFPNT 0008 IPNINUSE 0003 08 IPNIPAV4 0024 IPNIPAV6 0018 IPNIPV4 0001 00000004 IPNIPV6 0001 00000006 IPNIPXV4 0018 IPNLINK 0004 IPNLOCAL 0003 40 IPNMACAD 002A IPNMCMSK 0040 F0 IPNMCOFF 0040 10 IPNMCON 0040 E0 IPNMSKNN 0028 IPNNARP 0002 02 IPNNFAIL 0002 04 IPNOSID 0030 IPNPROTO 0001 IPNPROXY 0003 10 IPNREMOT 0003 20 IPNTOD 0038 IPNTYPBC 0000 000000C2 IPNTYPE 0000 IPNTYPMC 0000 000000D4 IPNTYPRX 0000 000000D9 IPNTYPUC 0000 000000E4 IPNVLAN 0032 IPNXBPNT 0014 IPNXDVNO 0020 IPNXFPNT 0010 IPNXID 0018 IPNXUSER 0018
Copyright IBM Corporation, 1990, 2003