Remove ARP Table Entry (QtocRmvARPTblE) API

  Required Parameter Group:

1 Line name Input Char(10)
2 Internet address Input Binary(4)
3 Entry type Input Char(10)
4 Error code I/O Char(*)

  Service Program: QTOCNETSTS

  Threadsafe: Yes

The Remove ARP Table Entry (QtocRmvARPTblE) API removes one or all dynamic entries from the ARP (Address Resolution Protocol) table for the specified line. Local interface entries cannot be removed.

TCP/IP must be active on this system; otherwise, error message TCP84C0 is issued.


Authorities and Locks

Special Authority
*IOSYSCFG

Required Parameter Group

Line name
INPUT; CHAR(10)

The name of the physical interface corresponding to the ARP table from which to remove entries.

Internet address
INPUT; BINARY(4)

The IP address of the entry to remove from the ARP table. This must be 0 when trying to remove all dynamic ARP entries.

Entry type
INPUT; CHAR(10)

Whether a single entry or all entries are removed from the ARP table. The possible types are:

*IPADDR The Internet address field corresponds to a single entry to be removed.
*ALL The Internet address field must be 0 and all ARP table entries will be removed.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.


Error Messages

Message ID Error Message Text
TCP84C0 E TCP/IP stack not active.
TCP84C1 E The specified Internet address was not found in the ARP table.
TCP84C2 E ARP entry is local and cannot be deleted.
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.
TCP84C6 E Internal operations error.
TCP84C8 E ARP API parameter not valid.
CPF24B4 E Severe error while addressing parameter list.
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.
CPF9872 E Program or service program &1 in library &2 ended. Reason code &3.


API introduced: V5R1

[ Back to top | Communications APIs | APIs by category ]