Convert Network ID / Location (CVTIPSLOC)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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).
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| NETID | Network identifier | Communications name, *NETATR | Optional, Positional 1 |
| LOC | Location name | Communications name | Optional, Positional 2 |
| OUTPUT | Output | 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 @.
| Top |
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 @.
| Top |
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).
- The output is printed with the job's spooled output.
| Top |
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.
| Top |
Error messages
*ESCAPE Messages
- CPFA115
- SNA network identifier and location name not converted.
- CPFA119
- No associated internet address found.
| Top |