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

Starting a Single Debug Session
Debugging an NCL Process
9–28 106160 Tandem Computers Incorporated
ZEX0902N NCL process as the current NCL process and use other DEBUG commands
to debug the ZEX0902N NCL process.
Targeting a Background
Processing Environment
You can target NCL processes executing in a background processing environment for
debugging by specifying the user ID of the virtual user that owns the environment. To
do so, follow these steps:
1. Ensure that you are able to receive messages from the virtual user, by setting your
OCS profile correctly. The following command ensures that you are able to
receive all unsolicited messages:
PROFILE UNSOL=YES MONMSG=YES EMS=YES MSG=YES
2. Use the SHOW USERS command to find out the user IDs of all or specified virtual
users. The following command obtains the user ID of the Background Monitor
(BMON):
SHOW USERS=*BMON
3. Ensure that the NCL procedure you want to debug exists in the user procedure
library of the virtual user:
a. To find out the name of the library, check the NCL Library Subvol field of the
user ID definition record of the virtual user in User ID Management Services
(UMS).
b. Use the SHOW FILEINFO command, specifying the name of the library, to
view the files in the library.
4. Start the debug session, using the USER=user-id operand to specify the name of
the virtual user that owns the background processing environment. You can
target currently executing, newly executed, or both types of NCL processes in the
environment.
For example, use the following command to start a debug session for currently
executing NCL processes in the background processing environment owned by
BMON:
DEBUG START PROC=CURRPROCS USER=SYS1BMON
Use the following command to start a debug session for newly executed NCL
processes in the background processing environment owned by BMON:
DEBUG START USER=SYS1BMON
Use the following command to start a debug session for currently executing and
newly executed NCL processes in the background processing environment owned
by BMON:
DEBUG START PROCS=ALLPROCS USER=SYS1BMON
Note When you target the background processing environment owned by a virtual user for debugging, NCL
processes are suspended in logical window 0.