1 Usage
!
These sub-topics describe how to use the various features of the
DECNET_REGISTER utility.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!