PRODUCT, INSTALL
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help PRODUCT, INSTALL *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Installs one or more software products on your system and updates
the product database.
Format
PRODUCT INSTALL product-name[,...] [/qualifiers]
| 1 - Parameter |
product-name
Names the product, or list of products, to install.
| 2 - Qualifiers |
2.1 - /BASE_SYSTEM
/BASE_SYSTEM=base-system-name
Selects software products whose base system matches the one
specified. The base system name identifies both a hardware
platform and an operating system. The base system name AXPVMS
denotes an OpenVMS Alpha product, VAXVMS denotes an OpenVMS VAX
product, and VMS denotes a product applicable to either OpenVMS
Alpha or VAX.
2.2 - /CONFIGURATION
/CONFIGURATION=(keyword[,...])
Specifies how the configuration choices will be supplied.
Keywords are:
CURRENT This is the default. It uses values from the
product database, which has the current values
recorded from the last time the product was
installed or reconfigured.
PRODUCER Uses values specified by the software manufacturer
for this version of the product.
INPUT=pcf- Uses values from the specified product
name configuration file.
OUTPUT=pcf- Writes configuration choices to the specified
name product configuration file. If no file
name is supplied, creates a file named
DEFAULT.PCSI$CONFIGURATION.
The keywords CURRENT, PRODUCER, and INPUT are mutually exclusive.
Each of these, however, can be used with the keyword OUTPUT. If
you specify only one keyword, you can omit the parentheses.
2.3 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies a location where the utility will install software
product files. If you omit the device name, the utility uses
your current default device. If you omit the directory name, the
utility uses the [VMS$COMMON] directory as the default directory.
If you do not use this qualifier to specify a destination, the
utility installs the software in the location defined by logical
name PCSI$DESTINATION. If this logical name is not defined, the
utility installs the software in SYS$SYSDEVICE:[VMS$COMMON], the
top-level directory for software product files.
2.4 - /HELP
/HELP
/NOHELP (default)
Controls whether detailed explanations of product options and
informational text are displayed. The first time you install a
product, these explanations can help you decide which options to
select. When you perform subsequent installations or upgrades,
you might choose the brief explanations to save time.
When /NOHELP is selected, you can request a detailed explanation
about a question by performing one of the following actions at
the prompt:
o Press the Help key or PF2 key
o Type ? and press the Return key
2.5 - /KIT_ATTRIBUTES
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT= Designates the format of the product kit as follows:
format-type
REFERENCE Reference format in which product files
exist in a directory tree.
SEQUENTIAL Sequential format in which product files
are placed in <full-product-name>.PCSI,
a container file.
TYPE= Specifies the type of product kit as follows:
kit-type
FULL Layered product (application) software.
OPERATING_ Operating system software.
SYSTEM
MANDATORY_ A required correction to currently
UPDATE installed software. Functionally, this
type of kit is the same as a patch kit.
PARTIAL An upgrade to currently installed
software. Installation of this kit
changes the version of the product.
PATCH A correction to currently installed
software. Installation of this kit does
not change the version of the product.
PLATFORM An integrated set of software products
(also called a product suite).
TRANSITION Used to register information about
a product that is installed but not
recorded in the product database
(for example, a product installed by
VMSINSTAL). This kit does not provide
product material.
2.6 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
2.7 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
2.8 - /REMARK
/REMARK=string
Records a comment in the product database about the task you
are performing. The SHOW HISTORY command displays the recorded
comments. For each product, the POLYCENTER Software Installation
utility stores a chronological list of tasks you perform and the
associated remarks. The default behavior is that no remark is
recorded.
2.9 - /REMOTE
/REMOTE
/NOREMOTE (default)
Uses the product database on a system other than the currently
running system. This qualifier is primarily for use in command
procedures that Compaq supplies. Incorrect use of this qualifier
can corrupt the POLYCENTER Software Installation utility
database, corrupt installed products, or cause other problems.
In some cases, /REMOTE can be useful with the CONFIGURE and SHOW
commands.
When you use /REMOTE, the following logical names must be
defined:
o PCSI$SYSDEVICE must specify the physical disk name of the
target system disk. This disk must be mounted and allocated to
the process executing the PRODUCT command.
o PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE.
It must be defined in the following form, where x is a valid
system root:
PCSI$SYSDEVICE:[SYSx.]
Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC
specify only where the utility will find or place its database.
These logical names do not affect the /DESTINATION qualifier.
2.10 - /SOURCE
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for
the software product kit or kits. If /SOURCE is not specified,
the utility searches in the location defined by the logical
name PCSI$SOURCE. If PCSI$SOURCE is not defined, and the /SOURCE
qualifier is not specified, the POLYCENTER Software Installation
utility searches the current default directory.
2.11 - /SPAN_VERSIONS
/SPAN_VERSIONS=keyword([,...])
Selects software products whose versions match the specified
version criteria. The keywords are:
ABOVE=version Selects versions greater than the version
specified
BELOW=version Selects versions less than the version specified
MINIMUM=version Selects versions greater than or equal to the
version specified
MAXIMUM=version Selects versions less than or equal to the
version specified
The ABOVE, BELOW, MINIMUM, and MAXIMUM keywords
can be used alone or in combination. For example,
/SPAN_VERSIONS=(MINIMUM=V2.1,BELOW=V3.0) selects versions greater
than or equal to V2.1 and less than (but not including) V3.0.
Using the MAXIMUM keyword instead of BELOW would select versions
that include V3.0.
2.12 - /TEST
/TEST (default)
/NOTEST
Requests that the POLYCENTER Software Installation utility run
the installation verification procedure (IVP) for the product.
2.13 - /TRACE
/TRACE
/NOTRACE (default)
Displays all DCL commands that the POLYCENTER Software
Installation utility may execute while performing the operation.
Any output generated by these commands is also displayed. This
qualifier is a debugging aid to trace the execution of DCL
commands and command procedures executed in a subprocess.
2.14 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
2.15 - /WORK
/WORK=device:[directory]
Specifies the name of the device and directory acting as a
temporary work area. By default, temporary files are created
in subdirectories of the user's login directory.
| 3 - Example |
$ PRODUCT INSTALL POSIX/VERSION=3.0 /CONFIGURATION=OUTPUT=POSIX.PCF
The command in this example installs POSIX Version 3.0 and
creates a product configuration file.
|
|
