Remove TCP/IP Interface (RMVTCPIFC)

The Remove TCP/IP Interface (RMVTCPIFC) command is used to remove a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. The interface cannot be active when you submit this command. The interface 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 interfaces that have been specified with the Add TCP/IP Interface (ADDTCPIFC) command.

Restrictions:

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

Keyword	Description	Choices	Notes
INTNETADR	Internet address	Character value	Optional, Positional 1
ALIASNAME	Alias name	Simple name	Optional

Internet address (INTNETADR)

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

Note: Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.

character-value: Specify the internet address associated with the interface to be removed.

Alias name (ALIASNAME)

Specifies the name of an interface that had previously been added to the TCP/IP configuration with the Add TCP/IP Interface (ADDTCPIFC) command. The alias name specified must be for an IPv4 interface. If the alias name is for an IPv6 interface, an error message will be returned.

Note: Either the INTNETADR or the ALIASNAME parameter should be specified for the command, but not both of them.

simple-name: Specify the name associated with the interface to be removed.

Examples

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.

Error messages

*ESCAPE Messages

TCP1D03: &1 member record length not correct.
TCP1D04: Error occurred processing member &1 of &2/&3.
TCP1901: Internet address &1 not valid.
TCP8050: *IOSYSCFG authority required to use &1.
TCP9999: Internal system error in program &1.