gtpo1mavOperations

ZNCVT-Convert SNA Resource Addresses

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:

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:

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

  2.  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:

  1. If you do not specify the network ID, the first entry found in the RVT with the specified resource name is displayed.

  2.  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:

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

  2. The S parameter is valid only for resources in session under PU 2.1 environments.

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