Change IP over SNA Location (CHGIPSLOC)

The Change IP over SNA Location (CHGIPSLOC) command is used to change an existing AF_INET sockets over SNA location entry. This command only changes the remote network identifier (RMTNETID) and the location name template (LOCTPL). The remote route destination and subnet mask identify the location entry being changed.

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

Parameters

Keyword	Description	Choices	Notes
RMTDEST	Remote destination	Character value	Required, Key, Positional 1
SUBNETMASK	Subnet mask	Character value, *HOST	Required, Key, Positional 2
RMTNETID	Remote network identifier	Communications name, SAME, NETATR	Optional
LOCTPL	Location template	Character value, *SAME	Optional

Top

Remote destination (RMTDEST)

Specifies the remote route destination of the location entry to be changed. The remote route destination is specified in the form nnn.nnn.nnn.nnn where nnn is a decimal number ranging from 0 through 255.

This is a required parameter.

Subnet mask (SUBNETMASK)

Specifies the subnet mask of the location entry to be changed.

This is a required parameter.

The possible values are:

*HOST: Specify this value when the internet address value specified in the remote 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 through 255.

Remote network identifier (RMTNETID)

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

The possible values are:

*SAME: The SNA remote network identifier value does not change.
*NETATR: The remote network identifier specified in the network attributes is used.
remote-network-identifier: Specify a remote network identifier up 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 @.

Location template (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.

The possible values are:

*SAME

The SNA location name template or location name value does not change.

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.

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

See the Add IP over SNA Location (ADDIPSLOC) CL command for additional information about location name templates.

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.

Examples

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

This command changes the location name template associated with AF_INET sockets over SNA location entry for a subnetwork with network 128.2 and subnet mask of 255.255.255.128.