dupterm(8) System Manager's Manual dupterm(8)
Name
dupterm - DUP virtual terminal program
Syntax
/usr/etc/dupterm
Description
The DUP virtual terminal program provides access to the diagnostic and utility features of DSA (DIGITAL Storage Architecture) intelligent
disk and tape controllers.
Depending upon the particular controller, operations may include the execution of controller resident diagnostics and utilities or those
downloaded from the host system.
Further information regarding the operation of the utility and diagnostic capabilities associated with a particular controller may be
obtained from the appropriate documentation set for that controller.
Once invoked, prompts the user with "DUP>> ", and waits for a command. can be in one of three states at any time. When it is started, it
is in state. When it has established a connection to the on the remote controller, it is in the state. When it starts execution of a
diagnostic or utility on the remote controller, it enters the state. In this state, user typein is normally transmitted to the remote pro-
gram. To force to interpret a command locally instead, enter a '.' character as the first character of the command line. To transmit a
'.' as the first character of a command line to the remote program, enter two periods as the first two characters of the command.
The program recognizes the following commands. Commands are case insensitive. The minimum acceptable abbreviation for each command is
shown in uppercase.
Help Displays a brief description of all commands.
ABort Valid only in state. Aborts the execution of the remote program. Enters the state.
Connect scs-node-name
Valid only in state. Attempts to establish a connection to the SCS node named If successful, enters the state. Use the command to
get a list of available SCS nodes.
^ char Valid in state. Sends a control character to the remote program. The space between the "^" and is ignored.
DIsconnect
Valid only in states or Breaks the connection. If a remote program was executing, terminates it as well.
Dust Valid in states or Issues a GET DUP STATUS command to the connected controller, and displays the results.
INFO Valid in all states. Displays SCS related information, such as the node names and their SCS id's.
LOG [log-file-name]
Valid in all states. If a file name is given, all interaction is logged in the file. If no file is given, terminates logging.
Quit Quits the session.
Runl task-name
Valid only in state. Loads the program from the local media on the controller, and starts its execution. If successful, enters
the state. Whether is case-sensitive or not depends on the controller.
RUNS task-or-file-name
Valid only in state. Attempts to load the program first from the file on the local host, and if not found, from the file and
starts its execution. is the program name extension as returned by the controller. If successful, enters the state.
SEt HSCmode {ON|OFf}
Valid in any state. When is set to does some special processing needed by the HSC-nn controllers.
SEt SERver {-d|scs_sysap_name}
Valid in any state. Sets the name of the SYSAP name to use to establish the connection. If -d option is given, tells it to use the
default servers "DUP", "MSCP$DUP", and "DUP$SERVER" in order.
SHOw NODe
Valid only in the states or Displays the name of the node is connected to currently.
SHOw SERver
Valid in any state. Displays the current server setting.
SHOw STATus
Valid in any state. Displays the current status of including which controller it is connected to, and which program it is execut-
ing, if any.
SHOw TASk
Valid only in state. Shows the name of the remote diagnostic or utility currently executing.
SHOw VERsion
Displays version information about dupterm and the dup driver. Useful for reporting problems.
SYNChronize
Valid in all states. Forces to change its state to confirm to the actual state of the remote controller. This is useful if the
remote program does not confirm to the DUP Standard Dialogue. In this case, there is no way for to know that the remote program
has terminated. This command can change the state appropriately.
Restrictions
Execution of some diagnostic and utility programs may interfere with normal activities of the controller. Refer to the appropriate con-
troller documentation set for further specifics.
To use with a HSC-nn controller, first execute the command before connecting. When the connection is established, the "HSC-nn>> " prompt
is displayed. At this point, HSC commands may be entered. When an HSC command completes, one must type
.^Y
to get the "HSC-nn>> " prompt again. To quit, type the command
.abort
to abort the program on the HSC, or
.disconnect
to abort and disconnect. Note that these commands must be preceded by a "." in order to force them to be interpreted by locally, rather
than being passed on to the controller.
The program cannot be run with its input redirected. This has to do with the fact that it has to wait on both the controller, and the user
input, and there is no reliable way to determine when the next line of input from the user should be read and sent to the controller. This
is a limitation of the protocol.
Diagnostics
The utility generates messages when the user does not have the appropriate privileges and when operational errors occur.
Files
Device special files to connect to the driver.
dupterm(8)