2. DECNET-CONFIG Command Reference

 

This chapter describes the commands you can run from the DECNET-CONFIG command line. DECNET-CONFIG lets you examine, modify, and save configuration files for DECnet-over-IP circuits.

To invoke DECNET-CONFIG:

$ MULTINET CONFIGURE /DECNET

At any DECNET-CONFIG prompt, type ? to list the available commands. Use the DECNET-CONFIG HELP command to view online help for each DECNET-CONFIG command.

Changes do not take effect until you do one of the following:

$ @MULTINET:DECNET-CIRCUITS.COM.

For details on configuring DECnet-over-IP circuits, refer to the MultiNet Installation and Administrator’s Guide.

 

Command Summary

The below table lists the commands you can use from the DECNET-CONFIG prompt.

Command

Description

ADD

Adds a DECnet-over-IP circuit to the current configuration.

ATTACH

Attaches to a subordinate process.

CLEAR

Deletes all DECnet-over-IP circuits from the current configuration; same as ERASE.

DELETE

Deletes a single DECnet-over-IP circuit from the current configuration.

ERASE

Deletes all DECnet-over-IP circuits from the current configuration; same as CLEAR.

EXIT

Exits DECNET-CONFIG and saves the current configuration.

GET

Reads in a DECnet-over-IP circuit configuration file; same as USE.

HELP

Displays command information.

MODIFY

Changes the parameters in a DECnet-over-IP circuit configuration file.

PUSH

Accesses the DCL command line and pauses DECNET-CONFIG.

QUIT

Exits DECNET-CONFIG, but prompts to save changes before exiting.

SAVE

Writes out the DECNET-CONFIG current configuration file; same as WRITE.

SHOW

Displays the current DECnet-over-IP circuit configuration.

SPAWN

Executes a single DCL command or starts a subprocess.

STATUS

Displays the status of the DECnet-over-IP circuit configuration.

USE

Reads in a DECnet-over-IP circuit configuration file; same as GET.

VERSION

Displays DECNET-CONFIG version and release information.

WRITE

Writes out the current DECNET-CONFIG configuration file; same as SAVE.

 

 

ADD

Adds a new DECnet-over-IP circuit to the current MultiNet configuration, and prompts for circuit configuration parameters.

 

Format

ADD [circuit_name]

 

Parameter

circuit_name

Specifies the name of the DECnet circuit to add to the configuration. If not specified in the command, the first unused circuit in the configuration is used by default.

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
DECNET-CONFIG>ADD
[Adding new configuration entry for DECnet circuit "TCP-0-0"]
Destination IP Address: [NONE] 192.0.0.6
DECnet circuit cost: [1] 1
DECnet hello timer (in seconds): [300] 300
[TCP-0-0 => 192.0.0.6 (Cost=1, Hello Timer=300)
DECNET-CONFIG>EXIT
[Writing configuration to MULTINET:DECNET-CIRCUITS.COM]
$

 

ATTACH

Detaches the terminal from the calling process and reattaches it to another process. Use the SPAWN SHOW PROCESS /SUBPROCESSES command to list the names of the subprocesses. Use the DCL LOGOUT command to return to the original process. If the MULTINET_DISABLE_SPAWN logical is enabled, ATTACH does not work.

 

Format

ATTACH process-name

 

Parameter

process-name

Specifies the name of a process to which you want your terminal attached. (Not all subprocesses can be attached; some testing may be required.)

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM
DECNET-CONFIG>SPAWN
$ MM
MM>SPAWN SHOW PROCESS/SUB
...
There are 3 processes in this job:
_TWA42:
PROC_1
PROC_2 (*)
MM>ATTACH _TWA42:
DECNET-CONFIG>ATTACH PROC_1
MM>QUIT
$ LOGOUT
DECNET-CONFIG>

This example shows the use and exit of attached subprocesses.

The first command uses SPAWN to create a subprocess. MM is invoked from the DCL command line. Next, the SPAWN SHOW PROCESS/SUB command is used to list all subprocess names. The display shows that three subprocesses are active. (Process _TWA42: is DECNET-CONFIG, PROC_1 is MM, and PROC_2 is the SPAWN SHOW PROCESS/SUB command.)

In the next command, the MM ATTACH command returns control to the DECNET-CONFIG process. From this utility, ATTACH returns control to MM. To exit, the QUIT command is invoked from MM, and LOGOUT is invoked at the original spawned DCL command line; control returns to DECNET-CONFIG. (If SPAWN SHOW PROCESS/SUB had been entered, only this command and the configuration processes would be active.)

 

CLEAR

Deletes all DECnet-over-IP circuits from the current MultiNet configuration.

 

Format

CLEAR

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>CLEAR
DECNET-CONFIG>EXIT
$

 

DELETE

Deletes the specified DECnet-over-IP circuit from the current MultiNet configuration.

 

Format

DELETE circuit_name

 

Parameter

circuit_name

Specifies the name of the DECnet-over-IP circuit to delete.

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>DELETE TCP-0-0
DECNET-CONFIG>EXIT
$

 

ERASE

Clears all DECnet-over-IP circuits from the current MultiNet configuration. (Functionally equivalent to CLEAR.)

 

Format

ERASE

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>ERASE
DECNET-CONFIG>EXIT
$

 

EXIT

Saves the current configuration, if it has been modified, then quits.

 

Format

EXIT

 

Examples

If the configuration has not changed, a message displays indicating that the configuration file is not updated.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>EXIT
$

 

If the configuration has changed, a message displays indicating that the configuration file has been updated.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>CLEAR
DECNET-CONFIG>EXIT
[Writing configuration to MULTINET:DECNET-CIRCUITS.COM}
$

 

GET

Reads in a MultiNet DECnet-over-IP circuit configuration file, which defaults to the highest version number of the MULTINET:DECNET-CIRCUITS.COM file. (Functionally equivalent to USE.) After using GET, you can use other DECNET-CONFIG commands to display and modify the new configuration.

 

Format

GET config_file

 

Parameter

config_file

Specifies the name of the configuration file to read in.

 

Example

This example reads in the highest version number of the MULTINET_ROOT:[MULTINET]DECNET-CIRCUITS.COM configuration file. In this case, the highest version number is ";7". This number is appended to the file name as the value ".7".

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>GET
[Reading in configuration from MULTINET_ROOT:[MULTINET]DECNET-CIRCUITS.COM.7]
DECNET-CONFIG>EXIT
$

 

HELP

Invokes the help command.

 

Format

HELP [topics]

 

Parameter

topics

Contains a space-delimited list of topics that begins with a topic followed by subtopics. The default topic is HELP.

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>HELP ?
ADD      ATTACH   CLEAR   DELETE   ERASE    EXIT     GENERAL    GET
MODIFY   PUSH     QUIT    SAVE     SHOW     SPAWN    STATUS     USE
VERSION  WRITE
DECNET-CONFIG>

 

MODIFY

Changes the parameters of the specified DECnet-over-IP Circuit in the MultiNet configuration.

 

Format

MODIFY circuit_name

 

Parameter

circuit_name

Specifies the name of the DECnet-over-IP circuit whose parameters will be modified.

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
DECNET-CONFIG>MODIFY TCP-0-0
[Adding new configuration entry for DECnet circuit “TCP-0-0”]
Destination IP Address: [192.0.0.6] RETURN
DECnet circuit cost: [1]  5
DECnet hello timer (in seconds): [300] RETURN
[TCP-0-0 => 192.0.0.6 (Cost=5, Hello Timer=300)]
DECNET-CONFIG>EXIT
$

 

PUSH

Starts and attaches a DCL subprocess. If a parent process exists, attach to it. To return from DCL, use the ATTACH or the LOGOUT command. To switch back from a DCL subprocess, use the ATTACH command.

If the MULTINET_DISABLE_SPAWN logical is set, PUSH does not work.

 

Format

PUSH

 

Example

In this example, PUSH is used to access the DCL command line to disable broadcasts. The LOGOUT command returns control to DECNET-CONFIG.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>PUSH
$ SET TERM /NOBROADCAST
$ LOGOUT
DECNET-CONFIG>

 

QUIT

If the configuration file has been edited, QUIT prompts you to save the file before quitting.

 

Format

QUIT

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>QUIT
Configuration modified, do you want to save it ? [NO]NO

 

SAVE

Writes out the current configuration file. (Functionally equivalent to WRITE; see WRITE for additional information.)

 

SHOW

Displays the current MultiNet DECnet-over-IP circuit configuration.

 

Format

SHOW

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SHOW
Circuit Name       IP Destination       Cost      Hello Timer
------------       --------------       ----      -----------
TCP-0-0            192.168.30.1          1         300
DECNET-CONFIG>QUIT

 

SPAWN

Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. To return from DCL, use the LOGOUT command. If the MULTINET_DISABLE_SPAWN logical is set, SPAWN does not work.

 

Format

SPAWN [command]

 

Parameter

command

Specifies a command to execute. If you omit command, a DCL command line subprocess is created.

 

QUALIFIERS

/INPUT=file-spec

Specifies an input file to the command you enter with SPAWN.

 

/LOGICAL_NAMES
/NOLOGICAL_NAMES

Specifies that logical names and logical name tables are not copied to the subprocess.

 

/SYMBOLS
/NOSYMBOLS

Specifies that global and local names are not passed to the subprocess.

 

/WAIT
/NOWAIT

Returns control without waiting for the command to complete. Do not use this qualifier with commands that have prompts or screen displays.

 

/OUTPUT=file-spec

Specifies a file that retains the output of the command invoked with SPAWN. This qualifier only works when a single command is entered without creating a DCL subprocess. In addition, this qualifier is positional; you must enter it immediately after SPAWN or other qualifiers.

 

Examples

This example displays terminal information, captures the output in a file, and displays the information with the TYPE command.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SPAWN/OUTPUT=FOO. SHOW TERM
DECNET-CONFIG>SPAWN TYPE FOO.
...

This example invokes a command procedure.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SPAWN @COMPROC
...

This example displays help information about DECNET-CONFIG. Use the LOGOUT command to return control to DECNET-CONFIG.

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SPAWN
$ HELP MULTINET CONFIGURE /DECNET ...
$ LOGOUT
DECNET-CONFIG>

 

STATUS

Displays the status of the MultiNet DECnet-over-IP circuit configuration.

 

Format

STATUS

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>STATUS
This is the MultiNet DECnet circuit configuration program Version 5.5 (nnn)
There are 1/100 circuits in the current configuration.
The configuration MULTINET:DECNET-CIRCUITS.COM is not modified.
DECNET-CONFIG>QUIT
$

 

USE

Reads in a configuration file. (Functionally equivalent to GET; see GET for additional information.)

 

Format

USE config_file

 

Parameter

config_file

Specifies the name of the configuration file to read in.

 

VERSION

Displays the version and release information of the MultiNet DECnet-over-IP circuit configuration program.

 

Format

VERSION

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>VERSION
This is the MultiNet DECnet circuit configuration program Version 5.5 (nnn)
DECNET-CONFIG>QUIT
$

 

WRITE

Writes the current MultiNet DECnet-over-IP circuit configuration to a file. (Functionally equivalent to SAVE.)

 

Format

WRITE [config_file]

 

Parameter

config_file

Specifies the name of the DECnet-over-IP circuit configuration file to write out (by default, the same file from which the configuration was read).

 

Example

$ MULTINET CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.5 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>WRITE
[Writing configuration to MULTINET_ROOT:[MULTINET]DECNET CIRCUITS.COM.2]
DECNET-CONFIG>EXIT