Rename TCP/IP Host Table Entry (RNMTCPHTE)

The Rename TCP/IP Host Table Entry (RNMTCPHTE) command is used to rename an internet address in the local host table to another internet address. This has the effect of associating the host names for the old internet address with the new internet address. Host names and the text description field are not altered with the RNMTCPHTE command.

The local host table is defined to allow 1 internet address, 4 host names and 1 text description field per entry.

See also the following host table commands:

Add TCP/IP Host Table Entry (ADDTCPHTE) command adds a new entry in the local host table.
Change TCP/IP Host Table Entry (CHGTCPHTE) command changes one or more host names or the text description field.
Merge TCP/IP Host Table (MRGTCPHT) command merges host names, internet addresses, and text comment entries from a physical file member into the local host table. A replace option is also provided that allows the entire local host table to be replaced by the physical file member.
Remove TCP/IP Host Table Entry (RMVTCPHTE) command removes an entire entry from the local host table.

Restrictions:

You must have input/output system configuration (*IOSYSCFG) special authority to run this command.

Keyword	Description	Choices	Notes
INTNETADR	Internet address	Character value	Required, Positional 1
NEWINTNETA	New internet address	Character value	Required, Positional 2

Internet address (INTNETADR)

Specifies the internet address associated with the host name that you want to rename. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

New internet address (NEWINTNETA)

Specifies the new internet address that renames the existing internet address in the local host table. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

Examples

RNMTCPHTE   INTNETADR('132.28.71.5')  NEWINTNETA('142.48.81.6')

This command replaces the host table entry internet address of 132.28.71.5 with the internet address of 142.48.81.6. All host names and the text description field associated with the entry remain the same.

Error messages

*ESCAPE Messages

TCP1901: Internet address &1 not valid.
TCP1902: Internet address &1 not valid.
TCP1904: Duplicate internet address &1 found in host table.
TCP1907: Internet address entry &1 does not exist.
TCP1908: Internet address &1 not valid.
TCP1910: LOOPBACK internet address &1 not valid.
TCP1929: Host table not available.
TCP8050: *IOSYSCFG authority required to use &1.