Using NS3000/iX Network Services (36920-90008)
Chapter 8 189
NetCI
Writing and Executing Script Files
Writing and Executing Script Files
A script file includes all commands, flow control statements, and data
that allow you to remotely access and perform operations on nodes. To
execute the script file, it must reside on the management node on which
NetCI is installed.
Creating a Script File
You can create a script file with any text editor while you are at the
MPE colon prompt or from within NetCI. If you are in NetCI, you need
to run the editor program from the management node. For example, you
enter
NetCI>K RUN TDP.PUB.SYS
to run the editor on node K which is the management node.
Make sure the editor program resides on the management node, and
the user associated with the session is allowed access to the editor. The
script file you created will then reside on the management node in the
session's user account/group that was specified in NetCI configuration.
In this example, the new script file will reside on management node K
in the operator.sys account.
Special Symbols
When you create a script file, remember the following:
• Use the symbol % (percentage sign) preceding an MPE or NetCI
command. Subsystem command and program input records should
not be preceded by %.
• Use the symbol ! (exclamation mark) and a parms position number
within the script file to indicate the value or string (which is
specified with the PLAY command) to be used.
In the PLAY command, the first parameter specified after the file name
is considered as position 1. If you specify !1 within your script file,
NetCI will substitute the first parms value or string for !1. The file
name is considered as position 0.
Reserved Characters
There are also reserved characters that you can use in the script file.
Whenever the reserved character is encountered, NetCI substitutes it
with specific data as shown in Table 8-1. NetCI does not refer to the
PLAY command for a parms value or string. For example, when the script
file contains !a, NetCI substitutes the current account name for !a.