CVTIPSIFC (Convert IP over SNA Interface)

CVTIPSIFC Command syntax diagram

 

Purpose

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).

 

Required Parameters

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.

 

Restrictions

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

 

Optional Parameters

OUTPUT

Specifies where the result should be returned.

*: 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 for CVTIPSIFC

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.

Error messages for CVTIPSIFC

*ESCAPE Messages

CPFA111

Internet address not converted.

CPFA118

No associated SNA network identifier and location name found.