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

Factors Affecting NCL Procedure Location
Executing NCL Procedures
8–8 106160 Tandem Computers Incorporated
The following example sends a command to the Background Monitor to execute at a
certain time. This timer command tells the Background Monitor to execute the NCL
procedure NETMON at 18:00.
AT 18:00 ROUTE=MON CMD=START NETMON
Once you have submitted a command to a virtual user, its processing is managed
entirely by the virtual user. Processing is not affected if you exit OCS or log off from
your NonStop NET/MASTER MS system.
Virtual users are discussed in more detail in Section 16, “Environments and Command
Processing.”
Note To receive messages from virtual users while using OCS, you must ensure that your OCS profile allows
you to receive unsolicited messages. Enter the PROFILE command from the OCS command input line to
determine the status of the UNSOLICITED MESSAGE option.
Factors Affecting NCL
Procedure Location
Many factors affect what your NonStop NET/MASTER MS system does when an NCL
procedure is executed. There are some factors that affect where your NonStop
NET/MASTER MS system tries to locate the NCL procedure and there are others that
affect what your NonStop NET/MASTER MS system does when it locates it. This
subsection discusses the following topics:
How NonStop NET/MASTER MS uses the following three internal lists to keep
NCL procedures in memory:
The active list
The retain list
The pend-unload list
How NonStop NET/MASTER MS uses the default search path to search for NCL
procedures.
How to customize the NCL procedure search path.
How preloading and unloading NCL procedures affect execution.
How NCL procedure sharing affects execution.
How the setting of test mode affects execution.
How all these factors interact.
The Active, Retain, and
Pend-Unload Lists
An NCL procedure that is compiled and loaded into memory can be shared among
multiple NCL processes. It is kept in one of three internal lists: an active list, a retain
list, or a pend-unload list.
Note The object code of an NCL procedure that is compiled and loaded into memory consists of opcodes and
is called an object. When executed, the opcodes are executed by an NCL interpreter.
The active list keeps two types of NCL procedures. It keeps individual NCL
procedures that have been preloaded using the SYSPARMS PRELOAD command. It