| 1 | Qualified user space name | Input | Char(20) |
| 2 | Format name | Input | Char(8) |
| 3 | Line name | Input | Char(10) |
| 4 | Error Code | I/O | Char(*) |
The List Physical Interface ARP Table (QtocLstPhyIfcARPTbl) API returns a list of all entries in the ARP (Address Resolution Protocol) table for the specified line.
TCP/IP must be active on this system; otherwise, error message TCP84C0 will be issued.
The user space that receives the information, and the library in which it is located. The first 10 characters contain the user space name, and the second 10 characters contain the library name. You can use these special values for the library name:
| *CURLIB | The job's current library. |
| *LIBL | The library list. |
The format of the space information to be returned. The format names supported are:
The name of the physical interface to retrieve ARP table entries for.
The structure in which to return error information. For the format of the structure, see Error code parameter.
To request a list of ARP table entries for an interface, use format ARPT0100.
The ARP table list consists of:
For details about the user area and generic header, see User spaces. For details about the remaining items, see the following sections.
When you retrieve list entry information from a user space, you must use the entry size returned in the generic header. The size of each entry may be padded at the end. If you do not use the entry size, the result may not be valid. For examples of how to process lists, see Examples: APIs and exit programs.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | User space name specified |
| 10 | A | CHAR(10) | User space library name specified |
| 20 | 14 | CHAR(8) | Format name specified |
| 28 | 1C | CHAR(10) | Line name specified |
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | User space name |
| 10 | A | CHAR(10) | User space library name used |
| 20 | 14 | CHAR(10) | Line name used |
The following information about an ARP table entry is returned for the ARPT0100 format. For detailed descriptions of the fields in the table, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(15) | Internet address |
| 15 | F | CHAR(1) | Reserved |
| 16 | 10 | BINARY(4) | Internet address binary |
| 20 | 14 | BINARY(4) | Line type |
| 24 | 18 | BINARY(4) | Ethernet type |
| 28 | 1C | BINARY(4) | Type of entry |
| 32 | 20 | BINARY(4) | Data link connection identifier (DLCI) |
| 36 | 24 | BINARY(4) | Routing information field (RIF) valid mask |
| 40 | 28 | CHAR(18) | Routing information field (RIF) |
| 58 | 3A | CHAR(17) | Physical address |
| 75 | 4B | CHAR(1) | Reserved |
Data link connection identifier (DLCI). This field identifies a logical connection on a single physical Frame Relay link. Each logical connection has a unique integer identifying it. Valid values range from 1 to 255, and this field is only valid when the line type field corresponds to Frame Relay.
Ethernet type. The type of Ethernet framing in use. ONLY valid if the interface is using an ELAN (Ethernet) or WLS (Wireless) line.
| -1 | Both Ethernet Version 2 and IEEE 802.3 framing (only set for local or proxy entries) |
| 1 | Ethernet Version 2 |
| 6 | IEEE 802.3 |
Internet address. The IP address of the interface in dotted-decimal notation.
Internet address binary. The binary representation of the IP address.
Line type. The type of physical line used by an interface. The possible values are:
| 1 | ELAN - Ethernet local area network protocol. |
| 2 | TRLAN - Token-ring local area network protocol. |
| 3 | FR - Frame relay network protocol. |
| 6 | WLS - Wireless local area network protocol. |
| 8 | DDI - Distributed Data Interface protocol. |
Physical address. The MAC address of the interface. Format: XX:XX:XX:XX:XX:XX, where 'X' is a hexadecimal digit.
Reserved. An ignored field.
Routing information field (RIF). The architected token-ring or FDDI source routing information. Use the RIF Valid Mask field to determine the validity of this field.
Routing information field (RIF) valid mask. Tells whether the RIF is valid for this ARP entry or not. The possible values are:
| 0 | The RIF is not valid. |
| 1 | The RIF is valid. |
Type of entry. The type of ARP table entry. The possible values are:
| 1 | Dynamic - A normal ARP table entry which will be removed automatically after a period of inactivity. |
| 2 | Local - This interface is local to this host. Static entry. |
| 3 | Proxy - This interface is proxying ARP requests/replies for other machines. Static entry. |
| TCP84C0 E | TCP/IP stack not active. |
| TCP84C3 E | The specified line name does not exist. |
| TCP84C4 E | The specified line name corresponds to a line type that does not support ARP. |
| TCP84C5 E | API error providing TCP/IP Network Status information. |
| TCP84C6 E | Internal operations error - RESULT &1 CC &2 RC &3 ERRNO &4. |
| TCP84C9 I | Information returned incomplete. |
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C21 E | Format name &1 is not valid. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF8100 E | All CPF81xx messages could be returned. xx is from 01 to FF. |
| CPF9801 E | Object &2 in library &3 not found. |
| CPF9802 E | Not authorized to object &2 in &3. |
| CPF9803 E | Cannot allocate object &2 in library &3. |
| CPF9807 E | One or more libraries in library list deleted. |
| CPF9808 E | Cannot allocate one or more libraries on library list. |
| CPF9810 E | Library &1 not found. |
| CPF9820 E | Not authorized to use library &1. |
| CPF9830 E | Cannot assign library &1. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
API introduced: V5R1