End TCP/IP Interface (ENDTCPIFC)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The End TCP/IP Interface (ENDTCPIFC) command ends a Transmission Control Protocol/Internet Protocol (TCP/IP) interface. When an interface is ended with this command, datagrams addressed to the IP addresses associated with this interface will no longer be accepted. However, the operation of any other TCP/IP or IP over SNA interface that is using the same line description as the the interface being ended is not affected.

This command can be used to end an interface that was previously started by the Start TCP/IP Interface (STRTCPIFC) or Start TCP/IP (STRTCP) command.

Notes on Route to Interface Binding

Interfaces define direct routes to networks or subnetworks that this system is directly attached to. Routes define the indirect routes. An indirect route defines the next hop on the path to a network or subnetwork that this system is not directly attached to.

Indirect routes are bound to interfaces using a best match first algorithm. This algorithm is based on the state of the interface and on the type of service (TOS) specified for the route and interface. When ending an interface, the routes associated with the interface can move to another existing active interface. This provides the widest available level of connectivity.

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 and which had been previously started by the STRTCPIFC or STRTCP 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 should end 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 end for the associated line description. All auto-configured IPv6 interfaces will end. A line description name must be specified for the LIND parameter.
character-value
Specify the internet address associated with the interface to be ended.

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

Line description (LIND)

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

*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 ended. The line description must be specified if the INTNETADR value is *IP4DHCP, *IP6SAC, or an IPv6 link-local unicast address.
Top

Examples

Example 1: Ending an X.25 Interface

ENDTCPIFC   INTNETADR('9.5.11.125')

This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the internet address 9.5.11.125.

Example 2: Ending a Token-Ring Interface

ENDTCPIFC   INTNETADR('156.93.81.7')

This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the internet address 156.93.81.7.

Example 3: Ending a Token-Ring Interface using an Alias Name

ENDTCPIFC   ALIASNAME(TEST_NETWORK)

This command causes the TCP/IP protocol stack to deactivate (end) the interface associated with the alias name TEST_NETWORK.

Example 4: Ending an Ethernet IPv6 Interface

ENDTCPIFC   INTNETADR('1234:5678:9ABC:DEF0:1111:2222:3333:4444')

This command causes the TCP/IP protocol stack to end the IPv6 interface associated with address 1234:5678:9ABC:DEF0:1111:2222:3333:4444.

Example 5: Ending an Ethernet IPv6 Link-Local Interface

ENDTCPIFC   INTNETADR('FE80::1234') LIND(ETHLINE)

This command causes the TCP/IP protocol stack to end the IPv6 link-local interface associated with address FE80::1234 and line description ETHLINE.

Example 6: Ending IPv6 Stateless Address Auto-Configuration On an Ethernet Line

ENDTCPIFC   INTNETADR(*IP6SAC) LIND(ETHLINE2)

This command causes the TCP/IP protocol stack to end IPv6 stateless address auto-configuration for line ETHLINE2.

Top

Error messages

*ESCAPE Messages

TCP1B15
Line description &2 unusable. Internal errors encountered.
TCP1B61
Unable to determine if &1 interface ended.
TCP1B62
Cannot determine if &1 interface ended.
TCP1B65
&2 interface not ended. Reason &1.
TCP1B71
&1 interface not ended.
TCP1B72
&1 interface not ended. &1 interface is not active.
TCP1B73
&1 interface not ended. &1 interface not defined in the TCP/IP configuration.
TCP1B74
&1 interface not ended. Line description &2 not found.
TCP1B85
Unable to submit request to end interface &1.
TCP265F
INTNETADR parameter value &2 not valid.
TCP9999
Internal system error in program &1.
Top