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

Setting the Current NCL Process
Debugging an NCL Process
9–32 106160 Tandem Computers Incorporated
Setting the Current
NCL Process
When starting a debug session using the DEBUG START command, NonStop
NET/MASTER MS assigns a default NCL ID to the most current NCL process.
You can, however, explicitly set the current NCL process in two ways: by using the
DEBUG SET command, or by using the ID operand on any other DEBUG command.
After being set, DEBUG commands that do not explicitly use the ID operand refer to
the current NCL process.
Note When you specify an NCL ID, the numeric value is not checked to confirm that it matches a current NCL
ID until you issue the next DEBUG command.
The following screen shows how to set the current NCL process:
(15:51) --------------------- OPERATOR CONTROL SERVICES ----------------------
DEBUG START
NNM1949 NEW NCL WILL BE SUSPENDED IN THE TARGET ENVIRONMENT
START ZEX0902N THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG
NNM1901 NCL 001616 DEBUG SESSION INITIATED
NNM1902 NCL 001616 SUSPENDED AT ZEX0902N.1 LINE 1
DEBUG STEP
NNM1902 NCL 001616 SUSPENDED AT ZEX0902N.2 LINE 15
START ZEX0903N
NNM1901 NCL 001617 DEBUG SESSION INITIATED
NNM1902 NCL 001617 SUSPENDED AT ZEX0903N.1 LINE 1
DEBUG SET ID=1617
NNM1091 DEFAULT NCLID SET TO 001617
DEBUG SOURCE ON
NNM1926 NCL 001617 LINE# SMT EV ON STMT-TEXT FROM ZEX0903N
NNM1927 NCL 001617 1 1 0 0 ZEX0903N: PROCEDURE EXTPARSE SIMPLE
NNM0999 *END*
NNM2307 NCL 001617 DEBUG SOURCE IS SET ON.
DEBUG STEP
NNM1926 NCL 001617 LINE# SMT EV ON STMT-TEXT FROM ZEX0903N
NNM1927 NCL 001617 2 2 0 0 PAUSE VARS=&1
NNM1902 NCL 001617 SUSPENDED AT ZEX0903N.2 LINE 2
---------- ------------------ NonStop NET/MASTER D30 ---------------- --------
M=>
In this example, the DEBUG START command starts a debug session. The START
command executes the ZEX0902N NCL procedure. After the start message, there are
two further messages that show that the default NCL ID (1616) is set to the current
NCL process, and that this process is suspended, awaiting further debug commands.
The DEBUG STEP command advances the procedure ZEX0902N to line 15. The next
line shows the start of a new NCL procedure, ZEX0903N, and its immediate
suspension. To debug a different NCL procedure, the DEBUG SET ID=1617 command
is used.
The DEBUG SOURCE ON command changes the debug mode so that decompiled
source code is displayed. Finally, the DEBUG STEP command advances the current
NCL process, ZEX0903N, to the next executable line and displays its decompiled
source.