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

Previous | Contents | Index

    Choose from the following options:

       1 - Stop the n DCPS queues on this system
       2 - Stop the n DCPS queues in the cluster
       3 - Do not stop any queues (not recommended)

    Enter option: [1]

Make your choice and press `[Return]`.
If you previously chose to display a list of queues that would be stopped, that list is now displayed:

      Queue                      Status  Node    Device
      -----                      ------  ----    ------
      queue-name                 status  node    "protocol/host:port"
      .
      .
      .
      queue-name                 status  node    "protocol/host:port"

- Choose to continue the installation.
  After making your choice, one of the following messages is displayed.
  - If queues are being stopped:

        Do you want to stop the queues and continue the installation? [YES]

  - If queues are not being stopped:

        Do you want to continue the installation? [YES]

  Press `[Return]` to continue or enter NO and press `[Return]` to abort the installation. If you continue, and queues are being stopped, the following messages are displayed:

          If the installation fails, DCPS queues may need to be restarted manually.

      Stopping DCPS queues ...

- Check for files in SYS$SPECIFIC.
  DCPS requires all its files to be installed in SYS$COMMON. Although files can be put in SYS$SPECIFIC for debugging or testing purposes, it is not supported.
  If DCPS images are found in SYS$SPECIFIC, messages similar to the following are displayed:

          This system contains DCPS images in SYS$SPECIFIC:

            disk:[SYSn.SYSEXE]DCPS$SMB.EXE;n

          The existence of DCPS files in SYS$SPECIFIC is not supported.

          If these files remain, they will be used instead of the DCPS product
          files you are installing now, and the IVP may test the wrong or
          mismatched DCPS components.  These files can cause unpredictable DCPS
          behavior on your system.

      Do you want to continue the installation? [NO]

  You should choose to abort the installation by pressing `[Return]`. If you are sure you want to continue, enter YES and press `[Return]` and the installation will continue.
- Specify location for Layup files.
  Next, the installation procedure looks for a definition of the logical name DCPS$LAYUP in the system table in executive mode. This logical name points to the location of DCPS layup files. The default location is SYS$COMMON:[SYSHLP.EXAMPLES.DCPS].
  Although the installation procedure will put new versions of layup files into your site-specific directory if it is already defined, it will not prompt for a new location. If you want your layup files to be in a different directory, usually done so that non-privileged users can modify them, you should manually copy them after the installation is complete and modify the value of DCPS$LAYUP at the bottom of the SYS$STARTUP:DCPS$REQUIRED.COM command procedure.
  - If a definition exists and it is the default location, no messages are displayed.
  - If a definition exists and it is a site-specific one, a message showing its value is displayed:

            Layup files will be copied to disk:[directory].

  - If no definition exists, the default location is used.
  If files cannot be copied to your site-specific DCPS$LAYUP directory (for example, if the directory does not exist) messages similar to the following will be displayed:

          There is a problem with your definition of DCPS$LAYUP.
          Layup files will not be copied to DISK$INVALID:[WOOPS].

- Specify location for spool directory.
  If DCPS V2.5 or later has already been installed, and the startup procedure has been run, the spool directory location has already been specified and this step is skipped.
  The DCPS spool directory is used to store temporary spool files for LPD jobs when the DCPS$SPOOL or DCPS$queue-name_SPOOL logical name is defined. (See the System Manager's GuideSystem Manager's Guide for more information about DCPS LPD spooling.)
  You should specify a device or device and directory that is not on a system disk and that is available to all systems for which DCPS spooling is used. You are asked for a location for the directory, which is always called [DCPS$SPOOL]:

          DCPS, when so configured, will store temporary spool files in directory
          [DCPS$SPOOL].  By default, this directory is created in SYS$COMMON.
          It is recommended that you choose a non-system disk for this directory.

      Enter location for DCPS spool directory: [SYS$COMMON]

  You can answer with either just a device name or a device and directory name. Table 2-1 shows where the spool directory will be created with various answers for its location:

  Table 2-1 Spool Directory Location Examples
  If you answer... | ...the spool file directory will be...
  --- | ---
  `[Return]` (default answer) | SYS$COMMON:[DCPS$SPOOL]
  DISK$USER | DISK$USER:[DCPS$SPOOL]
  SYS$COMMON:[OTHER_FILES] | SYS$COMMON:[OTHER_FILES.DCPS$SPOOL]
  DISK$USER:[DCPS] | DISK$USER:[DCPS.DCPS$SPOOL]

  After answering the question, you verify the directory that will be created:

          The DCPS spool directory will be created at

              disk:[directory]

      Is this correct? [YES]

  Press `[Return]` to accept this location or enter N and press `[Return]` to specify a different location.
- Install the software.
  PCSI displays the following messages indicating its progress in installing DCPS:

      * This product does not have any configuration options.

      Execution phase starting ...

      The following product will be installed to destination:
          HP AXPVMS DCPS V2.5                    DISK$SYS_SARAH:[VMS$COMMON.]

      Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

- Check for alternate destination.
  If DCPS has never been installed on your system using PCSI, or it has been installed and removed, and you specified an alternate destination, you will see these messages:

          You have specified an alternate destination by using the /DESTINATION
          qualifier or defining the logical name PCSI$DESTINATION.

          Since DCPS must reside in cluster common directories, DCPS has has been
          installed using the default destination of SARAH$DKA0:[SYS0.SYSCOMMON.]
          instead of the destination you specified, SARAH$DKB0:[OTHER.].

  This step occurs in between the 90% and 100% done messages.
- Start queues.
  After the DCPS files have been installed, running DCPS queues that were stopped earlier in the installation are now started. If queues were stopped by the installation, the following message is displayed:

      Starting DCPS queues ...

  This step occurs in between the 90% and 100% done messages.
- Verify successful installation.
  The IVP verifies that the software was installed properly. If the system queue manager is running, the IVP runs automatically and the installation procedure 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:

      %PCSI-I-IVPEXECUTE, executing test procedure for HP AXPVMS DCPS V2.5 ...

      Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry n started on DCPS$IVP_TEST
      %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry n)
          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

  PCSI issues an informational message when the IVP is completed:

      %PCSI-I-IVPSUCCESS, test procedure completed successfully

- Create queues and customize your environment.
  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 Session

  Example A-1 shows a sample installation of the DECprint Supervisor software on an OpenVMS I64 system with no previous DCPS queues running. Example A-2 shows a sample installation on an OpenVMS Alpha system in a cluster with running DCPS queues.

  Example A-1 Sample New Installation on an OpenVMS I64 System

      $ PRODUCT INSTALL DCPS /SOURCE=DQA0:[DCPS025.KIT]

         1 - HP AXPVMS DCPS V2.5                 Layered Product
         2 - HP I64VMS DCPS V2.5                 Layered Product
         3 - HP VAXVMS DCPS V2.5                 Layered Product
         4 - All products listed above
         5 - Exit

      Choose one or more items from the menu separated by commas: 2

      The following product has been selected:
          HP I64VMS DCPS V2.5                    Layered Product

      Do you want to continue? [YES] [Return]

      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.

      HP I64VMS DCPS V2.5: HP DECprint Supervisor for OpenVMS

          © Copyright 2005 Hewlett-Packard Development Company, L.P.

      Examining system environment ...

      * This product does not have any configuration options.

      Execution phase starting ...

      Do you want to continue? [YES] [Return]

      The following product will be installed to destination:
          HP I64VMS DCPS V2.5                    DISK$SYS_SARAH:[VMS$COMMON.]

      Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

      The following product has been installed:
          HP I64VMS DCPS V2.5                    Layered Product

      %PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS DCPS V2.5 ...
      %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 150) started on DCPS$IVP_TEST

      Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 150) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 151) started on DCPS$IVP_TEST

      Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 151) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 152) started on DCPS$IVP_TEST

      Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 152) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 153) started on DCPS$IVP_TEST

      Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 153) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 154) started on DCPS$IVP_TEST

      Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 154) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 155) started on DCPS$IVP_TEST

      Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 155) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 156) started on DCPS$IVP_TEST

      Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 156) completed
      %PCSI-I-IVPSUCCESS, test procedure completed successfully

      HP I64VMS DCPS V2.5: HP DECprint Supervisor for OpenVMS

          DCPS Release Notes (text and PostScript) have been provided in SYS$HELP

  Example A-2 Sample Upgrade Installation on an OpenVMS Alpha System

      $ PRODUCT INSTALL DCPS /SOURCE=DQA0:[DCPS025.KIT]

         1 - HP AXPVMS DCPS V2.5                 Layered Product
         2 - HP I64VMS DCPS V2.5                 Layered Product
         3 - HP VAXVMS DCPS V2.5                 Layered Product
         4 - All products listed above
         5 - Exit

      Choose one or more items from the menu separated by commas: 1

      The following product has been selected:
          HP AXPVMS DCPS V2.5                    Layered Product

      Do you want to continue? [YES] [Return]

      The following product will be installed to destination:
          HP AXPVMS DCPS V2.5                    DISK$SYS_JULIE:[VMS$COMMON.]
      The following product will be removed from destination:
          HP AXPVMS DCPS V2.4                    DISK$SYS_JULIE:[VMS$COMMON.]

      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.

      HP AXPVMS DCPS V2.5: HP DECprint Supervisor for OpenVMS

          © Copyright 2005 Hewlett-Packard Development Company, L.P.

      Examining system environment ...

          You should stop all running DCPS queues on this system (JULIE).

      Do you want to see a list of queues that will be stopped? [NO] Y

      Choose from the following options:

         1 - Stop the 15 DCPS queues on this system
         2 - Stop the 171 DCPS queues in the cluster
         3 - Do not stop any queues (not recommended)

      Enter option: [1]

        Queue             Status  Node    Device
        -----             ------  ----    ------
        HP1320_LPD        Idle    JULIE  "IP_LPD/lj1320"
        HP1320_RAW        Idle    JULIE  "IP_RawTCP/lj1320:9100"
        HP2430_LPD        Idle    JULIE  "IP_LPD/lj2430"
        HP2430_LPDREMOTE  Idle    JULIE  "IP_LPD/unixsystem:hp2430_raw"
        HP3800_LPD        Idle    JULIE  "IP_LPD/clj3800"
        HP3800_RAW        Idle    JULIE  "IP_RawTCP/clj3800:9100"
        HP4600_LPD        Idle    JULIE  "IP_LPD/dcpshp4600"
        HP4600_RAW        Idle    JULIE  "IP_RawTCP/dcpshp4600:9100"
        HP4700_RAW        Idle    JULIE  "IP_RawTCP/clj4700:9100"
        HP5200_LPD        Idle    JULIE  "IP_LPD/lj5200"
        HP5200_RAW        Idle    JULIE  "IP_RawTCP/lj5200:9100"
        HP9000MFP_RAW     Idle    JULIE  "IP_RawTCP/hp03026.zko.dec.com:9100"
        HP9000_POD        Idle    JULIE  "IP_RawTCP/hp34hp312.zko.dec.com:9100"
        LN28_LPD          Idle    JULIE  "IP_RawTCP/ln28:9100"
        LN32_LAT          Idle    JULIE  "serial/DCPS_LN32"

      Do you want to stop the queues and continue the installation? [YES] [Return]

          If the installation fails, DCPS queues may need to be restarted manually.

      Stopping DCPS queues ...

          DCPS, when so configured, will store temporary spool files in directory
          [DCPS$SPOOL].  By default, this directory is created in SYS$COMMON.
          It is recommended that you choose a non-system disk for this directory.

      Enter location for DCPS spool directory: [SYS$COMMON] DISK$HELPER

          The following DCPS spool directory will be created:

              DISK$HELPER:[DCPS$SPOOL]

      Is this correct? [YES] [Return]

      * This product does not have any configuration options.

      Execution phase starting ...

      The following product will be installed to destination:
          HP AXPVMS DCPS V2.5                    DISK$SYS_JULIE:[VMS$COMMON.]
      The following product will be removed from destination:
          HP AXPVMS DCPS V2.4                    DISK$SYS_ROUTE2:[VMS$COMMON.]

      Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%

      Starting DCPS queues ...

      ...100%

      The following product has been installed:
          HP AXPVMS DCPS V2.5                    Layered Product
      The following product has been removed:
          HP AXPVMS DCPS V2.4                    Layered Product

      %PCSI-I-IVPEXECUTE, executing test procedure for HP AXPVMS DCPS V2.5 ...
      %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 157) started on DCPS$IVP_TEST

      Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 157) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 158) started on DCPS$IVP_TEST

      Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 158) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 159) started on DCPS$IVP_TEST

      Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 159) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 160) started on DCPS$IVP_TEST

      Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 160) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 161) started on DCPS$IVP_TEST

      Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 161) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 162) started on DCPS$IVP_TEST

      Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 162) completed
      %DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 163) started on DCPS$IVP_TEST

      Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 163) completed
      %PCSI-I-IVPSUCCESS, test procedure completed successfully

      HP AXPVMS DCPS V2.5: HP DECprint Supervisor for OpenVMS

          DCPS Release Notes (text and PostScript) have been provided in SYS$HELP

  Previous | Next | Contents | Index