NET/MASTER Management Services (MS) System Management Guide

Customizing NonStop NET/MASTER MS Commands
Customizing the Operations Environment
115414 NonStop NET/MASTER MS System Management Guide 5–13
Suppose, for example, that you want to simplify use of the DSNM START LINE
command: you can create a global equate that abbreviates the command string with
which users issue the command. To create a global equate, use the EQUATE
command in the INIT NCL procedure, as shown in the following line:
CMD "EQUATE OSL OPSYS START LINE+"
The global equate can be used to start a line named $LINE1 by issuing a command
such as this:
OSL $LINE1
As discussed in the NonStop NET/MASTER MS Operator’s Guide, an operator can
define local equates, whose abbreviations override the global equates.
Replacing Commands With
NCL Procedures
You can replace a command with an NCL procedure of the same name by using the
SYSPARMS CMDREPL command. The SYSPARMS CMDREPL command must be
placed in the INIT NCL procedure. If the command name is entered, the NCL
procedure is executed instead of the command. If the command is included in the
NCL procedure, the command is executed when the line of the procedure is reached.
The capacity to replace commands with NCL procedures provides a number of
benefits. For example, you can write an NCL procedure that tests whether a condition
is true before allowing a user to run the command. You could also use the NCL
procedure to filter operands, combine similar or linked commands, or run an NCL
procedure before executing the command.
You can, for example, restrict use of a command to a specific time window. An NCL
procedure that replaces the command can use the NCL DATE and TIME built-in
functions to determine whether the command is issued within an authorized time
interval. If the time condition is met, the NCL procedure would then issue the
command.
The INIT NCL procedure distributed with NonStop NET/MASTER MS includes the
following lines, which issue CMDREPL commands:
cmd "sysparms cmdrepl=opsys"
cmd "sysparms cmdrepl=progrun"
The first statement in the example replaces the native OPSYS command with an NCL
procedure that checks whether the user has the authority to invoke a specified utility
or one of its commands. The second statement in the example replaces the native,
unrestricted PROGRUN command with a more security-sensitive NCL procedure that
intercepts PROGRUN commands and submits them to a security procedure. The
security procedure determines whether the user who issued the command has the
minimum command authority level required to invoke the command before passing
the command to NonStop NET/MASTER MS for execution. Refer to the NonStop
NET/MASTER MS Command Reference Manual for additional information about the two
formats of the OPSYS and PROGRUN commands.
When you use the SYSPARMS CMDREPL command to replace a command with an
NCL procedure, NonStop NET/MASTER MS preloads the NCL procedure specified