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

Starting a Single Debug Session
Debugging an NCL Process
106160 Tandem Computers Incorporated 9–19
Targeting Currently Executing NCL Processes
To target currently executing NCL processes in the current execution environment
when you start a debug session, follow these steps:
1. Execute one or more NCL procedures.
2. Use the DEBUG START PROCS=CURRPROCS command to start the debug
session. Each currently executing NCL process in the environment is suspended
at the statement it is currently executing.
3. Use the SHOW NCL command to determine the unique NCL ID of the NCL
process you want to debug first.
4. Use the DEBUG SET ID=ncl-id command or another DEBUG command that
specifies an NCL ID to set this NCL process as the current NCL process.
You can subsequently use other DEBUG commands to debug this NCL process. You
can switch from this NCL process to any other targeted NCL process as required by
specifying a new NCL ID. The debug session ends when all targeted NCL processes
terminate execution, unless you use a DEBUG STOP command to stop the debug
session.
The following screen shows how to target a currently executing NCL process in OCS,
by entering commands from the OCS command input line:
(10:00) --------------------- OPERATOR CONTROL SERVICES ----------------------
START ZEX0902N THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG
NNM1060 PROCEDURE ZEX0902N NCLID 524 PAUSED
START ZEX0903N
NNM1060 PROCEDURE ZEX0903N NCLID 525 PAUSED
DEBUG START PROCS=CURRPROCS
NNM1089 2 NCL PROCESSES EXECUTING IN THE TARGET ENVIRONMENT
NNM1901 NCL 000524 DEBUG SESSION INITIATED
NNM1902 NCL 000524 SUSPENDED AT ZEX0902N.8 LINE 22
NNM1901 NCL 000525 DEBUG SESSION INITIATED
NNM1902 NCL 000525 SUSPENDED AT ZEX0903N.2 LINE 2
SHOW NCL
NNM1036 NCLID BASEPROC CURRENT LEV W TYPE INIT OWNER G P P-UNITS
NNM1037 524 ZEX0902N ZEX0902N 1 1 START NMTMG NMTMG 1 1 21
NNM1041 ....PROCESSING PAUSE LINE 22
NNM1037 525 ZEX0903N ZEX0903N 1 1 START NMTMG NMTMG 1 1 6
NNM1041 ....PROCESSING PAUSE LINE 2
NNM0999 *END*
DEBUG SOURCE
NNM1926 NCL 000524 LINE# SMT EV ON STMT-TEXT FROM ZEX0902N
NNM1927 NCL 000524 22 8 0 0 PAUSE VARS=( &PAUSE )
NNM0999 *END*
---------- ------------------ NonStop NET/MASTER D30 ---------------- --------
P =>
In this example, two NCL processes are currently executing—the ZEX0902N NCL
process and the ZEX0903N NCL process. The DEBUG START command starts a
debug session for these NCL processes. The SHOW NCL command displays the NCL
IDs of these NCL processes. The DEBUG SOURCE command then displays the
decompiled source of the suspended line in the current NCL process that has been