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

Starting a Single Debug Session
Debugging an NCL Process
9–24 106160 Tandem Computers Incorporated
Targeting a Window That Is Not Open. If you attempt to target for debugging a window
that is not open, the attempt fails. For example, from an OCS screen in window 1, if
you target window 2 and window 2 is not open, window 2 is not targeted for
debugging.
The following command (entered from an OCS screen in window 1) attempts to target
all NCL processes in OCS window 2, but fails because window 2 is not open:
DEBUG START PROCS=ALLPROCS WINDOW=2
The following message displays the results of the command in OCS window 1:
NNM1087 WINDOW 2 IS NOT OPEN
To target window 2, you must first open the window by splitting or swapping to the
window from window 1. From OCS window 1, to split the screen and open window 2
you can use either the F2 function key (the SPLIT key by default) or the SPLIT
command. From OCS window 1, to swap to window 2 and open window 2 you can
use either the F9 function key (the SWAP key by default) or the SWAP command.
Refer to the NonStop NET/MASTER MS Operator’s Guide for more details on swapping
and splitting in general and the F2 and F9 function keys in particular. The NonStop
NET/MASTER MS Command Reference Manual describes the syntax of the SPLIT and
SWAP commands in detail.
Targeting the NonStop NET/MASTER MS Primary Menu in Window 2 From OCS Window 1. From
an OCS screen in window 1, if you target window 2 and window 2 is currently
displaying the NonStop NET/MASTER MS primary menu or a lower-level menu, the
top-level environment in window 2 is targeted for debugging. This targets the
NonStop NET/MASTER MS primary menu or lower-level menu for debugging.
(Lower-level menus include Edit Services, the User ID Management Services (UMS)
menus, the System Support Services menus, and the User Services menus.)
Note You must specify either the PROCS=CURRPROCS or PROCS=ALLPROCS operand in the DEBUG
START command from OCS window 1 to target the NonStop NET/MASTER MS primary menu or
lower-level menus for debugging in window 2.
For example, if window 2 is currently displaying the NonStop NET/MASTER MS
primary menu, the following command (entered from an OCS screen in window 1)
targets the NonStop NET/MASTER MS primary menu in window 2:
DEBUG START PROCS=CURRPROCS WINDOW=2
The following message displays the results of the command in OCS window 1:
NNM1088 1 NCL PROCESSES TARGETED IN WINDOW 2
NNM1901 NCL 001525 DEBUG SESSION INITIATED
NNM1902 NCL 001525 SUSPENDED AT ZHWKMMNN.113 LINE 246
Note ZHWKMMNN is the name of NCL procedure distributed with NonStop NET/MASTER MS that displays the
NonStop NET/MASTER MS primary menu.