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

Entering NonStop NET/MASTER MS Commands From an NCL Process
Environments and Command Processing
106160 Tandem Computers Incorporated 16–29
NonStop NET/MASTER MS
Command Entry
Restrictions
When you enter a NonStop NET/MASTER MS command from an NCL procedure,
you must enclose the command in quotes if it contains operators or special characters.
The equal sign (=) is an example of a character that NCL uses as an operator. Refer to
the NonStop NET/MASTER NCL Reference Manual for a complete list of operators and
special characters.
You can enclose in quotes either the complete command string or just those parts that
contain the operator(s) or special character(s). The following examples show
commands that must be enclosed in quotes when entered from an NCL procedure
because they contain an equal sign:
LINK DEFINE=ZNNM MSGID=ZNNM COLOR=BLUE
SESSION DEFINE=ZNNMS LINK=ZNNM TYPE=PTP
UNIT DEFINE=ZNNMU SESSION=ZNNMS MODE=PRIMARY,
DEVICE=$ZNNM.SUBVOL1.MAILBOX1
The following examples show how to correctly enter these commands from an NCL
procedure:
CMD "LINK DEFINE=ZNNM MSGID=ZNNM COLOR=BLUE"
CMD "SESSION DEFINE=ZNNMS LINK=ZNNM TYPE=PTP"
CMD "UNIT DEFINE=ZNNMU SESSION=ZNNMS MODE=PRIMARY",
"DEVICE=$ZNNM.SUBVOL1.MAILBOX1"
Note The presence of the dollar sign ($), period (.), and number sign (#) in these examples does not mean that
the command must be enclosed in quotes; these characters are not operator characters or special
characters.
You should be particularly careful if you include a logical name as part of a NonStop
NET/MASTER MS command within an NCL procedure. Logical names can contain
any displayable character, including characters that NCL regards as operators and
special characters. For example, if you want to refer to a terminal that has the logical
name of TERM(1), you must enclose it in quotes because the parentheses are special
characters:
CMD "TERMINAL ADD=TERM(1) DEVICE=$ATP2.#TERM1"
Note As a general rule, always enclose NonStop NET/MASTER MS commands in quotes when you enter them
from an NCL procedure.
You can execute most NonStop NET/MASTER MS commands from an NCL
procedure by using either the CMD core statement or the INTCMD verb. Some
commands cannot be executed from an NCL procedure by using the CMD core
statement; others cannot be executed by using the INTCMD verb; and a few cannot
be executed from an NCL procedure at all. Refer to the NonStop NET/MASTER MS
Command Reference Manual to determine CMD and INTCMD command entry
restrictions for individual commands.