gtpo1mc1 | Operations |
Use this command to:
Requirements and Restrictions
Format
|
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.
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.
Additional Information
ZNSID HELP
ZNSID ?
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.
+---------------------------------------------------------------------------------------------+ |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.