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

Factors Affecting NCL Procedure Location
Executing NCL Procedures
8–10 106160 Tandem Computers Incorporated
Note Logically, there is only one active, retain, and pend-unload list. In practice, all NonStop NET/MASTER
MS Guardian processes that support NCL support one of each type of list. The number of lists, therefore,
depends on the way you have configured the operating mode of your NonStop NET/MASTER MS
system—basic, extended basic, or advanced. Refer to the NonStop NET/MASTER MS System
Management Guide for more information on operating modes.
One copy of every preloaded NCL procedure is kept in every active list in every Guardian process that
supports NCL. Additional NCL procedures in the active, retain, and pend-unload lists may vary from
Guardian process to Guardian process: it depends on the NCL procedures that have been executed in a
specific Guardian process. The display from the SHOW PRELOAD command, therefore, may differ from
user to user.
The Default Search Path The default search path that NonStop NET/MASTER MS uses to locate an NCL
procedure source file affects the NCL procedure it finds when there is more than one
of the same name. The order of the search path that NonStop NET/MASTER MS uses
to search for any NCL procedure (unless a particular procedure library is specified in a
command) is:
1. User procedure library, the name of which is defined in your user ID definition
record. (The name of the user procedure library for each virtual user is defined in
the user ID definition record for each user.)
2. System procedure library, which includes the following:
a. Customized procedure library, the location of which is defined in the NonStop
NET/MASTER MS configuration file using the PARAM NCLCUSTSRC
command.
b. Distribution procedure library, the location of which is defined in the NonStop
NET/MASTER MS configuration file using the PARAM NCLDISTSRC
command.
3. The distributed NCL object file. How you can customize the default NCL
procedure search path is discussed later in this section.
There are two consequences of using the default search path for an NCL procedure.
First, when it searches for an NCL procedure source file on disk, NonStop
NET/MASTER MS begins by looking in your own user procedure library, if present.
If you do not have a user procedure library, NonStop NET/MASTER MS begins the
search with the customized procedure library. NonStop NET/MASTER MS continues
the search to the distribution procedure library, if it cannot find an earlier matching
name. Finally, if still unsuccessful, NonStop NET/MASTER MS searches the
distributed NCL object file.
Second, when an NCL procedure is preloaded using the SYSPARMS PRELOAD
command, unless the name of a procedure library is specified, NonStop
NET/MASTER MS begins the search by looking in the customized procedure library.
NonStop NET/MASTER MS continues the search to the distribution procedure
library, if it cannot find a matching name in the customized procedure library. Finally,