Rename TCP/IP Host Table Entry (RNMTCPHTE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Rename TCP/IP Host Table Entry (RNMTCPHTE) command is used to rename a host table entry in the local host table. This is done by assigning a new internet address to an existing host table entry. 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, 65 host names and 1 text description field per entry.
The RNMTCPHTE command performs the rename of the host table entry by removing the existing host table entry and then adding a new host table entry at the end of the table that contains the new internet address.
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.
- Copy TCP/IP Host Table (CPYTCPHT) command copies the contents of the local host table to a physical file member.
- 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.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| INTNETADR | Internet address | Character value | Required, Positional 1 |
| NEWINTNETA | New internet address | Character value | Required, Positional 2 |
| Top |
Internet address (INTNETADR)
Specifies the internet address associated with the host table entry that you want to rename. An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 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.
An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
An IPv4-mapped IPv6 address may be specified. An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.
If the internet address is entered from a command line, the address must be enclosed in apostrophes.
This is a required parameter.
- character-value
- Specify the current internet address.
| Top |
New internet address (NEWINTNETA)
Specifies the new internet address for the host table entry. An IPv4 internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An IPv4 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.
An IPv6 internet address is specified in the form x:x:x:x:x:x:x:x, where x is a hexadecimal number ranging from 0 through X'FFFF'. "::" may be used once in the IPv6 address to indicate one or more groups of 16 bits of zeros. The "::" may be used to compress leading, imbedded, or trailing zeros in the address.
An IPv4-mapped IPv6 address may be specified. An IPv4-mapped IPv6 address is specified in the form ::FFFF:nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255.
If the internet address is entered from a command line, the address must be enclosed in apostrophes.
This is a required parameter.
- character-value
- Specify the new internet address.
| Top |
Examples
Example 1: Renaming a Host Table Entry Containing an IPv4 Address
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.
Example 2: Renaming a Host Table Entry Containing an IPv6 Address
RNMTCPHTE INTNETADR('1234::5678') NEWINTNETA('5678::1234')
This command replaces the host table entry internet address of 1234::5678 with the internet address of 5678::1234. All host names and the text description field associated with the entry remain the same.
Example 3: Renaming an Host Table Entry Containing an IPv4 Address
RNMTCPHTE INTNETADR('132.28.71.5') NEWINTNETA('5678::1234')
This command replaces the host table entry internet address of 132.28.71.5 with the internet address of 5678::1234. All host names and the text description field associated with the entry remain the same. It is also possible to rename a host table entry that contains an IPv6 address and specify an IPv4 address as the new internet address.
| Top |
Error messages
*ESCAPE Messages
- TCP1901
- Internet address &2 not valid.
- TCP1902
- Internet address &1 not valid.
- TCP1904
- Duplicate internet address &2 found in host table.
- TCP1907
- Internet address entry &1 does not exist.
- TCP1908
- Internet address &1 not valid.
- TCP1910
- LOOPBACK internet address &2 not valid.
- TCP1929
- Host table not available.
- TCP8050
- *IOSYSCFG authority required to use &1.
| Top |