Installing the DS CLI on your OpenVMS system

Use the following steps to install the DS CLI application in your OpenVMS environment.

Before you install the DS CLI application, verify that the prerequisite software and hardware are installed on your system. The installation program checks for prerequisites and stops if any prerequisites are missing.
  1. Log on to your host system as a user with SYSLCK, SYSNAM, SYSPRV, (or a system UIC), TMPMBX, and CMKRNL privileges.
  2. Insert the DS CLI product CD-ROM into the CD drive.
  3. Mount the CD drive. For example, for an IDE CD device DQA0, type the following command: MOUNT /NOASSIST /OVERRIDE=IDENTIFICATION /MEDIA_FORMAT=CDROM DQA0: A message similar to the following is displayed.
    %MOUNT-I-WRITELOCK,volume is write locked					 	
    %MOUNT-I-CDROM_ISO, : (1 of 1) , mounted on VMS1$DQA0:	
    For a SCSI CD device DKA nnn, type the following command: MOUNT /NOASSIST /OVERRIDE=IDENTIFICATION /MEDIA_FORMAT=CDROM DKAnnn: where nnn represents the number that is assigned by the OpenVMS system to your CD device.
  4. Type the following command: DIRECTORY/FULL DQA0:[000000]IBM-AXPVMS-DSCLI-*.PCSI and press Enter to access the command-line interface installation package in the root directory of the CD. Output similar to the following is displayed.
    Directory DQA0:[000000]
    
    IBM-AXPVMS-DSCLI-V0500-01F96-1.PCSI;1    File ID:  (4,7,0) 
    Size:        55.79MB/55.80MB      Owner:    [0,0]
    Created:     9-MAR-2005 04:07:22.25
    Revised:     9-MAR-2005 04:09:43.98 (1)
    Expires:     None specified
    Backup:      No Backup record
    Effective:   None specified
    Recording:   None specified
    Accessed:    None specified
    Attributes:  None specified
    Modified:    None specified
    Linkcount:  1
    File organization:  Sequential
    Shelved state:      Online
    Caching attribute:  Writethrough
    File attributes:    Allocation: 114282, Extend: 0, Global buffer count: 0
                        Version limit: 0, Backups disabled
    Record format:      Undefined, maximum 0 bytes, longest 0 bytes
    Record attributes:  None
    RMS attributes:     None
    Journaling enabled: None
    File protection:    System:RWED, Owner:RWED, Group:RWED, World:RWED
    Access Cntrl List:  None
    Client attributes:  None
    
    
    Total of 1 file, 55.79MB/55.80MB
  5. Type the following command and press Enter to extract the command-line interface for OpenVMS release notes: PRODUCT EXTRACT RELEASE_NOTES DSCLI /SOURCE=DQA:[000000] /FILE=filespec
    Note: If you do not use the /FILE qualifier, the release notes are written to the DEFAULT.PCSI$RELEASE_NOTES file in your current default directory. Read the release notes before continuing to ensure that you are equipped with the information that you need to complete your installation successfully.
  6. Type the following command and press Enter to invoke the command-line interface installation process: PRODUCT INSTALL DSCLI /SOURCE=DQA0:[000000] /DESTINATION=devicename:[directoryname] /RECOVERY_MODE. A message similar to the following is displayed.
    The following product has been selected: 
    	
    	 IBM AXPVMS DSCLI V5.0-1F96  Layered Product
    	
    	Do you want to continue? [YES]

    The /DESTINATION qualifier can be omitted from the command. However, IBM recommends that you use the optional /RECOVERY_MODE qualifier. For a detailed description of all PRODUCT INSTALL command qualifiers and parameters, see the HP OpenVMS System Management Utilities Reference Manual or the OpenVMS online help.

  7. Press Enter to continue the installation process. The following message is displayed.
    Configuration phase starting ...
     
    You will be asked to choose options, if any, for each selected product and for
    any products that may be installed to satisfy software dependency requirements.
     
    IBM AXPVMS DSCLI V5.0-1F96: IBM DS Command Line Interface (DS CLI)
    
        (C) Copyright IBM Corp. 1999, 2005. All Rights Reserved.
    
        International Business Machines Corporation (IBM)
    
        No PAK
    
    Do you want the defaults for all options? []
  8. Type No and press Enter to review the installation options.
    Note: You can type Yes if you have decided to install with the default options.

    The following CLI license message is displayed after typing Yes or No.

    License Agreement IBM System Storage™ DS Command-line Interface
    
       Copyright 2005 International Business Machines Corporation
       All rights reserved.
    
       Use of the IBM System Storage DS Command-line Interface (DS CLI) is
       governed by the IBM Agreement for Licensed Internal Code, a copy
       of which has been provided with your DS Machine.
    
       Answer "Yes" to install the DS CLI code. By installing this code,
       you are certifying that you have read and accept the IBM DS CLI
       License agreement.
    
       Answer "No" to terminate and exit the IBM DS CLI installation.
    
       Do you want to continue? [YES]
  9. Press Enter to accept the DS CLI license agreement. The following Java license message is displayed.
    License Agreement HP Java Run-Time Environment for OpenVMS
    
    The IBM DS CLI requires the Java 1.4.2 Java Runtime Environment (JRE). 
    Installing the DS CLI program automatically installs the required JRE. 
    The installed JRE is the intellectual property of and licensed by 
    Hewlett-Packard Company.
    
    You can view the license agreement on the World Wide Web at:
    
      http://h18012.www1.hp.com/java/download/ovms/1.4.2/
      rte1.4.2_license.html
    
    Answer "Yes" to install the Java code. By installing this code,
    you are certifying that you have read and accepted the HP Java 
    License agreement.
    
    Answer "No" to terminate and exit the IBM DS CLI installation.
    
    
    Do you want to continue? [YES]
  10. Press Enter to accept the Java license agreement. The command-line interface requires Java 1.4.2 on an OpenVMS Alpha host system. If you answer No, the installation process automatically ends and exits. The following library update warning message is displayed.
    WARNING: By default the system Help and Message libraries will be updated.
    
    The IBM DS CLI program provides local Help and Help Message library files. 
    By default, the CLI instalation integrates these local libraries into the 
    OpenVMS system Help and Help Message libraries.
    
    To prevent the system libraries from being modified chose to review the 
    installation options and answer "No" when prompted to update the libraries.
    
    
    Do you want to continue? [YES]
  11. Press Enter to continue the installation process. The following configuration question is displayed.
    Would you like the local IBM DS CLI Help and Help Message libraries to be 
    integrated into the OpenVMS system libraries?
    
    If you answer "Yes", the following OpenVMS libraries will be updated:
    
        SYS$COMMON:[SYSHLP]HELPLIB.HLB
        SYS$COMMON:[SYSHLP]MSGHLP$LIBRARY.MSGHLP$DATA
    
    If you answer "No", OpenVMS system libraries will not be modified.
    
    In every case, local libraries are available under:
    
          IBMDSCLI$HELP:IBMDSCLI_OVR.HLB
          IBMDSCLI$HELP:IBMDSCLI_MESSAGES.MSGHLP$DATA
    
    
    Modify the system Help and Help Message libraries? [YES]
  12. Press Enter to confirm the library update option (or type No and press Enter to deny the library update option). The following confirmation message is displayed:
    Do you want to review the options? [NO]
  13. Press Enter to confirm and accept all selections. The following installation message with completion status is displayed.
    Execution phase starting ...
    
    The following product will be installed to destination:
        IBM AXPVMS DSCLI V5.0-1F96
     DISK$V732_ALPHA:[VMS$COMMON.]
    
    Portion done: 0%...10%...20%...30%...60%...70%...80%...90%...100%
    
    The following product has been installed:
        IBM AXPVMS DSCLI V5.0-1F96             Layered Product
  14. Review the Installation Verification Procedure (IVP) report, which is similar to the following output, and check for possible errors.
    %PCSI-I-IVPEXECUTE, executing test procedure for IBM AXPVMS DSCLI 
    V5.0-1F96 ...
    dscli –ver
    IBM DSCLI Version: 5.0.1.96
    %PCSI-I-IVPSUCCESS, test procedure completed successfully
  15. Ensure that the installation completes. When the Polycenter Software Installation utility finishes the command-line interface installation process, a message similar to the following is displayed.
    IBM AXPVMS DSCLI V5.0-1F96: IBM DS Command Line Interface (DS CLI)
    
        Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM:
            @PCSI$DESTINATION:[IBMDSCLI.MGR]IBMDSCLI$STARTUP.COM
        Insert the following lines in SYS$MANAGER:SYSHUTDWN.COM:
            @IBMDSCLI$MANAGER:IBMDSCLI$SHUTDOWN.COM
    
        Users of this product require the following lines in their login
        command procedure:
            @IBMDSCLI$MANAGER:IBMDSCLI$LOGIN.COM
    
        Release notes for IBM DS CLI available in IBMDSCLI$HELP
  16. Unmount the CD drive and remove the CD-ROM.

The command-line interface provides program startup, login, and shutdown procedures in the [destinationdir.IBMDSCLI.MGR] directory. The installation process runs the startup and login procedures immediately before invoking the IVP procedure. But for persistent setup, you must integrate the startup, login, and shutdown procedures.

Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2004, 2007. All Rights Reserved.