Remove IP over SNA Route (RMVIPSRTE)

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

The Remove IP over SNA Route Entry (RMVIPSRTE) command removes an AF_INET sockets over SNA route. This command can be used to remove routes that have been specified with the Add IP over SNA Route (ADDIPSRTE) CL command. The route to be removed is identified by its route destination (RTEDEST), subnet mask (SUBNETMASK), and next hop (NEXTHOP).

Restriction: The user must have *IOSYSCFG authority to use this command.

Top

Parameters

Keyword Description Choices Notes
RTEDEST Route destination Character value Required, Positional 1
SUBNETMASK Subnet mask Character value, *HOST Required, Positional 2
NEXTHOP Next hop Character value Required, Positional 3
Top

Route destination (RTEDEST)

Specifies the route destination of the route to be removed. The route destination is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number ranging from 0 to 255. If the route destination address is entered from a command line, the address must be enclosed in apostrophes.

This is a required parameter.

Top

Subnet mask (SUBNETMASK)

Specifies the subnet mask of the route to be removed.

This is a required parameter.

Note: The network portion must be equal to one bits in the subnetmask. The host portion and the subnetmask portion of an address must both be at least two bits wide.

The possible values are:

*HOST
Specify this value when the internet address value specified in the route destination field is a host address.
subnet-mask
Specify the subnet mask in the form nnn.nnn.nnn.nnn where nnn is a decimal number ranging from 0 to 255. If the subnet mask address is entered from a command line, the address must be enclosed in apostrophes.
Top

Next hop (NEXTHOP)

Specifies the next hop of the route to be removed. The next hop is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number ranging from 0 to 255. If the next hop address is entered from a command line, the address must be enclosed in apostrophes.

This is a required parameter.

Top

Examples

RMVIPSRTE   RTEDEST('128.2.0.0')  SUBNETMASK('255.255.255.128')
            NEXTHOP ('128.3.4.5')

This command removes a network route entry for a subnetwork with network 128.2 and subnet mask of 255.255.255.128.

Top

Error messages

*ESCAPE Messages

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