Use this command to convert one form of an SNA address or identification to
its other forms. The ZNCVT command accepts the following identification
forms:
- Network address (NA)
- Logical end-point identifier (LEID)
- Resource identifier (RID) or session control block identifier (SCBID)
- Procedure correlation identifier (PCID)
- Network name
- Session address (SA)
- Session identifier (SID).
Requirements and Restrictions
None.
Format
- A address
- converts a network address, where address is the 6-digit
hexadecimal network address, which includes 2 digits for the subarea and 4
digits for the element address.
- Note:
- The A parameter is valid only for resources in a PU 5 environment.
- P leid
- converts a logical end-point identifier (LEID), where leid is the
6-digit hexadecimal LEID.
- R resource
- converts a resource identifier (RID) or session control block identifier
(SCBID), where resource is the 1- to 6-digit hexadecimal RID or
SCBID.
- D netid.cpname.pcid
- converts a session services procedure correlation identifier (PCID), where
netid is the 1- to 8-character network identifier, cpname is
the 1- to 8-character control point name, and pcid is the 16-digit
hexadecimal PCID. The network ID and name of a resource must both
begin with a letter (A-Z), @, #, or $.
The remaining characters can be letters (A-Z), numbers (0-9),
@, #, or $.
Notes:
- The PCID is fully qualified when you specify the network identifier and
control point name. If you do not specify the network identifier and
control point name, the first entry found in the resource vector table (RVT)
or session control block (SCB) with the specified PCID is displayed.
- To specify an SNA network ID or resource name that contains dollar
signs ($), you must type two consecutive dollar signs
($$) for each dollar sign in the network ID or resource
name. For example, if the SNA resource name is $SNANAME, you must type
$$SNANAME.
- N netid.name
- converts a resource name, where netid is the 1- to 8-character
network ID and name is the 1- to 8-character resource name.
The network ID and name of a resource must both begin with a letter
(A-Z), @, #, or $. The remaining
characters can be letters (A-Z), numbers (0-9), @,
#, or $.
Notes:
- If you do not specify the network ID, the first entry found in the RVT
with the specified resource name is displayed.
- To specify an SNA network ID or resource name that contains dollar
signs ($), you must type two consecutive dollar signs
($$) for each dollar sign in the network ID or resource
name. For example, if the SNA resource name is $SNANAME, you must type
$$SNANAME.
- S alsname.sesid
- converts a session identifier, where alsname is the 1- to
8-character ALS name and sesid is the 5-digit hexadecimal session ID
(SID). The network ID and name of a resource must both begin with
a letter (A-Z), @, #, or $. The remaining
characters can be letters (A-Z), numbers (0-9), @,
#, or $.
Notes:
- The first digit of the session ID, which represents the ODAI bit, must be
0 or 1. The 2nd-5th digits represent the session ID.
- The S parameter is valid only for resources in session under PU 2.1
environments.
- To specify an SNA network ID or resource name that contains dollar
signs ($), you must type two consecutive dollar signs
($$) for each dollar sign in the network ID or resource
name. For example, if the SNA resource name is $SNANAME, you must type
$$SNANAME.
- H rtpcb.sa
- converts a session address (SA), where rtpcb is the 1- to 6-digit
hexadecimal rapid transport protocol control block (RTPCB) index and
sa is the 16-digit hexadecimal SA. You can specify the
local-assigned SA (SA1) or the remote-assigned SA (SA2).
- Note:
- The H parameter is valid only for resources in session in a high-performance
routing (HPR) network.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZNCVT HELP
ZNCVT ?
Examples
A network address is converted in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCVT A 0A0015 |
| |
|System: NCVT0001I 13.51.16 BEGIN ZNCVT DISPLAY |
| NAME - APPA LEID - 000000 |
| PCID - |
| RID - 00003F |
| NADDR - 0A0015 |
| END OF ZNCVT DISPLAY |
+--------------------------------------------------------------------------------+
A logical end-point identifier (LEID) is converted in the following
example.
+--------------------------------------------------------------------------------+
|User: ZNCVT P FE0302 |
| |
|System: NCVT0001I 15.50.01 BEGIN ZNCVT DISPLAY |
| NAME - .LCL8DD LEID - FE0302 |
| PCID - |
| RID - 00014F |
| NADDR - 000000 |
| END OF ZNCVT DISPLAY |
+--------------------------------------------------------------------------------+
A RID is converted in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCVT R 71 |
| |
|System: NCVT0001I 15.50.46 BEGIN ZNCVT DISPLAY |
| NAME - VTAMNET.CLUBB002 LEID - 000000 |
| PCID - VTAMNET.VTAM2.E383BE955248DD76 |
| RID - 000071 |
| SESID - P34CA5B.10101 |
| END OF ZNCVT DISPLAY |
+--------------------------------------------------------------------------------+
A resource name is converted in the following example.
+--------------------------------------------------------------------------------+
|User: ZNCVT N APPA |
| |
|System: NCVT0001I 14.44.24 BEGIN ZNCVT DISPLAY |
| NAME - APPA LEID - 000000 |
| PCID - |
| RID - 00003F |
| NADDR - 0A0015 |
| END OF ZNCVT DISPLAY |
+--------------------------------------------------------------------------------+
The remote-assigned session address (SA2) is converted in the following
example.
+--------------------------------------------------------------------------------+
|User: ZNCVT H 2.2FC35E04E1E28C04 |
| |
|System: NCVT0007I 17.41.27 BEGIN ZNCVT DISPLAY |
| NAME - VTAMNET.X604 LEID - 000000 |
| PCID - VTAMNET.A604.C3F6C6A90CD06438 |
| SCBID - 800004 |
| RTP - 000002 SA1 - 2FC25E04 E9162805 |
| SA2 - 2FC35E04 E1E28C04 |
| END OF ZNCVT DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF ACF/SNA Data Communications Reference for
more information about SNA communications.