PRODUCT
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help PRODUCT *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Invokes the POLYCENTER Software Installation utility to perform the
following operations:
o Install, reconfigure, or remove software products.
o Display information from the software product database such as
the names of installed products, the names of patches applied,
product dependencies, the names of files provided by product,
and historical information about past operations.
o List the software product kits from the source directory that
are available for installation.
o Create a software product kit in sequential or reference
format.
o List the contents of a software product kit or extract files
from the kit such as release notes or files you specify.
o Miscellaneous functions such as establishing default
configuration choices offered by a product, copying a product
kit or converting it to a different format, and registering
information about a product in the product database.
Format
PRODUCT [subcommand product-name [/qualifiers]]
| 1 - Parameters |
subcommand
Specifies an operation you want the POLYCENTER Software
Installation utility to perform.
product-name
Specifies the name of the product to which you want to apply
the activity. Some subcommands do not require this parameter.
You can use the asterisk (*) and the percent sign (%) wildcard
characters for all or part of the product-name. You can specify a
list of products separated by commas (,).
| 2 - Description |
To use the POLYCENTER Software Installation utility from the DCL
prompt, enter the PRODUCT command, a subcommand, a product name,
and optional qualifiers. For example:
$ PRODUCT INSTALL COBOL /VERSION=5.3
You can use the PRODUCT commands in command procedure files.
| 3 - CONFIGURE |
Creates a product configuration file (PCF) for one or more
products. Optionally uses the values in an existing PCF file
to create the new PCF.
Format
PRODUCT CONFIGURE product-name[,...] [/qualifiers]
3.1 - Parameter
product-name
Names the product, or list of products, for which product
configuration files will be generated.
3.2 - Qualifiers
3. 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.
3. 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 contains 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-name Uses values from the specified product
configuration file.
OUTPUT=pcf-name Writes configuration choices to the specified
product configuration file. If no file
name is supplied, creates a file named
DEFAULT.PCSI$CONFIGURATION in the current
default directory.
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.
3. 2.3 - /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
3. 2.4 - /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.
3. 2.5 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
3. 2.6 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
3. 2.7 - /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.
3. 2.8 - /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.
3. 2.9 - /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.
3. 2.10 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
3.3 - Example
$ PRODUCT CONFIGURE EDITOR -
_$ /CONFIGURATION=(INPUT=EDITOR_REV1.PCF,OUTPUT=EDITOR_REV2.PCF)
The command in this example reads an existing PCF file named
EDITOR_REV1.PCF for a product named EDITOR and then saves your
changes in EDITOR_REV2.PCF.
| 4 - COPY |
Manipulates a product distribution kit by either creating a
sequential copy from a reference copy, creating a reference copy
from a sequential copy, or creating a copy without changing the
format. You must supply the /DESTINATION qualifier.
Format
PRODUCT COPY product-name/DESTINATION=device-name:[directory-name]
[/qualifiers]
4.1 - Parameter
product-name
Names the product, or list of products, to copy.
4.2 - Qualifiers
4. 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.
4. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies a location where the utility will place a copy of a
sequential kit; for a reference kit, specifies the top-level
directory location where the utility will place files. If the
device name is not provided, it defaults to the user's default
device. If the directory name is omitted, it defaults to the
user's default directory.
The PRODUCT COPY operation ignores the PCSI$DESTINATION logical
name whether or not you use the /DESTINATION qualifier.
4. 2.3 - /FORMAT
/FORMAT=keyword
Specifies the output format of the product kit. Keywords are:
REFERENCE Reference format in which product files are placed
in a directory tree.
SEQUENTIAL Sequential format in which product files are
placed in <full-product-name>.PCSI, a container
file.
The default is to preserve the format of the product kit.
4. 2.4 - /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.
4. 2.5 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
4. 2.6 - /OWNER_UIC
/OWNER_UIC=uic
Specifies the owner user identification code (UIC) for files
created during a copy operation. By default, the user executing
the operation owns the software product files. For example, if
you are logged in to your own account, you can use this qualifier
during a copy operation to assign ownership of the product files
to SYSTEM rather than to your own account. Specify the UIC in
alphanumeric format (in the form [name]) or in octal group-member
format (in the form [g,m]). UIC formats are described in the
OpenVMS User's Manual.
4. 2.7 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
4. 2.8 - /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.
4. 2.9 - /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.
4. 2.10 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
4.3 - Example
$ PRODUCT COPY ABC /SOURCE=[SHERMAN.ABC] -
_$ /DESTINATION=[KITS] /FORMAT=SEQUENTIAL
The command in this example converts product kit ABC, located
in the [SHERMAN.ABC] directory on the user's default device, to
a sequential copy in the [KITS] directory on the user's default
device.
| 5 - EXTRACT |
Retrieves a specified file or files.
5.1 - FILE
Retrieves a user-specified file or files from a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential kit. The original name of the file is preserved when
it is extracted.
Format
PRODUCT EXTRACT FILE product-name[,...] [/qualifiers]
5. 1.1 - Parameter
product-name
Names the product, or list of products, from whose kits the
selected file or files are to be retrieved. This parameter is
required.
5. 1.2 - Qualifiers
5. 1. 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.
5. 1. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place all the
files that the user indicates are to be retrieved. If the device
name is not provided, the default is the user's default device.
If the directory name is omitted, or the /DESTINATION= qualifier
is not specified, the default is the user's default directory.
The EXTRACT FILE operation ignores the PCSI$DESTINATION logical
name whether or not you use the /DESTINATION qualifier.
5. 1. 2.3 - /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.
5. 1. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
5. 1. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
5. 1. 2.6 - /SELECT
/SELECT=filename[,...]
Specifies the name of a file, or a list of files, to be extracted
from the specified sequential kit. You can use the asterisk
(*) and the percent sign (%) wildcard characters for all or
part of the file name. The file name can contain a directory
specification that includes an ellipsis (...). If you omit this
qualifier, all files will be extracted from the specified kit or
kits.
5. 1. 2.7 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
5. 1. 2.8 - /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.
5. 1. 2.9 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
5. 1.3 - Example
$ PRODUCT EXTRACT FILE TEST /SELECT=TEST.EXE /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the file TEST.EXE from the sequential kit of the
product TEST that is in the [AL] directory on the user's
default disk. The extracted file TEST.EXE is placed in the
user's current default directory.
5.2 - PDF
Retrieves the product description file (PDF) from a sequentially
formatted software product kit. A file type of .PCSI denotes
a sequential kit. The file type of the extracted PDF file is
.PCSI$DESCRIPTION.
Format
PRODUCT EXTRACT PDF product-name[,...] [/qualifiers]
5. 2.1 - Parameter
product-name
Names the product, or list of products, whose PDF file is to be
retrieved from the kit.
5. 2.2 - Qualifiers
5. 2. 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.
5. 2. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place the
extracted product description file (PDF). If the device name
is not provided, the default is the user's default device. If
the directory name is omitted, or the /DESTINATION= qualifier is
not specified, the default is the user's default directory. The
EXTRACT PDF operation ignores the PCSI$DESTINATION logical name
whether or not you use the /DESTINATION qualifier.
5. 2. 2.3 - /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.
5. 2. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
5. 2. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
5. 2. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
5. 2. 2.7 - /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.
5. 2. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
5. 2.3 - Example
$ PRODUCT EXTRACT PDF TEST /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the product description file (PDF) from the sequential
kit of the product TEST that is in the [AL] directory on the
user's default disk and places it in the user's current default
directory.
5.3 - PTF
Retrieves the product text file (PTF) from a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential kit. The PTF file is stored in a product kit as a text
library file. The file type of the extracted PTF is .PCSI$TLB.
In addition, a text file version of this text library file is
created with a file type of .PCSI$TEXT.
Format
PRODUCT EXTRACT PTF product-name[,...] [/qualifiers]
5. 3.1 - Parameter
product-name
Names the product, or list of products, whose PTF file is to be
retrieved from the kit.
5. 3.2 - Qualifiers
5. 3. 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.
5. 3. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place the
extracted product text file (PTF). If the device name is not
provided, the default is the user's default device. If the
directory name is omitted, or the /DESTINATION= qualifier is
not specified, the default is the user's default directory. The
EXTRACT PTF operation ignores the PCSI$DESTINATION logical name
whether or not you use the /DESTINATION qualifier.
5. 3. 2.3 - /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.
5. 3. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
5. 3. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
5. 3. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
5. 3. 2.7 - /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.
5. 3. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
5. 3.3 - Example
$ PRODUCT EXTRACT PTF TEST /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
extracts the product text file (PTF) from the sequential kit
of the product TEST that is in the [AL] directory on the user's
default disk and places two files in the user's current default
directory: the extracted text library file (.PCSI$TLB) and a
text file (.PCSI$TEXT) created from the library.
5.4 - RELEASE_NOTES
Retrieves the release notes for the selected product or group of
products. If no output file name is given, the release notes are
written to a file named DEFAULT.PCSI$RELEASE_NOTES in the user's
default directory.
Format
PRODUCT EXTRACT RELEASE_NOTES product-name[,...] [/qualifiers]
5. 4.1 - Parameter
product-name
Names the product, or list of products, from which to extract
release notes.
5. 4.2 - Qualifiers
5. 4. 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.
5. 4. 2.2 - /FILE
/FILE=filespec
Specifies the name of the output file that will contain the
release notes. If no file name is given, the release notes are
written to a file named DEFAULT.PCSI$RELEASE_NOTES in the current
directory.
5. 4. 2.3 - /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.
5. 4. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
5. 4. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
5. 4. 2.6 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
5. 4. 2.7 - /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.
5. 4. 2.8 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
5. 4. 2.9 - /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.
5. 4.3 - Example
$ PRODUCT EXTRACT RELEASE_NOTES XYZ /VERSION=2.3/FILE=[RN]XYZ.TXT
The command in this example places the release notes for
Version 2.3 of the product XYZ in a file named [RN]XYZ.TXT
on your current default device.
| 6 - FIND |
Displays the names of software product kits located in the
specified directory.
Format
PRODUCT FIND product-name[,...] [/qualifiers]
6.1 - Parameter
product-name
Names the product, or list of products to find.
6.2 - Qualifiers
6. 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.
6. 2.2 - /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.
6. 2.3 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
6. 2.4 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
6. 2.5 - /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.
6. 2.6 - /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.
6. 2.7 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
6.3 - Example
$ PRODUCT FIND TEST* /BASE_SYSTEM=VAXVMS
The command in this example searches for all software product
kits located in the user's default directory and displays the
names of all versions of products whose names begin with "TEST"
and are intended to be installed on OpenVMS VAX.
| 7 - INSTALL |
Installs one or more software products on your system and updates
the product database.
Format
PRODUCT INSTALL product-name[,...] [/qualifiers]
7.1 - Parameter
product-name
Names the product, or list of products, to install.
7.2 - Qualifiers
7. 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.
7. 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.
7. 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.
7. 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
7. 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.
7. 2.6 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
7. 2.7 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
7. 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.
7. 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.
7. 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.
7. 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.
7. 2.12 - /TEST
/TEST (default)
/NOTEST
Requests that the POLYCENTER Software Installation utility run
the installation verification procedure (IVP) for the product.
7. 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.
7. 2.14 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
7. 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.
7.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.
| 8 - LIST |
Lists the names of the files contained in a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential kit. All files in a kit are listed unless you use the
/SELECT qualifier to specify a subset of the files.
Format
PRODUCT LIST product-name[,...] [/qualifiers]
8.1 - Parameter
product-name
Names the product, or list of products, whose kit contents are to
be listed. This parameter is required.
8.2 - Qualifiers
8. 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.
8. 2.2 - /FULL
Displays information about files contained in the kit in 132-
column format. The /FULL qualifier shows the name of each file,
gives its size in blocks, and provides a comment field that can
provide additional information-for example, the file is a product
description file, a temporary file, or a module file that updates
a library file. The /NOFULL qualifier displays only the name of
each file in the kit in 80-column format.
8. 2.3 - /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.
8. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs an operation.
8. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
8. 2.6 - /SELECT
/SELECT=filename[,...]
Specifies the name of a file, or a list of files; these files are
in the specified sequential kit. You can use the asterisk (*) and
the percent sign (%) wildcard characters for all or part of the
file name. The file name can contain a directory specification
that includes an ellipsis (...).
8. 2.7 - /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 that the logical name
PCSI$SOURCE defines. If PCSI$SOURCE is not defined, and the
/SOURCE qualifier is not specified, the POLYCENTER Software
Installation utility searches the current default directory.
8. 2.8 - /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.
8. 2.9 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
8.3 - Example
$ PRODUCT LIST TEST /SELECT=TEST.* /SOURCE=[AL]
In this example, the POLYCENTER Software Installation utility
lists all the files that match the selection criteria TEST.*
from the sequential kit of the product TEST that is in the [AL]
directory on the user's default disk.
| 9 - PACKAGE |
Creates a software product kit. This operation uses a product
description file (PDF) and an optional product text file (PTF) to
produce a kit that contains the images and other files that make
up the product.
During a package operation, the POLYCENTER Software Installation
utility reformats the input PDF file to produce a new output
PDF file. Comments are removed from the output PDF file and
information, such as the size of each file, is added. The input
PTF file is transformed into an output PTF in text library
format.
The PRODUCT PACKAGE command requires the /SOURCE, /DESTINATION,
and /MATERIAL qualifiers.
Format
PRODUCT PACKAGE product-name[,...] [/qualifiers]
/SOURCE=file-specification
/DESTINATION=device-name:[directory-name]
/MATERIAL=(path-name[,...])
9.1 - Parameter
product-name
Names the product or list of products to be packaged.
9.2 - Qualifiers
9. 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.
9. 2.2 - /COPY
/COPY(default)
/NOCOPY
Specifies whether you want the product material files and
associated directories included in the product kit. The /NOCOPY
qualifier can save file processing time when you are debugging a
PDF file and do not need to produce a complete product kit.
The use of /NOCOPY with /FORMAT=SEQUENTIAL is not supported and
produces undefined results.
9. 2.3 - /DESTINATION
/DESTINATION=device-name:[directory-name]
If /FORMAT=SEQUENTIAL is specified, /DESTINATION specifies
the directory where the utility creates the sequential kit. A
sequential kit is a container file that includes the PDF, PTF,
and all the images and other material that make up the product.
The file type of the sequential kit file is .PCSI.
If /FORMAT=REFERENCE is specifed (or defaulted), /DESTINATION
specifies the directory where the utility creates the output
PDF file and optional PTF file. The file types of the PDF and
PTF files are .PCSI$DESCRIPTION and .PCSI$TLB, respectively. The
images and other materials that make up the product are placed in
a directory tree under this directory.
If the device name is not provided, it defaults to the user's
default device. If the directory name is omitted, it defaults to
the user's default directory.
The PRODUCT PACKAGE operation ignores the PCSI$DESTINATION
logical name whether or not you use the /DESTINATION qualifier.
9. 2.4 - /FORMAT
/FORMAT=keyword
Specifies the output format of the product kit. Keywords are:
REFERENCE Reference format in which product files are placed
in a directory tree.
SEQUENTIAL Sequential format in which product files are
placed in <full-product-name>.PCSI, a container
file.
The default is /FORMAT=REFERENCE.
9. 2.5 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
9. 2.6 - /MATERIAL
/MATERIAL=(path-name[,...])
Specifies one or more locations in which the utility can search
for product material files to include in the software product
kit. Material files represent the output of the producer's
software engineering process, that is, all files that make up
the software product, including any command procedures that might
be used during installation.
Note that the location of the PDF and PTF are not specified
with the /MATERIAL qualifier. See the /SOURCE qualifier for more
information.
This is a required qualifier for the PRODUCT PACKAGE command.
Parentheses (()) are optional only when you specify a single
path name. They are required when you specify multiple path
names.
The format for path-name is: device-name:[directory-name]
You can specify path-name as:
A specific directory Only one directory is searched.
A root directory A period (.) following the directory name
denotes a root directory specification.
For example, TEST$:[ABC.FT2.] limits
the search path to subdirectories of
[ABC.FT2].
A wildcard directory The directory name includes one or more
of the wildcard characters asterisk (*),
percent sign (%), or ellipsis (...).
All directories that satisfy the wildcard
specification are searched.
Note that when you use either a wildcard directory or a list of
path names, if files in different directories have the same name,
only the first file found in the search path is used.
When either a specific directory or a wildcard directory is
used, the relative file specification on the file statement in
the PDF file is not used to locate the file. However, when a
root directory is used, the utility appends the relative file
specification from the file statement in the PDF to the root
directory in the material search path to locate files.
In general, use of a specific directory or a root directory is
more efficient than using a wildcard directory. When packaging
a product that contains hundreds of files, you might notice
a significant difference in processing time, depending on the
method you use to specify the path name. The choice of material
path name does no affect the time required to install the kit.
9. 2.7 - /OWNER_UIC
/OWNER_UIC=uic
Specifies the owner user identification code (UIC) for files
created during a copy operation. By default, the user executing
the operation owns the software product files. For example, if
you are logged in to your own account, you can use this qualifier
during a copy operation to assign ownership of the product files
to SYSTEM rather than to your own account. Specify the UIC in
alphanumeric format (in the form [name]) or in octal group-member
format (in the form [g,m]). UIC formats are described in the
OpenVMS User's Manual.
9. 2.8 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
9. 2.9 - /SOURCE
/SOURCE=file-specification
Specifies the location of the input PDF file. If the device name
is omitted, it defaults to the user's default device. If the
directory name is omitted, it defaults to the user's default
directory. If the file name and file type components of the file
specification are not provided, they default to <full-product-
name>.PCSI$DESCRIPTION.
The optional PTF file, if used, must be in the same directory and
have the same file name as the PDF with a .PCSI$TEXT file type.
If a file named <full-product-name>.PCSI$TEXT is not found, the
package operation does not use a PTF file.
This is a required qualifier for the PRODUCT PACKAGE command. The
logical name PCSI$SOURCE is not used.
9. 2.10 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
9.3 - Example
$ PRODUCT PACKAGE VIEWER -
_$ /PRODUCER=ABC /FORMAT=SEQUENTIAL/ LOG -
_$ /SOURCE=[JAMES.TEST.PDF] -
_$ /DESTINATION=DKA200:[PCSI_KITS] -
_$ /MATERIAL=BUILD$:[VIEWER0201.RESULT...]
The directory [JAMES.TEST.PDF] contains the PDF named ABC-
AXPVMS-VIEWER-0201-1.PCSI$DESCRIPTION. This file and the
product material files from the BUILD$:[VIEWER0201.RESULT...]
directory tree are used to create the kit for product VIEWER.
When the PACKAGE operation completes, a sequential kit named
ABC-AXPVMS-VIEWER-0201-1.PCSI is created and placed in the
DKA200:[PCSI_KITS] directory.
| 10 - RECONFIGURE |
Modifies the configuration of an installed product by allowing a
user to change installation options.
Reconfiguration of a product might result in the addition or
deletion of files, or both, depending on the user's selection
or deselection of options; that is, users can select options
that were not selected when the product was installed, or they
can deselect options that were selected when the product was
installed. At the conclusion of the operation, the product
database is updated to reflect the changes.
Format
PRODUCT RECONFIGURE product-name[,...] [/qualifiers]
10.1 - Parameter
product-name
Names the product, or list of products, to reconfigure.
10.2 - Qualifiers
10. 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.
10. 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.
10. 2.3 - /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
10. 2.4 - /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.
10. 2.5 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
10. 2.6 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
10. 2.7 - /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.
10. 2.8 - /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.
10. 2.9 - /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.
10. 2.10 - /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.
10. 2.11 - /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.
10. 2.12 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
10. 2.13 - /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.
10.3 - Example
$ DEFINE PCSI$SOURCE DKA500:[DWMOTIF.KIT]
$ PRODUCT RECONFIGURE DWMOTIF /VERSION=V1.2-3
The command in this example enters into a dialog with the user
to change the configuration options for the product DECwindows
Motif Version 1.2-3.
| 11 - REGISTER |
Either records product information in the product database
(REGISTER PRODUCT) or records a volume label change of the volume
containing the installed products (REGISTER VOLUME).
11.1 - PRODUCT
Records information in the product database about one or more
installed products that are not yet registered in the database.
You can use this command to add information to the product
database about products that have been installed by a mechanism
other than the POLYCENTER Software Installation utility, such as
VMSINSTAL. Either a special transition or a full product kit must
be in the source directory to supply details about the product
being registered. The PRODUCT REGISTER PRODUCT command only
updates the product database; it does not copy any files to
your system.
If you do not have a kit available to provide detailed
information about a product, you can use the command procedure
SYS$UPDATE:PCSI$REGISTER_PRODUCT.COM to register the name of
the product and its version, producer, and base system in the
product database. After you register a product using the command
procedure, other products can reference it, and the PRODUCT SHOW
PRODUCT command displays it as an installed product.
Format
PRODUCT REGISTER PRODUCT product-name[,...] [/qualifiers]
11. 1.1 - Parameter
product-name
Names the product, or list of products, to register.
11. 1.2 - Qualifiers
11. 1. 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.
11. 1. 2.2 - /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the location where the installed product resides. 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 uses the location defined by logical name
PCSI$DESTINATION. If this logical name is not defined, the
utility uses the location SYS$SYSDEVICE:[VMS$COMMON], the top-
level directory.
11. 1. 2.3 - /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.
11. 1. 2.4 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
11. 1. 2.5 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
11. 1. 2.6 - /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.
11. 1. 2.7 - /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.
11. 1. 2.8 - /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.
11. 1. 2.9 - /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.
11. 1. 2.10 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
11. 1.3 - Example
$ PRODUCT REGISTER PRODUCT TOOLCHEST /SOURCE=DKB500:[TOOLCHEST.KIT]
The command in this example registers the product TOOLCHEST in
the product database. TOOLCHEST was installed by VMSINSTAL, and
a special transition kit is in the source directory to supply
details about the product.
11.2 - VOLUME
For a volume containing installed products, records a change in
volume label in the product database. This command also records a
change in the physical or logical device name.
Format
PRODUCT REGISTER VOLUME old-volume-label device-name
[/qualifiers]
11. 2.1 - Parameters
old-volume-label
Names the old (existing) volume label.
device-name
Names the device for which the volume label is to be changed in
the product database.
11. 2.2 - Qualifiers
11. 2. 2.1 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
11. 2. 2.2 - /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.
11. 2.3 - Example
$ PRODUCT REGISTER VOLUME AXPVMSV62 DKA0:
The command in this example replaces all occurrences of the old
volume label in the POLYCENTER Software Installation utility
database with the current volume label of the specified disk.
| 12 - REMOVE |
Uninstalls one or more software products from your system and
updates the product database.
Format
PRODUCT REMOVE product-name[,...] [/qualifiers]
12.1 - Parameter
product-name
Names the installed product or list of installed products to
remove.
12.2 - Qualifiers
12. 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.
12. 2.2 - /LOG
/LOG
/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility
performs the operation.
12. 2.3 - /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
12. 2.4 - /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.
12. 2.5 - /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.
12. 2.6 - /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.
12. 2.7 - /VERSION
/VERSION=version-number
Selects software products that have the specified version.
12. 2.8 - /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 the user's login directory.
12.3 - Example
$ PRODUCT REMOVE FTAM
The command in this example uninstalls the product named FTAM
and updates the product database to remove all information
about the product.
| 13 - SHOW |
Displays one of the following:
o A chronological log of operations performed on software
products (SHOW HISTORY)
o Information about objects created during a software product
installation (SHOW OBJECT)
o Information about installed products (SHOW PRODUCT)
o Information about the POLYCENTER Software Installation utility
(SHOW UTILITY)
13.1 - HISTORY
Displays a chronological log of operations performed on the
specified products.
Format
PRODUCT SHOW HISTORY product-name[,...] [/qualifiers]
13. 1.1 - Parameter
product-name
Names the product or list of products to include in the display.
This is an optional parameter. If you omit it, operations
performed on all products will be shown.
13. 1.2 - Qualifiers
13. 1. 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.
Parentheses (()) are optional only when you specify a single
base system name. They are required when you specify multiple
base system names.
13. 1. 2.2 - /BEFORE
/BEFORE=time
Selects entries that were created before the specified date and
time. You can specify time as an absolute time, as a combination
of absolute and delta times, or as one of the following keywords:
TODAY (default)
TOMORROW
YESTERDAY
Refer to the OpenVMS User's Manual for information about
specifying time values.
13. 1. 2.3 - /FULL
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
13. 1. 2.4 - /OPERATION
/OPERATION=(keyword[,...])
Specifies one or more of the following operations as the value
for keyword:
INSTALL
RECONFIGURE
REGISTER_PRODUCT
REGISTER_VOLUME
REMOVE
Parentheses (()) are optional only when you specify a single
keyword. They are required when you specify multiple keywords.
13. 1. 2.5 - /PRODUCER
/PRODUCER=(producer-name[,...])
Selects software products that the specified manufacturer
produces.
Parentheses (()) are optional only when you specify a single
producer name. They are required when you specify multiple
producer names.
13. 1. 2.6 - /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.
13. 1. 2.7 - /SINCE
/SINCE=time
Selects records that were created on or after the specified
date and time. You can specify time as an absolute time, as
a combination of absolute and delta times, or as one of the
following keywords:
TODAY (default)
YESTERDAY
Refer to the OpenVMS User's Manual for information about
specifying time values.
13. 1. 2.8 - /USER
/USER=(username[,...])
Displays information about the products installed, configured, or
removed by the specified user.
Parentheses (()) are optional only when you specify a single
user name. They are required when you specify multiple user
names.
13. 1. 2.9 - /VERSION
/VERSION=(version-number[,...])
Selects software products that have the specified version.
Parentheses (()) are optional only when you specify one version
number. They are required when you specify more than one version
number.
13. 1.3 - Example
$ PRODUCT SHOW HISTORY * /OPERATION=INSTALL /BEFORE=22-MAY-2000
The command in this example lists all the products that were
installed before May 22, 2000.
13.2 - OBJECT
Displays information about objects created during a software
product installation. Examples of software objects are files and
directories.
Format
PRODUCT SHOW OBJECT object-name [/qualifiers]
13. 2.1 - Parameter
object-name
Names the object or list of objects to include in the display.
This is an optional parameter. If you omit it, all objects for
the selected products will be shown.
13. 2.2 - Qualifiers
13. 2. 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.
Parentheses (()) are optional only when you specify a single
base system name. They are required when you specify multiple
base system names.
13. 2. 2.2 - /FULL
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
13. 2. 2.3 - /PRODUCER
/PRODUCER=(producer-name[,...])
Selects software products that the specified manufacturer
produces.
Parentheses (()) are optional only when you specify a single
producer name. They are required when you specify multiple
producer names.
13. 2. 2.4 - /PRODUCT
/PRODUCT=(product-name[,...])
Selects products with the specified product name.
Parentheses (()) are optional only when you specify a single
product name. They are required when you specify multiple product
names.
13. 2. 2.5 - /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.
13. 2. 2.6 - /VERSION
/VERSION=(version-number[,...])
Selects software products that have the specified version.
Parentheses (()) are optional only when you specify one version
number. They are required when you specify more than one version
number.
13. 2.3 - Example
$ PRODUCT SHOW OBJECT * /PRODUCT=ABC /FULL
The command in this example lists all objects such as files,
directories, library modules, and other objects that were
created when the product ABC was installed.
13.3 - PRODUCT
Displays a list of software products installed on your system.
Use the /FULL qualifier to display additional information such as
kit type, maintenance activity, and software dependencies.
Format
PRODUCT SHOW PRODUCT product-name[,...] [/qualifiers]
13. 3.1 - Parameter
product-name
Names the product or list of products to include in the display.
This is an optional parameter. If you omit it, the names of all
installed products will be shown.
13. 3.2 - Qualifiers
13. 3. 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.
Parentheses (()) are optional only when you specify a single
base system name. They are required when you specify multiple
base system names.
13. 3. 2.2 - /FULL
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
13. 3. 2.3 - /MAINTENANCE
/MAINTENANCE=(product-name[,...])
Displays the products to which the named maintenance products
have been applied. A maintenance product is either a patch kit or
a mandatory update kit.
Parentheses (()) are optional only when you specify a single
product name. They are required when you specify multiple product
names.
To list all maintenance products that have been applied to a
particular product, use the following command:
PRODUCT SHOW PRODUCT product-name /FULL
13. 3. 2.4 - /PRODUCER
/PRODUCER=(producer-name[,...])
Selects software products that the specified manufacturer
produces.
Parentheses (()) are optional only when you specify a single
producer name. They are required when you specify multiple
producer names.
13. 3. 2.5 - /REFERENCED_BY
/REFERENCED_BY=(product-name[,...])
Displays products that are referenced by the named product.
Use this qualifier to show if the product, specified in the
/REFERENCED_BY qualifier, has a software dependency on the
product or products specified in the product-name parameter of
the PRODUCT SHOW PRODUCT command. If you specify an asterisk (*)
as the product name, all referenced products are listed for the
product named in the /REFERENCED_BY qualifier.
Parentheses (()) are optional only when you specify a single
product name. They are required when you specify multiple product
names.
To list all products that require a specified product to be
installed, use the command:
PRODUCT SHOW PRODUCT product-name /FULL /REFERENCED_BY=*
To list all products that are referenced by (that is, required
by) a particular product, use the command:
PRODUCT SHOW PRODUCT * /REFERENCED_BY=product-name
To list all products that are referenced by (that is, required
by) other products, use the command:
PRODUCT SHOW PRODUCT * /REFERENCED_BY=*
13. 3. 2.6 - /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.
13. 3. 2.7 - /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.
13. 3. 2.8 - /VERSION
/VERSION=(version-number[,...])
Selects software products that have the specified version.
Parentheses (()) are optional only when you specify one version
number. They are required when you specify more than one version
number.
13. 3.3 - Example
$ PRODUCT SHOW PRODUCT * /REFERENCED_BY=DECNET_OSI
The command in this example lists all products on which the
DECnet-Plus product is dependent.
13.4 - UTILITY
Displays the version of the POLYCENTER Software Installation
utility that you are using.
Format
PRODUCT SHOW UTILITY
13. 4.1 - Parameters
None.
13. 4.2 - Qualifiers
None.
13. 4.3 - Example
$ PRODUCT SHOW UTILITY
POLYCENTER Software Installation utility version: V7.3-100
.
.
.
The command in this example shows the version of the utility
that is executing the command.
|
|
