Name

dupterm − DUP virtual terminal program

Syntax

/usr/etc/dupterm

Description

The DUP virtual terminal program dupterm 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, dupterm prompts the user with "DUP>> ", and waits for a command. dupterm can be in one of three states at any time. When it is started, it is in local state. When it has established a connection to the DUP SYSAP on the remote controller, it is in the connect state. When it starts execution of a diagnostic or utility on the remote controller, it enters the run state. In this state, user typein is normally transmitted to the remote program. To force dupterm 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 dupterm program recognizes the following commands. Commands are case insensitive. The minimum acceptable abbreviation for each command is shown in uppercase.

HelpDisplays a brief description of all commands. 

ABortValid only in run state. Aborts the execution of the remote program. Enters the connect state.

Connect scs-node-name
Valid only in local state. Attempts to establish a connection to the SCS node named scs-node-name. If successful, dupterm enters the connect state. Use the info command to get a list of available SCS nodes.

^ charValid in run state. Sends a control character to the remote program. The space between the "^" and char is ignored.

DIsconnect
Valid only in states connect or run. Breaks the connection. If a remote program was executing, terminates it as well.

DustValid in states connect or run. Issues a GET DUP STATUS command to the connected controller, and displays the results.

INFOValid 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.

QuitQuits the dupterm session.

Runl task-name
Valid only in connect state. Loads the  program task-name from the local media on the controller, and  starts its execution. If successful, dupterm enters the run state. Whether task-name is case-sensitive or not depends on the controller.

RUNS task-or-file-name
Valid only in connect state. Attempts to load the program task-or-file-name first from the file /usr/field/dup/ task-or-file-name.ext, on the local host, and if not found, from the file task-or-file-name, and  starts its execution. ext is the program name extension as returned by the controller. If successful, dupterm enters the connect state.

SEt HSCmode {ON|OFf}
Valid in any state. When HSCMODE is set to ON, dupterm 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 connect or run. Displays the name of the node dupterm 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 dupterm, including which controller it is connected to, and which program it is executing, if any.

SHOw TASk
Valid only in run 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 dupterm 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 dupterm 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 controller documentation set for further specifics. 

To use dupterm with a HSC-nn controller, first execute the command set hsc on 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 dupterm locally, rather than being passed on to the controller.

The dupterm 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 DUP protocol.

Diagnostics

The dupterm utility generates messages when the user does not have the appropriate privileges and when operational errors occur.

Files

/dev/fya<n> Device special files to connect to the driver.