NET/MASTER Network Control Language (NCL) Programmer's Guide

Starting a Single Debug Session
Debugging an NCL Process
106160 Tandem Computers Incorporated 9–27
Note The USER and TERM operands of the DEBUG START command each have a default authority level of 2.
You must have an authority level of at least 2 to target a single NCL process for debugging if you do not
own the NCL process.
If a user is logged on more than once, it is advisable to specify both the USER and TERM operands to
uniquely identify the user. For example:
DEBUG START USER=NMTJN TERM=#8536078
You can further qualify each specification by execution state or window using the
PROCS or WINDOW operands, respectively, as discussed earlier in this section.
The following screen shows the steps you could use to target newly executed NCL
processes owned by user ID NMTJN who is logged on twice:
(09:34) --------------------- OPERATOR CONTROL SERVICES ----------------------
SHOW OCS
NNM0398 -USERID- TERMINAL --------NAME-------- ------LOCATION------ STATUS
NNM0399 NMTJN #8536078 JOHN NEWELL PUBLICATIONS ACTIVE
NNM0399 NMTJN #8536077 JOHN NEWELL PUBLICATIONS ACTIVE
NNM0999 *END*
SHOW TERM
NNM1217 LOGICALNM DEVICENM CLR HI MDL STATUS
NNM1204 #8536077 $ATP2.#TERM1 - - - IN SESSION
DEBUG START USER=NMTJN TERM=#8536078
NNM1948 NEW NCL WILL BE SUSPENDED IN WINDOW 1
NNM1901 NCL 000007 DEBUG SESSION INITIATED
NNM1902 NCL 000007 SUSPENDED AT ZEX0902N.1 LINE 1
SHOW NCL=NMTJN
NNM1036 NCLID BASEPROC CURRENT LEV W TYPE INIT OWNER G P P-UNITS
NNM1037 1500 ZHWKMMNN ZHWKMMNN 1 1 START NMTJN NMTJN 1 1 2009
NNM1041 ....PROCESSING OCS LINE 421
NNM1037 1 ZHWKMMNN ZHWKMMNN 1 1 START NMTJN NMTJN 1 1 1809
NNM1041 ....PROCESSING OCS LINE 421
NNM1037 7 ZEX0902N ZEX0902N 1 1 START NMTJN NMTJN 1 1 1
NNM1041 ....PROCESSING PROCEDURE LINE 1
NNM0999 *END*
---------- ------------------ NonStop NET/MASTER D30 ---------------- --------
M=>
In this example, all commands are executed by user ID NMTJN at terminal #8536077
($ATP2.#TERM1). The SHOW OCS command confirms that user NMTJN is logged on
twice and is using OCS in two windows. The SHOW TERM command displays the
name of the current terminal, that is, the terminal at which all commands are currently
being executed: its logical name is #8536077.
The DEBUG START command starts a debug session for newly executed NCL
processes at the user’s other terminal: its logical name is #8536078. The ZEX0902N
NCL procedure is executed at the other terminal (hence, the START ZEX0902N
command is not displayed on the screen at this terminal): the debug messages
indicating the start of the debug session are displayed at the current terminal. The
SHOW NCL command confirms the NCL processes being executed by user ID
NMTJN. You would subsequently use the DEBUG SET command to set the