CL Command Reference - ADDIPSLOC
CL Command List > ADDIPSLOC Reference
Description:
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.
Examples:
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.