RNMTCPHTE (Rename TCP/IP Host Table Entry)

RNMTCPHTE Command syntax diagram

 

Purpose

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.

Restriction: You must have *IOSYSCFG special authority to use this command.

 

Required Parameters

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.

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.

Example for RNMTCPHTE

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 for RNMTCPHTE

*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.