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

NCL Procedure Libraries
Initial NCL Procedure Development
106160 Tandem Computers Incorporated 4–15
NCL Procedure
Libraries
NCL procedure libraries are subvolumes that store NCL procedures. An NCL
procedure library can store source files, or object files, or both. An NCL procedure
library may be a system procedure library or a user procedure library.
This subsection explains the difference between source files and object files. It then
discusses the difference between system procedure libraries and user procedure
libraries.
Source Files and Object
Files
NCL source files are disk files of NCL statements that you create and edit using Edit
Services.
When you execute an NCL procedure, NCL automatically compiles it if it has not been
compiled before. The compilation process creates object code from the source file.
Object code is NCL code in an executable form, that is, a form that can be executed by
NCL. NCL stores the object code in an object file.
Note There is only one object file per NonStop NET/MASTER MS user. The object code of every compiled
source file belonging to a user is contained in this object file.
The object file is created on the first occasion that a user executes an NCL procedure.
Thereafter, object code from every other unique NCL procedure executed by that user
is appended to the object file.
The object file is an Enscribe key-sequenced file. NCL uses the name of the NCL
source file as the key to the object code. It uses this key to retrieve the object code of a
certain NCL procedure from the object file when an NCL procedure is reexecuted.
System Procedure
Libraries and Files
A system procedure library contains NCL procedures owned by a NonStop
NET/MASTER MS system. There are two system procedure libraries: the
distribution procedure library and the customized procedure library. There is also a
distributed NCL object file.
Distribution Procedure Library
A NonStop NET/MASTER MS system has only one distribution procedure library.
This library contains the source code of NCL procedures distributed as part of a
NonStop NET/MASTER MS installation or upgrade. NonStop NET/MASTER MS
upgrades replace those NCL procedures in the distribution procedure library that are
superseded by new versions. (Refer to the NonStop NET/MASTER MS System
Management Guide for a list of NCL procedures for which source code is distributed.)
The location of the distribution procedure library is defined in the NonStop
NET/MASTER MS configuration file using the PARAM NCLDISTSRC command. The
following example uses the PARAM NCLDISTSRC command to define the location of
the distribution procedure library in the subvolume $DATA4.ZNNMNDS:
PARAM NCLDISTSRC=$DATA4.ZNNMNDS