| Previous | Contents | Index |
This appendix describes how to install DECprint Supervisor software using the
VMSINSTAL utility. VMSINSTAL is used to install DCPS on systems running
versions of OpenVMS older than V6.2. If you are not familiar with the
VMSINSTAL utility, refer to the HP OpenVMS System Manager's Manual.
B.1 Overview
Follow the steps in Section 2.1 to prepare for the DCPS installation.
B.2 VMSINSTAL Conventions
VMSINSTAL will prompt you for site-specific information. Questions are preceded by an asterisk (*) and may be followed by default responses enclosed in brackets ([]). Enter your response followed by [Return].
Press [Return] to enter the default response. If you are not sure of the response, enter a question mark (?). VMSINSTAL displays explanatory text and repeats the prompt.
Messages specific to the installation of DECprint Supervisor software are
listed in Section B.4.
B.3 Installing the Software
This section does not reproduce all of the text you may see on your screen during the installation of the DCPS software. Sample VMSINSTAL installation scripts are shown in Section B.5. |
To install the software, use the following procedure:
$ @SYS$UPDATE:VMSINSTAL DCPSpppnnn device-id [OPTIONS N] |
%VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. |
%VMSINSTAL-W-ACTIVE, The following processes are still active:
process-name
|
* Do you want to continue anyway [NO]? |
The above conditions may cause VMSINSTAL to function improperly. In particular, problems may occur with file ownership if you are not logged into the SYSTEM account. |
* Are you satisfied with the backup of your system disk [YES]? |
VMSINSTAL attempts to ensure that a power failure or system crash will not corrupt your system disk. However, for absolute safety we recommend that you back it up before installing new products. Please see the documentation for more information on crashes during installation. |
Please mount the first volume of the set on device-id: * Are you ready? |
The following products will be processed:
DCPSppp Vn.n
Beginning installation of DCPSppp Vn.n at 13:45
%VMSINSTAL-I-RESTORE, Restoring product saveset A
|
Release notes included with this kit are always copied to SYS$HELP.
Additional Release Notes Options:
Release Notes Options:
(1) Display release notes
(2) Print release notes
(3) Both 1 and 2
(4) None of the above
|
Do you want to continue the installation [NO]? |
%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP |
%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
LPS32 DAN::"IP_CPAP/lps32.office.genicom.com" IDLE
%DCPSVAX-I-NUMQUEUES, 4 existing DCPS queues, with 4 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]? |
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. |
%DCPSppp-I-LAYUPDEF, DCPS$LAYUP is already defined -DCPSppp-I-LAYUPDEF, This installation will use its value |
* Full definition for DCPS$LAYUP [SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS]]: |
DISK$USER:[MY-LAYUP-DIR] does not exist. * Create it? [N]? |
%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
|
%DCPSppp-I-NOQUEMGR, System queue manager is not running -DCPSppp-I-NOQUEMGR, IVP will NOT run. Installation continuing ... |
%DCPSppp-I-NOQUEST, No further questions will be asked. |
%DCPSppp-I-STOPQUEUES, Stopping queues previously reported as active. |
VMSINSTAL-I-RESTORE, Restoring product saveset B ... VMSINSTAL-I-RESTORE, Restoring product saveset C ... |
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... |
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
|
The IVP does not produce any hardcopy output. |
$ @SYS$TEST:DCPS$IVP |
IVP successful for OpenVMS DECprint Supervisor Software
|
%DCPSppp-I-STARTQUEUES, Restarting queues previously reported as active.
Installation of DCPSppp Vn.n completed at 14:04
VMSINSTAL procedure done at 14:08
$
|
This appendix describes DECprint Supervisor installation messages.
B.4.1 System Message Overview
DCPS 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 |
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 |
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 HP 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 /EXECUTIVE_MODE /SYSTEM 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: DCPS 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 GuideSoftware 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 HP OpenVMS System Management Utilities 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 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 |