ADDIPSRTE (Add IP over SNA Route) Command Description

ADDIPSRTE Command syntax diagram

Purpose

The Add IP over SNA Route (ADDIPSRTE) command is used to identify a route to a remote network or a route to a remote destination system in the AF_INET sockets over SNA configuration.

Restrictions:

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

2. A route cannot be added unless the internet address of the gateway system specified by the NEXTHOP parameter can be reached directly through a network associated with a previously defined AF_INET sockets over SNA interface. An interface can be added using the Add IP over SNA Interface (ADDIPSIFC) CL command.

Required Parameters

RTEDEST

Specifies the route destination being added. You must specify all 4 bytes that make up an internet address though some of the bytes may be equal to 0. For example, a route to all the hosts on the 9.5.11 subnetwork is identified by entering 9.5.11.0 for the route destination. Used in combination with a subnet mask and next hop, the route destination uniquely identifies a route to a network or system.

route-destination: Specify the route destination being added. The route destination can be specified in the form nnn.0.0.0, for Class A, nnn.nnn.0.0 for Class B, and nnn.nnn.nnn.0 for Class C, or nnn.nnn.nnn.nnn for any combination thereof, where nnn is a decimal number ranging from 0 through 255.

Any combination thereof means that you may specify a route, such as 9.5.0.0 to the hosts on the 9.5 subnet, even though all 9.5.x.x addresses are class A network addresses.

Restrictions:

1. The route destination cannot start with a zero (0); for example, 0.nnn.nnn.nnn.

2. The route destination cannot start with 127; for example, 127.nnn.nnn.nnn. This address range is reserved for TCP/IP loopback addresses.

3. The route destination cannot be a class D or class E address. Class D addresses range from 224.nnn.nnn.nnn to 239.nnn.nnn.nnn. Class E addresses range from 240.nnn.nnn.nnn to 255.nnn.nnn.nnn.

4. You cannot specify a route destination of 255.255.255.255.

5. You cannot specify a directed broadcast address for the remote route destination; for example, nnn.255.255.255 for class A, nnn.nnn.255.255 for class B, and nnn.nnn.nnn.255 for class C.

6. For a single host route destination, all bits in the host portion of the IP address cannot be zero (0).

7. For a single host route destination, an interface cannot exist with the same internet address as the RTEDEST internet address.

SUBNETMASK

Specifies a bit mask that identifies to AF_INET sockets over SNA which bits of the value specified for the route destination (RTEDEST) compose the network and subnet portions of the internet address. By defining the network portion and subnetwork portion of the RTEDEST address, the subnet mask also defines which bits of the RTEDEST address make up the host portion. The mask is a 32-bit combination that is logically ANDed with the internet address to determine a particular subnetwork. The bits of the mask set to the value one (1) determine the network and subnetwork portions of the address. The bits set to the value zero (0) determine the host portion of the address.

*HOST: Specify this value when the internet address value specified in the route destination field is a host address. The subnet mask value is calculated to be 255.255.255.255.

subnet-mask: Specify the mask for the network subnet field and host address field of the internet address that defines a subnetwork. The subnetwork mask is in the form, nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. The subnet mask must mask off all bits of the network class's network ID portion of the internet address. This means the subnet mask for a class A address must be 255.nnn.nnn.nnn, the subnet mask for a class B address must be 255.255.nnn.nnn, and the subnet mask for a class C address must be 255.255.255.nnn. For example, a destination route's internet address value of 129.35.192.0 identifies a Class B subnetwork. The network ID part of its address is 129.35. The portion of the subnet mask that is associated with the network portion of a particular class of address must equal 255. Therefore, the upper 2 bytes must be equal to 255.255 in the subnet mask. The subnet mask in this example may be 255.255.192.0 if the third octet is used as the subnetwork ID portion of the internet address.

NEXTHOP

Specifies the internet address of the next system (gateway) on the route. A route cannot be added unless the internet address specified by the NEXTHOP parameter can be reached directly through a network associated with a previously defined AF_INET sockets over SNA interface. An interface can be added by using the Add IP over SNA Interface (ADDIPSIFC) CL command.

internet-address: Specify the internet address. 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.

Restrictions:

1. The next hop internet address cannot begin with 0 or 127 (for example, 0.nnn.nnn.nnn).

2. The next hop internet address cannot be a class D or class E address. Class D addresses range from 224.nnn.nnn.nnn to 239.nnn.nnn.nnn. Class E addresses range from 240.nnn.nnn.nnn to 255.nnn.nnn.nnn.

Examples for ADDIPSRTE

Example 1: Adding a Network Route on the Network

ADDIPSRTE   RTEDEST('128.2.0.0')
  SUBNETMASK('255.255.0.0')  NEXTHOP('9.2.3.4')

This command defines a network route for all remote hosts on the network 128.2. Network 128.2 is not subnetted since the first two octets of a class B internet address are the network ID portion of the address and the subnet mask is only masking off the first two octets. The gateway specified by NEXTHOP must be in the same network or subnetwork as one of the AF_INET sockets of SNA interfaces that has already been defined on the local host.

Example 2: Adding a Network Route on the Subnetwork

ADDIPSRTE   RTEDEST('129.1.1.0')
  SUBNETMASK'(255.255.255.0')
  NEXTHOP('128.3.4.5')

This command defines a network route for all remote hosts on the subnetwork 129.1.1. Network 129.1 is subnetted, with the subnet portion of the IP address contained in byte 3. For this example assume that subnet mask 129.1.1 is directly accessible only through the AF_INET Sockets over SNA interface 128.3.4.5 that has already been defined on the local host. Since the network id portion of interface 128.3.4.5 is not the same as the route destination's network id, we need to specify that the NEXTHOP is the local interface 128.3.4.5. This tells AF_INET Sockets over SNA to use local interface 128.3.4.5 to get to subnetwork 129.1.1.

TCP2665

&2 &1 not added successfully.

TCP2666

&2 &1 not added.

TCP8050

*IOSYSCFG authority required to use &1.

TCP9999

Internal system error in program &1.