| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove TCP/IP Interface (RMVTCPIFC) command removes a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. The interface cannot be active when you submit this command -- it must be ended using the End TCP/IP Interface (ENDTCPIFC) or End TCP/IP (ENDTCP) commands.
An interface that is required for an existing route or remote system information (RSI) entry cannot be removed.
This command can be used to remove an interface that has been added with the Add TCP/IP Interface (ADDTCPIFC) command.
Restrictions:
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| INTNETADR | Internet address | Character value, *IP4DHCP, *IP6SAC | Optional, Positional 1 |
| ALIASNAME | Alias name | Simple name | Optional |
| LIND | Line description | Name, *ADRALIAS | Optional |
| Top |
Specifies the internet address of an interface that had previously been added to the TCP/IP configuration with the Add TCP/IP Interface (ADDTCPIFC) command.
Note: Either the INTNETADR or the ALIASNAME parameter must be specified for the command, but not both of them.
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 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 IPv6 internet address must be a unicast address and must not contain an imbedded IPv4 address (compatibility or mapped). If the IPv6 address is a link-local unicast address, a line description name must be specified for the LIND parameter.
If the internet address is entered from a command line, the address must be enclosed in apostrophes.
| Top |
Specifies the name of the interface to be removed. The alias name specified may be for an IPv4 or IPv6 interface.
Note: Either the INTNETADR or the ALIASNAME parameter must be specified for the command, but not both of them.
| Top |
Specifies the name of the line description associated with the interface being removed.
| Top |
Example 1: Removing a Token Ring Interface
RMVTCPIFC INTNETADR('9.5.11.125')
This command removes the interface associated with the internet address 9.5.11.125.
Example 2: Removing a Token Ring Interface using the Alias Name
RMVTCPIFC ALIASNAME(TEST_NETWORK)
This command removes the interface associated with the alias name TEST_NETWORK.
Example 3: Removing an Ethernet IPv6 Interface
RMVTCPIFC INTNETADR('1234:5678:9ABC:DEF0:1111:2222:3333:4444')
This command removes the IPv6 interface associated with address 1234:5678:9ABC:DEF0:1111:2222:3333:4444.
Example 4: Removing an Ethernet IPv6 Link-Local Interface
RMVTCPIFC INTNETADR('FE80::1234') LIND(ETHLINE)
This command removes the IPv6 link-local interface associated with address FE80::1234 and line description ETHLINE.
Example 5: Removing IPv6 Stateless Address Auto-Configuration On an Ethernet Line
RMVTCPIFC INTNETADR(*IP6SAC) LIND(ETHLINE2)
This command removes IPv6 stateless address auto-configuration for line ETHLINE2.
| Top |
*ESCAPE Messages
| Top |