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.
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. |
Adds a new DECnet-over-IP circuit to the current MultiNet configuration, and prompts for circuit configuration parameters.
ADD [circuit_name]
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.
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (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]
$
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.
ATTACH process-name
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.)
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (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.)
Deletes all DECnet-over-IP circuits from the current MultiNet configuration.
CLEAR
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>CLEAR
DECNET-CONFIG>EXIT
$
Deletes the specified DECnet-over-IP circuit from the current MultiNet configuration.
DELETE circuit_name
circuit_name
Specifies the name of the DECnet-over-IP circuit to delete.
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>DELETE TCP-0-0
DECNET-CONFIG>EXIT
$
Clears all DECnet-over-IP circuits from the current MultiNet configuration. (Functionally equivalent to CLEAR.)
ERASE
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>ERASE
DECNET-CONFIG>EXIT
$
Saves the current configuration, if it has been modified, then quits.
EXIT
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.6 (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.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>CLEAR
DECNET-CONFIG>EXIT
[Writing configuration to MULTINET:DECNET-CIRCUITS.COM}
$
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.
GET config_file
config_file
Specifies the name of the configuration file to read in.
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.6 (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
$
Invokes the help command.
HELP [topics]
topics
Contains a space-delimited list of topics that begins with a topic followed by subtopics. The default topic is HELP.
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (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>
Changes the parameters of the specified DECnet-over-IP Circuit in the MultiNet configuration.
MODIFY circuit_name
circuit_name
Specifies the name of the DECnet-over-IP circuit whose parameters will be modified.
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
DECNET-CONFIG>MODIFY TCP-0-0
[Adding new configuration entry for DECnet circuit “TCP-0-0”]
Destination IP Address: [10.0.0.6] RETURN
DECnet circuit cost: [1] 5
DECnet hello timer (in seconds): [300] RETURN
[TCP-0-0 => 10.0.0.6 (Cost=5, Hello Timer=300)]
DECNET-CONFIG>EXIT
$
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.
PUSH
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.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>PUSH
$ SET TERM /NOBROADCAST
$ LOGOUT
DECNET-CONFIG>
If the configuration file has been edited, QUIT prompts you to save the file before quitting.
QUIT
$ MULTINET CONFIGURE
/DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>QUIT
Configuration modified, do you want to save it ? [NO]NO
Writes out the current configuration file. (Functionally equivalent to WRITE; see WRITE for additional information.)
Displays the current MultiNet DECnet-over-IP circuit configuration.
SHOW
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SHOW
Circuit Name IP Destination Cost Hello Timer
------------ -------------- ---- -----------
TCP-0-0 10.1.30.1 1 300
DECNET-CONFIG>QUIT
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.
SPAWN [command]
command
Specifies a command to execute. If you omit command, a DCL command line subprocess is created.
/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.
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.6 (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.6 (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.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>SPAWN
$ HELP MULTINET CONFIGURE /DECNET ...
$ LOGOUT
DECNET-CONFIG>
Displays the status of the MultiNet DECnet-over-IP circuit configuration.
STATUS
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>STATUS
This is the MultiNet DECnet circuit configuration program Version 5.6 (nnn)
There are 1/100 circuits in the current configuration.
The configuration MULTINET:DECNET-CIRCUITS.COM is not modified.
DECNET-CONFIG>QUIT
$
Reads in a configuration file. (Functionally equivalent to GET; see GET for additional information.)
USE config_file
config_file
Specifies the name of the configuration file to read in.
Displays the version and release information of the MultiNet DECnet-over-IP circuit configuration program.
VERSION
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (nnn)
[Reading in configuration from MULTINET:DECNET-CIRCUITS.COM]
DECNET-CONFIG>VERSION
This is the MultiNet DECnet circuit configuration program Version 5.6 (nnn)
DECNET-CONFIG>QUIT
$
Writes the current MultiNet DECnet-over-IP circuit configuration to a file. (Functionally equivalent to SAVE.)
WRITE [config_file]
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).
$ MULTINET
CONFIGURE /DECNET
MultiNet DECNET Circuit Configuration Utility 5.6 (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