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

Controlling NCL Process Execution
Executing NCL Procedures
8–20 106160 Tandem Computers Incorporated
The FLUSH Command
You can use the FLUSH command from either the OCS command input line or an
NCL process to terminate an NCL process. The FLUSH command does not just
terminate the NCL procedure which happens to be executing at the time—FLUSH
terminates the NCL process and any of its dependent NCL processes. (Dependent
NCL processes are discussed in Section 16, “Environments and Command
Processing.”)
If you enter the FLUSH command with no operands, your NonStop NET/MASTER
MS system assumes that only one NCL process (except MSGPROC) is executing in
your region and assumes that the command applies to that NCL process. Your
NonStop NET/MASTER MS system attempts to terminate the execution of that NCL
process. If more than one NCL process (except MSGPROC) is executing, NCL displays
an error message.
To use the FLUSH command from the OCS command input line to terminate the
execution of a specific NCL process follow these steps:
1. Use the SHOW NCL command to display information about the NCL processes
that are currently executing, for example:
SHOW NCL=ALL
2. Examine the screen display to determine the NCL ID of the NCL process you want
to terminate.
3. Use the FLUSH command with the ID operand to specify the NCL ID of the NCL
process you want to terminate, for example:
FLUSH ID=3007
The QEXIT Verb
You can use the QEXIT verb from within an NCL process to quickly exit the NCL
process. The QEXIT verb terminates the current procedure or function, all higher-level
procedures, and the OCS window in which the NCL process is executing. If you are
using only one OCS window, the QEXIT verb logs you off from NonStop
NET/MASTER MS.
Refer to the NonStop NET/MASTER NCL Reference Manual for additional information
about the QEXIT verb.
Restarting a Suspended
NCL Process
The SHOW PAUSE command shows you the names of NCL processes that have
suspended execution. The execution of an NCL process may be suspended for a
number of reasons, for example, as a result of executing a DELAY or PAUSE verb. If
an NCL process is suspended, you can use the GO command to restart it.
If you enter the GO command with no operands, your NonStop NET/MASTER MS
system assumes that only one NCL process (except MSGPROC) is executing in your
region and assumes that the command applies to that NCL process. Your NonStop
NET/MASTER MS system attempts to restart that NCL process. If more than one
NCL process (except MSGPROC) is executing, NCL displays an error message.