Remove TCP/IP Interface (RMVTCPIFC)

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

Parameters

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

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.

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

*IP4DHCP
Specify that Dynamic Host Configuration Protocol shoud be removed for the associated line description. A line description name must be specified for the LIND parameter.
*IP6SAC
Specify that IPv6 stateless address auto-configuration should be removed for the associated line description. A line description name must be specified for the LIND parameter.
character-value
Specify the internet address associated with the interface to be removed.

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

Alias name (ALIASNAME)

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.

simple-name
Specify the name of the interface to be removed.
Top

Line description (LIND)

Specifies the name of the line description associated with the interface being removed.

*ADRALIAS
The line description is determined from either the INTNETADR value or the ALIASNAME value.
name
Specify the name of the line description associated with the interface being removed. The line description must be specified if the INTNETADR value is *IP4DHCP, *IP6SAC, or an IPv6 link-local unicast address.
Top

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.

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

Error messages

*ESCAPE Messages

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