HP OpenVMS Systems Documentation

HP OpenVMS DCL Dictionary

Connects your terminal to a storage controller through the appropriate bus for that controller. The /SERVER and /TASK qualifiers are required.

For use only with storage controllers. Requires the DIAGNOSE privilege.

Format

SET HOST/DUP/SERVER=server-name

/TASK=task-name node-name

Parameter

node-name

Specifies the node name of the storage controller.

Description

The SET HOST/DUP command creates a virtual terminal connection and executes a utility or diagnostic program on a storage controller that uses the Diagnostic and Utilities Protocol (DUP) Standard Dialogue.

Once the connection is established, operations are performed under the control of the utility or diagnostic program.

When the utility or diagnostic program terminates, control is returned to the local system.

To abort or prematurely terminate the connection and return control to the local system, press Ctrl/\.

Further information regarding the operation of the utility and diagnostic programs available on a particular controller may be obtained from the appropriate documentation set for that controller.

Preparing for Use

To use the SET HOST/DUP facility, you must first install FYDRIVER, the DUP class driver. To load FYDRIVER, add the following commands to the SYSTARTUP.COM command procedure in the SYS$MANAGER directory.

On Alpha, specify the following commands:

$ RUN SYS$SYSTEM:SYSMAN SYSMAN> IO CONNECT FYA0/NOADAPTER/DRIVER=SYS$FYDRIVER

On VAX, specify the following commands:

$ RUN SYS$SYSTEM:SYSGEN SYSGEN> CONNECT FYA0/NOADAPTER

This operation requires CMKRNL (change mode to kernel) privilege.

Qualifiers

/LOG[=filespec]

/NOLOG (default)

Controls whether a log file of the entire session is kept. If you use the /LOG qualifier without the file specification, the log information is stored in the file HSCPAD.LOG.

/SERVER=server-name

Specifies the server name for the target storage controller.

This qualifier is required.

/TASK=task-name

Specifies the utility or diagnostic name to be executed on the target storage controller under direction of the server.

This qualifier is required.

Example

$ SET HOST/DUP/SERVER=MSCP$DUP/TASK=DIRECT R2DH5Y
%HSCPAD-I-LOCPROGEXE, Local program executing - type ^\ to exit utility
      

The SET HOST/DUP command in this example connects the user terminal to the utility program called DIRECT executing on a storage controller named R2DH5Y under direction of the MSCP$DUP server.