Convert IP Address (CVTIPSIFC)

The Convert IP over SNA Interface (CVTIPSIFC) command converts an IP (Internet Protocol) address into its associated SNA network identifier and location name. The location entries defined with the Add IP over SNA Location Entry (ADDIPSLOC) CL command are searched to find the SNA location name and SNA network identifier associated with the input internet address (INTNETADR).

Keyword	Description	Choices	Notes
INTNETADR	Internet address	Character value	Required, Positional 1
OUTPUT	Output	, PRINT	Optional, Positional 2

Internet address (INTNETADR)

Specifies the internet address of the local host or a remote host to be converted. The internet address is specified in the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. An internet address is not valid if it has a value of all binary ones or all binary zeros for the network identifier (ID) portion or the host ID portion of the address. If the internet address is entered from a command line, the address must be enclosed in apostrophes.

This is a required parameter.

Restrictions:

The internet address cannot begin with 0 (for example, 0.nnn.nnn.nnn).
The internet address cannot begin with 127 (for example, 127.nnn.nnn.nnn). This address range is reserved for TCP/IP loopback addresses.
The internet address cannot be a class D or class E address. Valid class D addresses range from 224.nnn.nnn.nnn to 239.nnn.nnn.nnn. Valid class E addresses range from 240.nnn.nnn.nnn to 255.nnn.nnn.nnn.

Output (OUTPUT)

Specifies where the result should be 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

Example 1: Printing a Converted IP Address

CVTIPSIFC   INTNETADR('128.1.2.3')  OUTPUT(*PRINT)

This command finds the SNA network identifier and location name associated with IP address 128.1.2.3 and puts the result in the job's spooled output.

Example 2: Displaying a Converted IP Address

CVTIPSIFC   INTNETADR(128.2.3.4)

This command finds the SNA Network Identifier and Location Name associated with IP address 128.2.3.4 and puts the result to the display for an interactive job.