These sub-topics describe how to use the various features of the DECNET_REGISTER utility.
1 – Invocation
The DECNET_REGISTER utility is normally invoked using the RUN command.
It can also be invoked using a foreign command symbol. For example:
$ RUN SYS$SYSTEM:DECNET_REGISTER !Invoke the utility
$ NETREG :== $SYS$SYSTEM:DECNET_REGISTER !Foreign command symbol
$ NETREG !Invoke the utility
If a foreign command symbol is used, a command line can be passed directly
to DECNET_REGISTER on the invocation command line. For example:
$ NETREG SHOW NODE MyNode
If the utility is invoked by a foreign command symbol with a command line,
as shown above, it executes the command and exits after the command is
complete. If not, it continues to accept commands until an explicit
exit command is issued.
2 – Termination
The EXIT command causes DECNET_REGISTER to terminate execution. The Ctrl/Z key combination can also be used. If a command was specified on the invocation command line, the utility exits immediately after the command has been processed.
3 – Initialization Command File
On startup, the DECNET_REGISTER utility always attempts to execute
an initialization command file if one is present. This is most
useful for pre-setting the values to use for command parameter
defaults.
DECNET_REGISTER checks for an initialization file using a default
name of:
SYS$LOGIN:DECNET_REGISTER.INI
If this file is found, it is automatically executed as a command file
containing a series of DECNET_REGISTER commands. If a different file
name is to be used, specify the file name using the logical definition:
$ DEFINE DECNET_REGISTER_INIT initialization-file-name
If this logical definition exists, #(NETREG_NAME) uses the
specified file name, rather than the default file name.
4 – Interface Modes
After DECNET_REGISTER is invoked, and after it has executed the
initialization command file (if any), it enters either command
line mode or forms mode.
Command line mode is used if the utility is invoked from a command file
or from a hardcopy terminal. In this case, the utility accepts commands
as described in this help file.
Forms mode is used if the utility is invoked from a video terminal.
The DECNET_REGISTER utility can be forced to always run in command
line mode or forms mode by using one of the logical definitions:
$ DEFINE DECNET_REGISTER_COMMANDS 1 !Force the use of command lines
$ DEFINE DECNET_REGISTER_FORMS 1 !Force the use of forms
If either of these is defined, DECNET_REGISTER uses the indicated
interface mode, regardless of how it is invoked.
The DECNET_REGISTER utility can also be forced to run in command line
mode or forms mode by supplying one of the following arguments on
the invocation command line:
$ NETREG /C !Force the use of command lines
$ NETREG /F !Force the use of forms
To use these arguments, DECNET_REGISTER must be invoked using a foreign
command symbol.
If supplied, these arguments override both the I/O mode and the
logical definitions.
5 – Entering Commands
The following conventions are used in the command descriptions:
- Words presented in upper case are keywords that must be entered
as shown. These can be entered using either upper or lower case,
and can generally be abbreviated to three characters.
- Words presented in lower case represent values to be determined
by the user (node names for example).
- Words or phrases enclosed in square brackets ("[xxx]") are optional.
If these are not supplied, some default value or action is assumed.
6 – Setting Defaults
Default values are provided for most optional parameters. These default values can be displayed and changed using the SHOW, SET, and RESET DEFAULT commands. The SET DEFAULT command can be used in an initialization file in order to provide the same default parameter values each time DECNET_REGISTER is run.
7 – Obtaining Help
The HELP command allows you to obtain help for any command and command option. When entering a command, you can also obtain the list of options available at that point in the command. To do this, type a question mark (?) at the end of the command line. This lists the available command options, and prompts you for the desired option (if any). At the prompt, enter the option plus the rest of the command line.