The Convert IP over SNA Location Entry (CVTIPSLOC) command is used to convert a specified SNA network identifier and location name into one or more associated IP addresses. The location entries defined with the ADD IP over SNA Location Entry (ADDIPSLOC) CL command are searched to find one or more IP addresses that are associated with the input SNA location name (LOC) and SNA network identifier (NETID).

Parameters

Keyword	Description	Choices	Notes
NETID	Network identifier	Communications name, *NETATR	Optional, Positional 1
LOC	Location name	Communications name	Optional, Positional 2
OUTPUT	Output	*, *PRINT	Optional, Positional 3

Top

Network identifier (NETID)

Specifies the SNA network identifier for the local host or a remote host.

The possible values are:

*NETATR

The network identifier in the network attributes for this host is used.

network-identifier

Specify the network identifier for the local host or a remote host. The network 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 @.

Location name (LOC)

Specifies the SNA location name to be converted.

This is a required parameter.

The possible values are:

location-name

Specify the SNA location name for the local host or a remote host. 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 @.

Output (OUTPUT)

Specifies where the results are returned.

The possible values are:

*

The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT

The output is printed with the job's spooled output.

Examples

CVTIPSLOC   LOC(LUNAMEX)  OUTPUT(*PRINT)

This command converts the location name LUNAMEX with the default network identifier specified in the network attributes and places the results in the job's spooled output.

Error messages

*ESCAPE Messages

CPFA115

SNA network identifier and location name not converted.

CPFA119

No associated internet address found.