Compaq DECprint Supervisor (DCPS) for OpenVMS
Software Installation Guide
Previous Contents Index

Note
The IVP does not produce any hardcopy output.

The IVP procedure automatically deletes the temporary queue when the IVP completes. You can print the IVP test files to a real printer later. (Refer to the System Manager's GuideSystem Manager's Guide.)
You can also manually invoke the IVP after the installation by entering: 


$ @SYS$TEST:DCPS$IVP

VMSINSTAL issues an informational message when the IVP is completed: 


        IVP successful for OpenVMS DECprint Supervisor for OpenVMS Software

  • Restart queues.
    VMSINSTAL restarts previously stopped queues if the installation is successful and issues its final messages: 


    %DCPSppp-I-STARTQUEUES, Restarting queues previously reported as active. 
 
        Installation of DCPSppp Vn.n completed at 14:04 
 
        VMSINSTAL procedure done at 14:08 
$

  • Where to go from here.
    Refer to the System Manager's GuideSystem Manager's Guide for instructions on how to create print queues and customize your printing environment.

    Appendix A
    Sample Installation Sessions

    This appendix shows sample installations of the DECprint Supervisor software on both OpenVMS Alpha and VAX systems, with and without the DCPS software already present on the system.

    Example A-1 shows a sample of an initial installation of the DECprint Supervisor software on an OpenVMS Alpha system. Example A-2 shows a sample upgrade of the DECprint Supervisor software on an OpenVMS VAX system.

    Example A-1 Sample Installation on an OpenVMS Alpha System 

    $ @SYS$UPDATE:VMSINSTAL DCPSAXP CDROM: OPTIONS N
 
 
        OpenVMS Alpha Software Product Installation Procedure V7.2-1 
 
 
It is 15-MAR-2001 at 23:02. 
 
Enter a question mark (?) at any time for help. 
 
%VMSINSTAL-W-ACTIVE, The following processes are still active: 
        ANDERSON 
        KAMATH 
        SCHULLMAN 
* Do you want to continue anyway [NO]? Y
* Are you satisfied with the backup of your system disk [YES]? 
 
 
The following products will be processed: 
 
  DCPSAXP V2.0
 
 
        Beginning installation of DCPSAXP V2.0 at 23:02 
 
%VMSINSTAL-I-RESTORE, Restoring product save set A ... 
 
    Release notes included with this kit are always copied to SYS$HELP. 
 
    Additional Release Notes Options: 
 
        1.  Display release notes 
        2.  Print release notes 
        3.  Both 1 and 2 
        4.  None of the above 
 
* Select option [2]: 4
 
* Do you want to continue the installation [NO]? Y
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 
 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
           *                                                       * 
           *     Compaq DECprint Supervisor (DCPS) for OpenVMS     * 
           *                                                       * 
           *    Copyright 1993-2001 Compaq Computer Corporation    * 
           *                  All Rights Reserved                  * 
           *                                                       * 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
 
* Do you want to purge files replaced by this installation [YES]? 
 
* Full definition for DCPS$LAYUP [SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS]]: 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  
    VMI$ROOT:[SYSTEST.DCPS]. 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  
    VMI$ROOT:[SYSHLP.EXAMPLES.DCPS]. 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory  
    VMI$ROOT:[SYSHLP.EXAMPLES.NETPRINT]. 
%DCPSAXP-I-ESTTIME, This installation will take between 1 and 10 minutes. 
%DCPSAXP-I-NOQUEST, No further questions will be asked. 
%VMSINSTAL-I-RESTORE, Restoring product save set B ... 
%VMSINSTAL-I-RESTORE, Restoring product save set C ... 
 
Software installer: 
 
        Starting with DCPS V2.0, the need for DCPS-OPEN and DCPS-PLUS 
        licenses has been eliminated.  The right to use all features of 
        DCPS is now included with the OpenVMS operating system license. 
 
        Please remember to copy SYS$STARTUP:DCPS$STARTUP.TEMPLATE to 
        SYS$STARTUP:DCPS$STARTUP.COM.  Then edit the resulting copy, 
        following the instructions contained within it, to define 
        your DCPS environment and queue characteristics.  When done, 
        execute the file to establish and start the DCPS queues. 
        Also remember to edit SYS$MANAGER:SYSTARTUP_VMS.COM so that 
        DCPS$STARTUP.COM is automatically run at system startup time. 
 
        DCPS$STARTUP.COM should be executed after all printer devices 
        and interconnects are running.  Below is a summary list: 
 
          printers via TCP/IP:      after TCP is started 
          printers via LAT:         after LAT devices are created 
          printers via AppleTalk:   after the AppleTalk driver is loaded 
          PrintServers via DECnet:  after DECnet is started 
 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
%DCPS-I-IVP, Beginning IVP... 
 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
           *                                                       * 
           *          Installation Verification Procedure          * 
           *                                                       * 
           *     Compaq DECprint Supervisor (DCPS) for OpenVMS     * 
           *                                                       * 
           *    Copyright 1993-2001 Compaq Computer Corporation    * 
           *                  All Rights Reserved                  * 
           *                                                       * 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
 
        IVP using Version DCPS V2.0 of DECprint Supervisor 
 
Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 104) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 104) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 104) completed 
Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 105) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 105) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 105) completed 
Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 106) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 106) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 106) completed 
Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 107) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 107) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 107) completed 
Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 108) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 108) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 108) completed 
Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 109) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 109) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 109) completed 
Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 110) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 110)  
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 110) completed 
 
        IVP successful for DECprint Supervisor DCPS V2.0
 
        Installation of DCPSAXP V2.0 completed at 23:04 
 
    Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY 
 
    Creating installation data file: VMI$ROOT:[SYSUPD]DCPSAXP014.VMI_DATA 
 
 
        VMSINSTAL procedure done at 23:05 
 
 
$

    Example A-2 Sample Upgrade on an OpenVMS VAX System 

    $ @SYS$UPDATE:VMSINSTAL DCPSVAX CDROM: OPTIONS N
 
 
        OpenVMS VAX Software Product Installation Procedure V7.2 
 
 
It is 13-MAR-2001 at 12:24. 
 
Enter a question mark (?) at any time for help. 
 
* Are you satisfied with the backup of your system disk [YES]? 
 
 
The following products will be processed: 
 
  DCPSVAX V2.0
 
 
        Beginning installation of DCPSVAX V2.0 at 12:24 
 
%VMSINSTAL-I-RESTORE, Restoring product save set A ... 
 
    Release notes included with this kit are always copied to SYS$HELP. 
 
    Additional Release Notes Options: 
 
        1.  Display release notes 
        2.  Print release notes 
        3.  Both 1 and 2 
        4.  None of the above 
 
* Select option [2]: 4
* Do you want to continue the installation [NO]? Y
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. 
 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
           *                                                       * 
           *     Compaq DECprint Supervisor (DCPS) for OpenVMS     * 
           *                                                       * 
           *    Copyright 1993-2001 Compaq Computer Corporation    * 
           *                  All Rights Reserved                  * 
           *                                                       * 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
 
%DCPSVAX-W-QUEACTIVE, The following DCPS queues are still active: 
 
Queue                     Device                                    Status 
-----                     ------                                    ------ 
LN09                      DAN::LTA9000:                             IDLE 
LN17                      DAN::"AppleTalk/Dan's LN17+ps"            IDLE 
LN40                      DAN::"IP_RawTCP/ln40:6869"                IDLE 
 
%DCPSVAX-I-NUMQUEUES, 4 existing DCPS queues, with 3 active 
 
        Previously installed DCPS queues are still running. 
        Continuing this installation without entering 
        STOP/QUEUE/RESET for each such queue can cause 
        inconsistent behavior among queues and can cause 
        the IVP to fail. 
 
        Note that if you choose to have this installation 
        procedure automatically stop such queues, and the 
        installation subsequently aborts, this procedure 
        will not automatically restart them. 
 
* Do you want these queues automatically stopped and restarted [YES]? 
 
* Do you want to purge files replaced by this installation [YES]? 
 
%DCPSVAX-I-LAYUPDEF, DCPS$LAYUP is already defined 
-DCPSVAX-I-LAYUPDEF, This installation will use its value 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory 
     VMI$ROOT:[SYSTEST.DCPS]. 
%CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.DCPS] already exists 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory 
     VMI$ROOT:[SYSHLP.EXAMPLES.DCPS]. 
%CREATE-I-EXISTS, VMI$ROOT:[SYSHLP.EXAMPLES.DCPS] already exists 
%VMSINSTAL-I-SYSDIR, This product creates system disk directory 
     VMI$ROOT:[SYSHLP.EXAMPLES.DCPS.NETPRINT]. 
%CREATE-I-EXISTS, VMI$ROOT:[SYSHLP.EXAMPLES.DCPS.NETPRINT] already exists 
%DCPSVAX-I-ESTTIME, This installation will take between 1 and 10 minutes, 
-DCPSVAX-I-ESTTIME,  excluding time needed to stop and restart active queues. 
%DCPSVAX-I-NOQUEST, No further questions will be asked. 
%DCPSVAX-I-STOPQUEUES, Stopping queues previously reported as active. 
%VMSINSTAL-I-RESTORE, Restoring product save set B ... 
%VMSINSTAL-I-RESTORE, Restoring product save set C ... 
 
Software installer: 
 
        Starting with DCPS V2.0, the need for DCPS-OPEN and DCPS-PLUS 
        licenses has been eliminated.  The right to use all features of 
        DCPS is now included with the OpenVMS operating system license. 
 
        Please remember to copy SYS$STARTUP:DCPS$STARTUP.TEMPLATE to 
        SYS$STARTUP:DCPS$STARTUP.COM.  Then edit the resulting copy, 
        following the instructions contained within it, to define 
        your DCPS environment and queue characteristics.  When done, 
        execute the file to establish and start the DCPS queues. 
        Also remember to edit SYS$MANAGER:SYSTARTUP_VMS.COM so that 
        DCPS$STARTUP.COM is automatically run at system startup time. 
 
        DCPS$STARTUP.COM should be executed after all printer devices 
        and interconnects are running.  Below is a summary list: 
 
          printers via TCP/IP:      after TCP is started 
          printers via LAT:         after LAT devices are created 
          printers via AppleTalk:   after the AppleTalk driver is loaded 
          PrintServers via DECnet:  after DECnet is started 
 
        If you are converting CPS queues to DCPS, you may want to run 
        the utility SYS$STARTUP:CPS_TO_DCPS_STARTUP.COM instead of 
        editing the startup template.  This utility will read your 
        CPS startup file, change the queue definitions to use DCPS$SMB 
        and its library and logical names, and write out a new DCPS 
        startup file. 
 
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... 
%DCPS-I-IVP, Beginning IVP... 
 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
           *                                                       * 
           *          Installation Verification Procedure          * 
           *                                                       * 
           *     Compaq DECprint Supervisor (DCPS) for OpenVMS     * 
           *                                                       * 
           *    Copyright 1993-2001 Compaq Computer Corporation    * 
           *                  All Rights Reserved                  * 
           *                                                       * 
           * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 
 
        IVP using Version DCPS V2.0 of DECprint Supervisor 
 
Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) completed 
Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44)  
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44) completed 
Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) completed 
Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) completed 
Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) completed 
Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) 
started on DCPS$IVP_TEST 
 
Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) completed 
Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) started on DCPS$IVP_TEST 
%DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) 
      started on DCPS$IVP_TEST 
 
Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) completed 
 
        IVP successful for DECprint Supervisor DCPS V2.0
 
%DCPSVAX-I-STARTQUEUES, Restarting queues previously reported as active. 
 
        Installation of DCPSVAX V2.0 completed at 12:27 
 
 
        VMSINSTAL procedure done at 12:27 
 
 
$

    Appendix B
    System Messages

    This appendix describes the DECprint Supervisor messages in the following sections:

    B.1 System Message Overview

    B.1.1 Message Format

    DECprint Supervisor system messages have one of the following formats:

    %fac-s-ident, text
    -fac-s-ident, text
    Code Meaning
    % The prefix for all primary messages
    - The prefix for all continuation messages
    fac The facility code, which should be DCPS
    s The severity level of the message
    ident An abbreviation of the message text
    text The expanded text of the message

    B.1.2 Severity Level

    The severity levels of DECprint Supervisor system messages are defined as follows:
    Code Meaning
    S Success --- successful completion of the request
    I Informational --- may require user action
    W Warning --- request may not have completed and may require user action
    E Error --- system encountered an error that may be recoverable
    F Fatal --- system encountered a fatal error and cannot continue processing this request

    B.2 DCPS Installation Messages

    The following DCPS message descriptions are alphabetized by the ident portion of the message. The message severity level and text are also shown, while the prefix and facility designation (DCPSppp are omitted. If you receive a message from a facility other than DCPS, refer to the OpenVMS System Messages: Companion Guide for Help Message Users for the message description or use the online help message utility with the command HELP /MESSAGE.

    E-BADSPEC, File spec LPS$SINGLEHOLES.LUP cannot be parsed
    Explanation: The current definition of the logical name DCPS$LAYUP is invalid, possibly because of an incorrect answer given to the question about the location of layup files in an earlier DCPS installation. (DCPS V1.6 and later now validate such responses; see the Release Notes for more information.)
    User Action: Deassign the logical name with the command: 


    $ DEASSIGN /SYSTEM /EXECUTIVE_MODE DCPS$LAYUP

    Then start the DCPS installation again and you will be prompted for the location for the layup files.

    E-BADVMSVER, This product requires OpenVMS version version or later to install
    Explanation: The DCPS software requires a later version of the OpenVMS operating system.
    User Action: Upgrade your operating system to the correct version.

    I-ESTTIME, This installation will take between 1 and 10 minutes, I-ESTTIME, excluding time needed to stop and restart active queues.
    Explanation: This informational message estimates the time it will take to install the software.
    User Action: No action is required.

    W-HIDES, If these files remain, they will be used instead of the W-HIDES, DCPS product files you are installing now, and the IVP
    Explanation: DECprint Supervisor for OpenVMS warns you that the existing DCPS files in SYS$SPECIFIC directories will be used instead of the latest ones.
    User Action: Remove or rename the listed DCPS files from the SYS$SPECIFIC directories.

    E-INVDIRSPE, invalid directory specification
    Explanation: The syntax of the directory specified is not correct.
    User Action: Specify a directory with correct syntax.

    I-LAYUPDEF, DCPS$LAYUP is already defined. I-LAYUPDEF, This installation will use its value.
    Explanation: The installation uses the existing logical name for DCPS$LAYUP.
    User Action: No action is required.

    I-NOHELP, There is no help in this install procedure. I-NOHELP, Please refer to the Software Installation Guide.
    Explanation: This informational messages states that no help is available.
    User Action: Refer to the Software Installation Guide for more information.

    I-NOQUEMGR, System queue manager is not running. I-NOQUEMGR, IVP will NOT be run. Installation continuing.
    Explanation: The queue manager is not running on your system. The installation will continue, but the Installation Verification Procedure cannot run.
    User Action: After the installation, start the queue manager and then manually invoke the IVP ( @SYS$TEST:DCPS$IVP ).

    I-NOQUEST, No further questions will be asked
    Explanation: The VMSINSTAL procedure will continue from this point without requiring further input from you.
    User Action: No action is required.

    W-NORSTRT, Automatically stopped queues have not been restarted
    Explanation: VMSINSTAL has not restarted queues that it automatically stopped.
    User Action: Resolve the problem that caused the installation to terminate abnormally, and then manually restart the queues that the DCPS installation procedure previously listed as active.

    E-NOSUCHDEV, no such device available
    Explanation: The device specified does not exist.
    User Action: Specify a device that exists on your system.

    E-NO_DECC_RTL, DEC C run-time library is not installed.
    Explanation: There is no DEC C run-time library on your system.
    User Action: Install the DEC C/C++ Run-Time Components kit.

    E-NO_QUEMAN, This product requires the queue management facility to install.
    Explanation: The queue manager could not be found. The installation procedure is aborted.
    User Action: Start the queue manager. For information refer to the OpenVMS System Manager's Reference Manual.

    E-NO_SPACE, This product requires number blocks of disk space to install.
    Explanation: There are not enough free disk blocks to install this software. The installation procedure terminates.
    User Action: Ensure that you have at least the specified number of free disk blocks and restart the installation.

    I-NUMQUEUES, existing-number existing DCPS queues, with active-number active.
    Explanation: This message informs you of the number of DCPS queues you have and how many of them are active (that is, not stopped).
    User Action: No action is required.

    W-PURGW, Purging files may leave running queues with no image W-PURGW, file and the IVP may fail.
    Explanation: Purging DCPS files while multistream DCPS symbionts are still active can cause problems.
    User Action: Avoid purging existing files, or stop all active queues before proceeding with the installation.

    I-QSCANNING, Looking for existing DCPS print queues...
    Explanation: This informational message tells you that the installation procedure is checking for print queues that already exist.
    User Action: No action is required.

    W-QUEACTIVE, The following queues are still active:
    Explanation: The installation procedure found some DCPS queues still active, as listed in subsequent lines. If you do not stop the active queues, the installation may fail or interfere with jobs that are currently printing.
    User Action: When subsequently asked, allow VMSINSTAL to automatically stop the queues, or manually stop them yourself and restart the installation procedure. If some of the queues are not in an idle state, you may wish to wait until all jobs have finished printing.

    I-STARTQUEUES, Restarting queues previously reported as active
    Explanation: VMSINSTAL is currently restarting all queues it had previously reported as active.
    Explanation: No action is required.

    I-STOPQUEUES, Stopping queues previously reported as active
    Explanation: VMSINSTAL is currently stopping all queues it had previously reported as active.
    User Action: No action is required.

    W-SYSPF, This system contains DCPS images in SYS$SPECIFIC areas:
    Explanation: Your system has one or more DCPS executable images in a SYS$SPECIFIC directory, as listed in subsequent lines. The new images that you are about to install will not be used because of the presence of the SYS$SPECIFIC versions.
    User Action: Delete or rename the DCPS files in the SYS$SPECIFIC directories, so that new ones in SYS$COMMON will be used.

    F-WRONGARCH, This product will only install on OpenVMS platform.
    Explanation: You have attempted to install the kit on the wrong platform.
    User Action: Install the kit on either an Alpha or VAX platform, as indicated by the message, or use a different kit for the current platform.

    Previous Next Contents Index