| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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:
Restriction: The user must have *IOSYSCFG authority to use this command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| RMTDEST | Remote destination | Character value | Required, Positional 1 |
| SUBNETMASK | Subnet mask | Character value, *HOST | Required, Positional 2 |
| RMTNETID | Remote network identifier | Communications name, *NETATR | Optional |
| LOCTPL | Location template | Character value | Optional |
| Top |
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.
This is a required parameter.
Restrictions:
| Top |
Specifies a bit mask that identifies to AF_INET sockets over SNA which bits of the value specified for the remote 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.
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:
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.
| Top |
Specifies the name of the remote SNA network associated with this IP network or IP address.
The possible values are:
| Top |
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.
This is a required parameter.
The possible values are:
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:
Notes:
If the RMTDEST is for a single host, a single location name must be specified. A location template will not work.
| Top |
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.
| Top |
None
| Top |