Using the DS CLI on an OpenVMS system

To use the DS CLI on an OpenVMS system, you must integrate the required IBMDSCLI$STARTUP.COM and IBMDSCLI$LOGIN.COM procedures.You can also integrate the optional IBMDSCLI$SHUTDOWN.COM procedure. This integration is accomplished when you use the OpenVMS persistent setup procedure.

You must add the required IBMDSCLI$STARTUP.COM procedure to your system startup processes. The IBMDSCLI$STARTUP.COM procedure defines the logical names that are required for the command-line interface in your system logical name table and installs some images with enhanced privileges. This procedure is intended to be invoked during the system startup.

You also must add the required IBMDSCLI$LOGIN.COM procedure to your system login processes. The IBMDSCLI$LOGIN.COM procedure sets up the JRE that is required by the command-line interface and defines the DSCLI command as a foreign DCL command symbol. It is intended to be invoked during the system-wide SYS$MANAGER:SYLOGIN.COM or user-specific SYS$LOGIN:LOGIN.COM procedure.

In order to use the DS CLI interface from start to finish in your OpenVMS system, you can add the optional IBMDSCLI$SHUTDOWN.COM procedure to your system shutdown processes. The IBMDSCLI$SHUTDOWN.COM procedure performs the removal operations for privileged images and undefines system-wide logical names that are associated with the DS CLI. It is intended to be invoked during the system shutdown process.

Integrate the IBMDSCLI$STARTUP.COM procedure into your system startup by adding the following line to the SYS$MANAGER:SYSTARTUP_VMS.COM script: $ @destinationdev:[destinationdir.IBMDSCLI.MGR]IBMDSCLI$STARTUP
destinationdev

Specifies the name of the device that contains the command-line interface installation directory

destinationdir

Specifies the name of the directory where you just installed the command-line interface.

Note: You can alternatively add the IBMDSCLI$STARTUP.COM procedure to the SYSMAN startup database.
Integrate the IBMDSCLI$LOGIN.COM procedure into the system-wide or user-specific login by adding the following line: $@IBMDSCLI$MANAGER:IBMDSCLI$LOGIN.COM
Note: Run the IBMDSCLI$LOGIN.COM procedure only after you have successfully run the IBMDSCLI$STARTUP.COM procedure.
Integrate the IBMDSCLI$SHUTDOWN.COM procedure by adding the following line to the SYS$MANAGER:SYSHUTDOWN.COM script: $@IBMDSCLI$MANAGER:IBMDSCLI$SHUTDOWN
Note: This step is optional. However, processing this step allows your system to make the full use of the DS CLI application.