NET/MASTER Management Services (MS) Command Reference Manual

LBANNER
NCLQUEUE SET
NonStop NET/MASTER MS Commands
115412 Tandem Computers Incorporated 2–165
NCLQUEUE SET The NCLQUEUE SET command defines an NCL queue and sets the execution limit, or
modifies the execution limit of an existing NCL queue. The execution limit determines
the maximum number of NCL processes that can concurrently execute in the specified
queue for each NCL processing environment.
A START verb that uses the QUEUE operand (with or without the DELAY operand)
sends an NCL procedure to a queue. The DELAY operand specifies whether execution
is delayed. The QUEUE operand specifies the queue to which the NCL procedure is
sent. If both DELAY and QUEUE are specified, DELAY takes precedence: that is, an
NCL procedure is delayed before it is queued. The NCL procedure is allocated an
NCL ID and becomes an NCL process regardless of whether execution is delayed.
The following conditions determine when an NCL process sent to a queue executes:
If there is no delay (either the DELAY operand is omitted or specifies 0), the NCL
process is placed in the queue immediately. The NCL process begins execution if
its addition to the queue does not exceed the execution limit.
If there is a delay, the NCL process is placed in the queue after the delay period
expires. The NCL process begins execution if its addition to the queue does not
exceed the execution limit.
NCLQUEUE SET= queue-name LIMIT= number
Note Any user who can write NCL procedures can use the START verb to send an NCL procedure to any NCL
queue. Therefore, it is important to establish guidelines for naming NCL queues, for setting execution
limits, and for ensuring that NCL processes are sent to appropriate NCL queues. Consider defining a
unique NCL queue:
For each NCL programmer who develops NCL procedures
For each class of user (system manager, network manager, security administrator, operator, and so
on) that executes NCL procedures
For each type of user-defined operation automatically performed by an NCL process
queue-name
specifies the name of an NCL queue. If the queue does not exist, it is created and
an execution limit is set: otherwise, the execution limit is modified.
You can specify a queue name from 1 through 20 characters long. You can use the
following characters:
Alphabetic characters: A through Z and a through z
Numeric characters: 0 through 9
Other characters: ^ ~ # $ { } - . : @ [ \ ] _ ` |