ADDIPSLOC (Add IP over SNA location entry) Command Description

ADDIPSLOC Command syntax diagram

Purpose

The Add IP over SNA Location Entry (ADDIPSLOC) command is used to define AF_INET sockets over SNA location mapping entries. AF_INET sockets over SNA requires that an SNA location (network identifier/location name) be defined for each IP address that can be reached on an SNA transport. The location mapping entries define the SNA location for each IP address.

The SNA locations can be identified in one of two ways:

• A single host (or IP address) is specified with a single SNA location (network identifier/location name).
• A group of hosts designated by the network ID portion of the IP address is specified with a given SNA network identifier and a location name template.

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

Required Parameters

RMTDEST

Specifies the remote network, subnetwork or host associated with this location entry. You must specify all four bytes that make up an internet address though some of the bytes may be equal to 0. For example, a remote route destination to all the hosts on the 9.5.11 subnetwork is identified by entering 9.5.11.0 for the remote route destination. Used in combination with a subnet mask value, the remote route destination will identify a remote network or system.

The remote 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 remote route destination 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 remote route destination cannot start with a zero (0); for example, 0.nnn.nnn.nnn.

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

3. The remote 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 remote route destination of 255.255.255.255. This is the limited broadcast address.

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 remote route destination, all bits in the host portion of the IP address cannot be zero (0).

SUBNETMASK

Specifies a bit mask that identifies to AF_INET sockets over SNA which bits of the value specified for the route destination (RMTDEST) compose the network and subnet portions of the internet address. By defining the network portion and subnetwork portion of the RMTDEST address, the subnet mask also defines which bits of the RMTDEST 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 remote 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, 255.255.255.0 could define a subnet mask for an interface with a class B internet address. In this example, the first two octets must be 1 bits because these octets define the network ID portion of the class B internet address. The third octet of this subnet mask defines the actual subnet mask ID portion of the interface's internet address. It is also all 1 bits. This leaves the fourth octet to define the host ID portion of the interface's internet address.

For example, a remote route destination'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 subnetmask 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 subnetmask. The subnetmask in this example may be 255.255.192.0 if the third octet is used as the subnetwork ID portion of the internet address.

LOCTPL

Specifies the SNA location names associated with the IP network or subnetwork specified by the remote route destination or a single location name if the remote route destination address is for a single host.

location-name-template: Specify an 8 character template to be used by the system for generating remote location names based on the remote IP address specified on socket system calls. The first character must be A (or a) through Z (or z), or special characters $, #, or @ followed by 0 through 9, A (or a) through Z (or z), $, #, @, or ?. The template must specify some of the characters for the location name. The system generates the remaining characters based on the class of the IP address.

System-generated location name characters are identified by a question mark (?) character. Each question mark represents a single character that is generated by the system. A question mark may be used anywhere within the location name template except in the first character position. For example, the following location name templates are valid:

• ABCD????
• AB??CD??
• A?B?C?D?

Notes:

1. The number of question mark (?) characters in the template is dependent on how the remote destination (RMTDEST) parameter is used:

   • If the internet address specified for the RMTDEST is for a single host, the SUBNETMASK value must be *HOST or 255.255.255.255 and the LOCTPL value must not contain any question mark (?) characters.

   • If the internet address specified for the RMTDEST is for a network or subnetwork, the LOCTPL value must be an 8 character template containing a minimum number of question mark (?) characters based on the number of host mask bits contained in the SUBNETMASK parameter value. The minimum number of question mark characters is determined by dividing the number of host mask bits in the SUBNETMASK value by 5 and rounding up to the next whole number. For example: If the SUBNETMASK is 255.255.255.128, there are 7 host mask bits. In this case there must be 2 question mark characters in the template.

2. If the RMTDEST is for a group of hosts, a location name template must be specified. A single location name will not work.

location-name: Specify the remote location name. This name can be one to eight characters in length. The first character must be A (or a) through Z (or z), or special characters $, #, or @ followed by 0 through 9, A (or a) through Z (or z), $, #, or @.

If the RMTDEST is for a single host, a single location name must be specified. A location template will not work.

Optional Parameters

RMTNETID

Specifies the name of the remote SNA network associated with the IP network or IP address specified by the remote route destination.

*NETATR: The remote network identifier specified in the network attributes is used.

remote-sna-network-identifier: Specify the remote network identifier. This identifier can be one to eight characters in length. The first character must be A (or a) through Z (or z), or special characters $, #, or @ followed by 0 through 9, A (or a) through Z (or z), $, #, or @.

Examples for ADDIPSLOC

Example 1: Adding an AF_INET Sockets over SNA Location Entry

ADDIPSLOC  RMTDEST('128.2.0.0')
  SUBNETMASK('255.255.255.128')  LOCTPL('ABCD????')

This command adds an AF_INET sockets over SNA location entry for a subnetwork with network 128.2 and subnet mask of 255.255.255.128. Remote IP addresses for subnetwork 128.2 specified on socket system calls are algorithmically mapped into SNA names that use the SNA network identifier specified in the network attributes and location names which start with ABCD. The system creates the remaining four characters of the location name based on the IP address. See the Convert IP over SNA Interface (CVTIPSIFC) command for more information.

Example 2: Adding an AF_INET Sockets over SNA Location Entry for a Host

ADDIPSLOC  RMTDEST('128.2.3.4')
   SUBNETMASK(*HOST)  LOCTPL(XYZ00001)

This command adds an AF_INET sockets over SNA location entry for a host at IP address 128.2.3.4. The address 128.2.3.4 is mapped to the SNA location name of XYZ00001 and uses the default SNA network identifier specified in the network attributes.