Remove IP over SNA Interface (RMVIPSIFC)

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

The Remove IP over SNA Interface (RMVIPSIFC) command removes an AF_INET sockets over SNA interface (an IP address by which this local host is known on the SNA transport). This command can be used to remove interfaces that have been specified with the Add IP over SNA Interface (ADDIPSIFC) CL command. The interface to be removed is identified by its internet address (INTNETADR).

Restrictions:

  1. The user must have *IOSYSCFG authority to use this command.
  2. The interface cannot be active when you submit this command. Use the End IP over SNA Interface (ENDIPSIFC) CL command to deactivate the interface.
  3. There can be no configured routes whose NEXTHOP internet address can be reached only through the network associated with the IP over SNA interface to be removed.
Top

Parameters

Keyword Description Choices Notes
INTNETADR Internet address Character value Required, Positional 1
Top

Internet address (INTNETADR)

Specifies the internet address of an interface that had previously been added to the SNA configuration with the Add IP over SNA Interface (ADDTCPIFC) CL command. The internet address is specified in the form, 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. 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.

This is a required parameter.

internet-address
Specify the internet address associated with the interface to be removed.
Top

Examples

RMVIPSIFC   '9.5.1.248'

This command removes the interface with the IP address 9.5.1.248.

Top

Error messages

*ESCAPE Messages

TCP8050
*IOSYSCFG authority required to use &1.
TCP9999
Internal system error in program &1.
Top