# hp DECprint Supervisor (DCPS) for hp OpenVMS
Software Installation Guide

Previous | Contents | Index

    During this installation, new files will be provided to replace
    existing versions.  You may purge these older versions to save disk
    space, or keep them if you feel they may be of use.  Purging is
    recommended.

- Define DCPS$LAYUP.
  Next, the installation procedure looks for a definition of the logical name DCPS$LAYUP in the system table in executive mode.
  - If a definition exists, the following message is displayed:

        %DCPSppp-I-LAYUPDEF, DCPS$LAYUP is already defined
        -DCPSppp-I-LAYUPDEF, This installation will use its value

  - If a definition does not exist, the procedure asks you for a definition. Press `[Return]` to select the default, SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS], or enter a directory specification where the system layup definition files should be stored.

        * Full definition for DCPS$LAYUP [SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS]]:

    The procedure will validate the definition you provide. If you do not accept the default location and the specified directory does not exist, the procedure will ask you if you want to create it:

        DISK$USER:[MY-LAYUP-DIR] does not exist.

        * Create it? [N]?

    If you answer NO, the procedure will ask again for a definition.
- Create directories.
  VMSINSTAL then attempts to create several directories. If they already exist, it displays additional messages indicating this:

      %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

- Make sure the queue manager is running.
  VMSINSTAL checks to see if the queue manager is running on your system.
  If the queue manager is not present, the Installation Verification Procedure (IVP) does not run, and the following messages are displayed on your screen:

      %DCPSppp-I-NOQUEMGR, System queue manager is not running
      -DCPSppp-I-NOQUEMGR, IVP will NOT run.  Installation continuing ...

  The queue manager must be running if you want the installation to run the IVP.
- Stop queues.
  At this point, VMSINSTAL displays the following message on your screen:

      %DCPSppp-I-NOQUEST, No further questions will be asked.

  VMSINSTAL stops active DCPS queues, if any and if desired.

      %DCPSppp-I-STOPQUEUES, Stopping queues previously reported as active.

- Restore the remaining save sets. As it restores each save set, VMSINSTAL reports on its progress:

      VMSINSTAL-I-RESTORE, Restoring product saveset B ...
      VMSINSTAL-I-RESTORE, Restoring product saveset C ...

  This operation may require up to 10 minutes to complete.
  When all the save sets have been restored, VMSINSTAL instructs you to perform postinstallation procedures. Refer to the System Manager's GuideSystem Manager's Guide for full instructions.
  Next, VMSINSTAL moves the files from the temporary locations used during installation to their permanent directories.

      %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target
      directories...

- Verify a successful software loading procedure.
  The IVP verifies that the software was loaded properly. If the system queue manager is running, the IVP runs automatically and VMSINSTAL performs the following:
  1. Creates a temporary print queue
  2. Queues the test files in [SYSTEST.DCPS] to the temporary print queue DCPS$IVP_TEST
  3. Displays messages similar to the following:

      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

  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 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 AXP Software Product Installation Procedure V7.3-1

      It is 15-JAN-2003 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.2

              Beginning installation of DCPSAXP V2.2 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.

           -------------------------------------------------------------------
           hp DECprint Supervisor (DCPS) for hp OpenVMS
           V2.2 Installation Procedure

           -------------------------------------------------------------------
           © Copyright 1992-2003 Hewlett-Packard Development Company, L.P.

           Confidential computer software.  Valid license from HP and/or its
           subsidiaries required for possession, use or copying.  Consistent
           with FAR 12.211 and 12.212, Commercial Computer Software, Computer
           Software Documentation, and Technical Data for Commercial Items are
           licensed to the U.S. Government under vendor's standard commercial
           license.
           -------------------------------------------------------------------

      * 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].
      %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...

           -------------------------------------------------------------------
           hp DECprint Supervisor (DCPS) for hp OpenVMS
           V2.2 Installation Procedure

           -------------------------------------------------------------------
           © Copyright 1992-2003 Hewlett-Packard Development Company, L.P.

           Confidential computer software.  Valid license from HP and/or its
           subsidiaries required for possession, use or copying.  Consistent
           with FAR 12.211 and 12.212, Commercial Computer Software, Computer
           Software Documentation, and Technical Data for Commercial Items are
           licensed to the U.S. Government under vendor's standard commercial
           license.
           -------------------------------------------------------------------

           IVP using Version V2.2 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 V2.2

              Installation of DCPSAXP V2.2 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.3

      It is 13-JAN-2003 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.2

              Beginning installation of DCPSVAX V2.2 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.

           -------------------------------------------------------------------
           hp DECprint Supervisor (DCPS) for hp OpenVMS
           V2.2 Installation Procedure

           -------------------------------------------------------------------
           © Copyright 1992-2003 Hewlett-Packard Development Company, L.P.

           Confidential computer software.  Valid license from HP and/or its
           subsidiaries required for possession, use or copying.  Consistent
           with FAR 12.211 and 12.212, Commercial Computer Software, Computer
           Software Documentation, and Technical Data for Commercial Items are
           licensed to the U.S. Government under vendor's standard commercial
           license.
           -------------------------------------------------------------------

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

           -------------------------------------------------------------------
           hp DECprint Supervisor (DCPS) for hp OpenVMS
           V2.2 Installation Procedure

           -------------------------------------------------------------------
           © Copyright 1992-2003 Hewlett-Packard Development Company, L.P.

           Confidential computer software.  Valid license from HP and/or its
           subsidiaries required for possession, use or copying.  Consistent
           with FAR 12.211 and 12.212, Commercial Computer Software, Computer
           Software Documentation, and Technical Data for Commercial Items are
           licensed to the U.S. Government under vendor's standard commercial
           license.
           -------------------------------------------------------------------

           IVP using Version V2.2 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 V2.2

      %DCPSVAX-I-STARTQUEUES, Restarting queues previously reported as active.

              Installation of DCPSVAX V2.2 completed at 12:27

              VMSINSTAL procedure done at 12:27

      $

  Previous | Next | Contents | Index