gtpo1mc1Operations

ZNSID-Side Information Table Function

Use this command to:

Requirements and Restrictions

Format




Add
adds an entry to the online side information table.
Note:
Each entry that you add to the side information table must have a symbolic destination name (NAME), transaction program name (TP), partner LU (LU), and mode name (MODE). To accommodate long entries, the ADD parameter requires that you specify only one of the TP, LU, and MODE parameters. You can specify the other parameters by using the CHANGE parameter. See the examples for more information.

Change
changes an entry in the side information table. You can change the transaction program name (TP), partner LU (LU), or mode name (MODE).

Display
displays information about an entry in the side information table.

Remove
removes an entry from the online side information table.

INITIALIZE
initializes the side information table.

LOAD
loads entries from a side information data set that is generated offline. The offline data can be contained on either a TPF general tape or on a TPF general data set (GDS).

Loading an offline data set can cause entries to be added to or removed from the online side information table. If an entry to be added from the offline data set has the same symbolic destination name as an entry in the online side information table, the entry from the offline data set replaces the online entry.

See the TPF ACF/SNA Data Communications Reference for information about the offline side information program.

Name-symname
is a 1- to 8-character alphanumeric symbolic destination name for an entry in the side information table. This name is used as the key field for accessing online side information table entries to perform the ZNSID ADD, CHANGE, DISPLAY, and REMOVE functions.

Tp-tpname
is a 1- to 64-byte transaction program name for an entry in the side information table. This name can include letters, numbers, symbols, and unprintable characters.

To allow the entry of such names, the TP parameter can include bytes that are specified in hexadecimal. Use the dollar sign ($) as a delimiter for these hexadecimal substrings.

Lu-netid.luname
is a 1- to 17-character partner LU for an entry in the side information table.  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 $. 
Note:
 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

Mode-modename
is a 1- to 8-character mode name for an entry in the side information table.  Mode names must begin with a letter (A-Z), @, #, or $. The remaining characters can be letters (A-Z), numbers (0-9), @, #, or $. 
Note:
 To specify a mode name that contains dollar signs ($), you must type two consecutive dollar signs ($$) for each dollar sign in the name. For example, if the mode name is $MODNAME, you must type $$MODNAME

Tape-tapename
is the 3-character name of the tape that contains the offline data set.

Gds-gdsname
is the 1- to 16-character alphanumeric name of the GDS that contains the offline data set.

Additional Information

Examples

The side information table is initialized in the following example. Once the side information table is initialized it is ready to accept new data and any previously existing data is destroyed.

+--------------------------------------------------------------------------------+
|User:   ZNSID INITIALIZE                                                        |
|                                                                                |
|System: NSID0004I 11.57.23 SIDE INFORMATION TABLE INITIALIZED                   |
+--------------------------------------------------------------------------------+

Changes and additions are loaded to the side information table from the TPF general tape named SID in the following example. Note that entries can also be read from a general data set.

Entries with new symbolic destination names are added to the table. Entries with duplicate names overwrite the old information.

+--------------------------------------------------------------------------------+
|User:   ZTMNT SID E46 A I                                                       |
|                                                                                |
|System: COTN0046I  TMNT 0123 - TAPE SID MOUNTED ON DEVICE E46 ...               |
|                                                                                |
|User:   ZNSID LOAD TAPE-SID                                                     |
|                                                                                |
|System: NSID0037I 17.12.23 LOADING SIDE INFORMATION DATA                        |
|        NSID0017I 17.12.23 USER TEXT FROM SIDE INFORMATION TAPE                 |
|        NEW DESTINATIONS                                                        |
|        TAPE WAS CREATED 01/17/91                                               |
|        --- END OF USER TEXT ---                                                |
|        NSID0005I 17.12.24 NEW SIDE INFORMATION TABLE ENTRIES LOADED            |
|        ENTRIES PROCESSED  -       1990                                         |
|        ENTRIES ADDED      -       1901                                         |
|        ENTRIES CHANGED    -          0                                         |
|        ENTRIES REMOVED    -         89                                         |
|        ERRORS DURING LOAD -          0                                         |
+--------------------------------------------------------------------------------+

A new entry named PROG1 is added to the side information table in the following example. When this entry is used by a program, the ALLOCATE verb brings up a session using SLOW mode with a NET.LUA partner LU, which has a transaction program called INVENTORY.

+--------------------------------------------------------------------------------+
|User:   ZNSID ADD NAME-PROG1 TP-INVENTORY LU-NET.LUA MODE-SLOW                  |
|                                                                                |
|System: NSID0001I 14:03:05 NEW ENTRY ADDED TO SIDE INFORMATION TABLE            |
+--------------------------------------------------------------------------------+

The partner LU for the PROG1 entry in the side information table is changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNSID CHANGE NAME-PROG1 LU-NET.LUB                                      |
|                                                                                |
|System: NSID0081I 14:10:03 SIDE INFORMATION ENTRY CHANGED                       |
+--------------------------------------------------------------------------------+

A long entry is added to the side information table in the following example. Only the transaction program name is specified for the ZNSID ADD command. The partner LU and mode name are specified using the ZNSID CHANGE command.

+--------------------------------------------------------------------------------+
|User:   ZNSID A N-REMOTE T-LONG$01$NAME$02$WITH$03$UNPRINTABLE$04$CHARACTERS    |
|                                                                                |
|System: NSID0006A 12.34.56 NEW ENTRY ADDED TO SIDE INFORMATION TABLE, ENTRY IS  |
|                           INCOMPLETE                                           |
|                                                                                |
|User:   ZNSID C N-REMOTE L-NETNET.REMOTELU                                      |
|                                                                                |
|System: NSID0019A 12.35.14 SIDE INFORMATION ENTRY CHANGED, ENTRY IS INCOMPLETE  |
|                                                                                |
|User:   ZNSID C N-REMOTE M-FIRSTCLS                                             |
|                                                                                |
|System: NSID0018I  12.35.43 SIDE INFORMATION ENTRY CHANGED                      |
+--------------------------------------------------------------------------------+

Entries in the side information table are displayed in the following example. If a transaction program name contains only letters, numbers, and symbols, it is displayed as text. If it contains unprintable characters, it is displayed as both hexadecimal digits and text.

+--------------------------------------------------------------------------------+
|User:   ZNSID DISPLAY NAME-PROG1                                                |
|                                                                                |
|System: NSID0002I 14.27.06 SIDE INFORMATION ENTRY DISPLAY                       |
|           NAME- PROG1                                                          |
|             TP- INVENTORY                                                      |
|             LU- NET.LUB                                                        |
|           MODE- SLOW                                                           |
|                                                                                |
|User:   ZNSID D N-REMOTE                                                        |
|                                                                                |
|System: NSID0002I 14.27.17 SIDE INFORMATION ENTRY DISPLAY                       |
|             NAME- REMOTE                                                       |
|          TP(HEX)- D3D6D5C7 01D5C1D4 C502E6C9 E3C803E4 LONG.NAM E.WITH.U        |
|                   D5D7D9C9 D5E3C1C2 D3C504C3 C8C1D9C1 NPRINTAB LE.CHARA        |
|                   C3E3C5D9 E2                         CTERS                    |
|               LU- NETNET.REMOTELU                                              |
+--------------------------------------------------------------------------------+

The PROG1 entry is removed from the side information table in the following example.

+--------------------------------------------------------------------------------+
|User:   ZNSID REMOVE NAME-PROG1                                                 |
|                                                                                |
|System: NSID0003I 14:15:12 SIDE INFORMATION ENTRY REMOVED                       |
+--------------------------------------------------------------------------------+

Incorrect values were specified for the TP and LU parameters in the following example. The pointer (---A) indicates where the error was found.

+---------------------------------------------------------------------------------------------+
|User:   ZNSID A N-XXX L-NETID2LONG.LUOK T-HEX$ABC$ERR M-MODEOK                               |
|                                                                                             |
|System: NSID0024E 15.32.38 TP NAME CONTAINS HEX SUBSTRING WITH ODD NUMBER OF DIGITS          |
|             HEX$ABC$ERR                                                                     |
|        ------------A                                                                        |
|        NSID0021E 15.32.38 NETWORK ID IS LONGER THAN 8 CHARACTERS                            |
|             NETID2LONG                                                                      |
|        -------------A                                                                       |
+---------------------------------------------------------------------------------------------+

In the following example, a side information offline data set that contains an incorrect entry is loaded to the TPF system. This results in an entry dump and the load ends.

Note:
The TPF offline side information tape generation program does not include incorrect entries, such as the one in this example, in the generated side information data set.
+---------------------------------------------------------------------------------------------+
|User:   ZNSID LOAD GDS-MYGDS                                                                 |
|                                                                                             |
|System: NSID0013E 00.15.63 SIDE INFORMATION GDS ENTRY ERROR DUMP                             |
|        INVALID TP NAME                                                                      |
|        INVALID LU NAME                                                                      |
|        INVALID MODE                                                                         |
|             NAME- C6D6D6C2 C1D95A5A                   FOOBAR..                              |
|        TP NAME LENGTH -  90                                                                 |
|               TP- E6C8C1E3 40E6D6E4 D3C440C8 C1D7D7C5 WHAT WOU LD HAPPE                     |
|                   D540C9C6 40C1D540 D6C6C6D3 C9D5C540 N IF AN  OFFLINE                      |
|                   C4C1E3C1 40E2C5E3 40C9D5C3 D3E4C4C5 DATA SET  INCLUDE                     |
|                   C440C1D5 40C5D5E3 D9E840E2 C8C1E340 D AN ENT RY THAT                      |
|        LU NAME LENGTH - 195                                                                 |
|               LU- D6D5E3C1 C9D5C5C4 40D1E4E2 E340D9C1 ONTAINED  JUST RA                     |
|                   D5                                  N                                     |
|        MODE LENGTH    - 196                                                                 |
|             MODE- D6D440C4 C1E3C16F                   OM DATA.                              |
|        OP CODE -   1 - ADD ENTRY                                                            |
|                                                                                             |
|        NSID0014E 00.15.64 PARTIAL SIDE INFORMATION TABLE LOAD TERMINATED DUE TO ERROR       |
|        ENTRIES PROCESSED  -          1                                                      |
|        ENTRIES ADDED      -          0                                                      |
|        ENTRIES CHANGED    -          0                                                      |
|        ENTRIES REMOVED    -          0                                                      |
|        ERRORS DURING LOAD -          1                                                      |
+---------------------------------------------------------------------------------------------+

Related Information

See TPF ACF/SNA Data Communications Reference for more information about the side information table and TPF/APPC in general.