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

Starting a Single Debug Session
Debugging an NCL Process
9–20 106160 Tandem Computers Incorporated
assigned the default NCL ID. You can subsequently use other DEBUG commands to
continue debugging the ZEX0902N NCL process, or you can change the current NCL
ID by using the DEBUG SET ID=ncl-id command.
Targeting Newly Executed NCL Processes
To target newly executed NCL processes in the current execution environment when
you start a debug session, follow these steps:
1. Use either the DEBUG START or DEBUG START PROCS=NEWPROCS command
to start the debug session.
2. Execute one or more NCL procedures. Each new NCL process is suspended
before it executes the first statement in the NCL procedure.
3. 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 newly executed NCL process in OCS, by
entering commands from the OCS command input line:
(11:22) --------------------- OPERATOR CONTROL SERVICES ----------------------
DEBUG START PROCS=NEWPROCS
NNM1949 NEW NCL WILL BE SUSPENDED IN THE TARGET ENVIRONMENT
START ZEX0902N THE QUICK BROWN FOX JUMPS OVER THE LAZY DOG
NNM1901 NCL 002048 DEBUG SESSION INITIATED
NNM1902 NCL 002048 SUSPENDED AT ZEX0902N.1 LINE 1
START ZEX0903N
NNM1901 NCL 002049 DEBUG SESSION INITIATED
NNM1902 NCL 002049 SUSPENDED AT ZEX0903N.1 LINE 1
DEBUG SET ID=2049
NNM1091 DEFAULT NCLID SET TO 002049
_____________________________________________________________________________
---------- ------------------ NonStop NET/MASTER D30 ---------------- --------
M=>
In this example, the DEBUG START command starts a debug session for new NCL
processes. The ZEX0902N and ZEX0903N NCL procedures are executed. The default
NCL ID is assigned to ZEX0902N when the debug session is initiated because this is
the first current NCL process. The DEBUG SET command then sets the current NCL
process to the ZEX0903N NCL process. You would subsequently use other DEBUG
commands to continue debugging the ZEX0903N NCL process.