NET/MASTER Management Services (MS) Command Reference Manual

DEBUG LOAD
NonStop NET/MASTER MS Commands
2–44 115412 Tandem Computers Incorporated
DEBUG LOAD The DEBUG LOAD command loads the specified file—an external NCL procedure or
function—before execution by an NCL process. You would load an external NCL
procedure or function before execution for two main reasons: so that you can ensure
that the NCL process you are debugging will use a newly compiled, privately loaded
copy of the external NCL procedure or function, not an existing copy from the active
or retain list; and so that you can set breakpoints in the external NCL procedure or
function before it is called.
If you do not load the external NCL procedure or function before execution, you may
execute an existing copy from the active or retain list and you will not be able to set
breakpoints in it because it will not be privately loaded. The PROFILE NCLTEST,
SYSPARMS NCLPRSHR, and SYSPARMS PRELOAD commands determine how an
NCL procedure or function is loaded.
DEBUG LOAD [ ID= ncl-id ] FILE= file-name
ID= ncl-id
specifies the NCL process identifier (NCL ID) of an NCL process and sets the
current NCL process. If you do not specify an NCL ID, the default NCL ID is
assumed (see the DEBUG START command for further information about the
default NCL ID).
FILE= file-name
specifies the file name of an external NCL procedure or function.
The current NCL process, or the NCL process targeted by the ID= ncl-id
operand, loads the specified file before execution.
NCL attempts to locate the specified file using the default search path associated
with the NCL process being debugged (as if the file were an external NCL
procedure or function and test mode were set on).
If the specified file has already been loaded by the NCL process, it is not loaded
again.