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

Starting a Single Debug Session
Debugging an NCL Process
106160 Tandem Computers Incorporated 9–21
Targeting Both Currently Executing and Newly Executed NCL Processes
To target both currently executing and newly executed NCL processes in an
environment when you start a debug session, follow these steps:
1. Execute one or more NCL procedures.
2. Use the DEBUG START PROCS=ALLPROCS command to start the debug session.
Each currently executing NCL process in the environment is suspended at the
statement it is currently executing.
3. Execute one or more NCL procedures. Each new NCL process in the environment
is suspended before it executes the first statement in the NCL procedure.
4. Use the SHOW NCL command to determine the unique NCL ID of the NCL
process you want to debug first from others in the group.
5. If the default NCL ID is not set for the NCL procedure you want to debug, use the
DEBUG SET ID=ncl-id command or another DEBUG command that specifies an
NCL ID to set an NCL process as the current NCL process.
You can subsequently use other DEBUG commands to debug the NCL process. After
executing other NCL procedures, you can switch from NCL process to NCL process as
required by specifying a new NCL ID. The debug session ends when you use the
DEBUG STOP ALL command to terminate the session.
The following screen shows how to target a specific NCL process in OCS, by entering
commands from the OCS command input line:
(10:51) --------------------- OPERATOR CONTROL SERVICES ----------------------
START ZEX0902N THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG
NNM1060 PROCEDURE ZEX0902N NCLID 529 PAUSED
DEBUG START PROCS=ALLPROCS
NNM1949 NEW NCL WILL BE SUSPENDED IN THE TARGET ENVIRONMENT, 1 TARGETED
NNM1901 NCL 000529 DEBUG SESSION INITIATED
NNM1902 NCL 000529 SUSPENDED AT ZEX0902N.8 LINE 22
START ZEX0903N
NNM1901 NCL 000530 DEBUG SESSION INITIATED
NNM1902 NCL 000530 SUSPENDED AT ZEX0903N.1 LINE 1
SHOW NCL
NNM1036 NCLID BASEPROC CURRENT LEV W TYPE INIT OWNER G P P-UNITS
NNM1037 529 ZEX0902N ZEX0902N 1 1 START NMTMG NMTMG 1 1 21
NNM1041 ....PROCESSING PAUSE LINE 22
NNM1037 530 ZEX0903N ZEX0903N 1 1 START NMTMG NMTMG 1 1 1
NNM1041 ....PROCESSING PROCEDURE LINE 1
NNM0999 *END*
DEBUG SOURCE
NNM1926 NCL 000529 LINE# SMT EV ON STMT-TEXT FROM ZEX0902N
NNM1927 NCL 000529 22 8 0 0 PAUSE VARS=( &PAUSE )
NNM0999 *END*
---------- ------------------ NonStop NET/MASTER D30 ---------------- --------
P =>
In this example, the ZEX0902N NCL procedure is executed. The DEBUG START
command starts a debug session for all NCL processes. The ZEX0903N NCL
procedure is executed. The SHOW NCL command displays the NCL IDs of these