OpenVMS System Management Utilities Reference Manual

Document revision date: 19 July 1999

OpenVMS System Management Utilities Reference Manual

Contents

Index

FIND

Displays the names of software product kits located in the specified directory.

Format

PRODUCT FIND product-name[,...] [/qualifiers]

Parameter

product-name
Names the product, or list of products to find.

Qualifiers

/BASE_SYSTEM=base-system-name
Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:

FORMAT=
format-type Designates the format of the product kit as follows:

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=kit-type Specifies the type of product kit as follows:

FULL Layered product (application) software.

OPERATING_SYSTEM Operating system software.

MANDATORY_UPDATE A required correction to currently installed software. Functionally 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 (product suite).

TRANSITION Information used to register a product in the product database. This kit does not provide product material.

/LOG

/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs the operation.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces. By default, selects all producers.
/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.
/SPAN_VERSIONS=keyword([,...])
Specifies a range of versions. 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.
/VERSION=version-number
Selects the software product that has the specified version. By default, selects all versions.

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.

INSTALL

Installs one or more software products on your system and updates the product database.

Format

PRODUCT INSTALL product-name[,...] [/qualifiers]

Parameter

product-name
Names the product, or list of products, to install.

Qualifiers

/BASE_SYSTEM=base-system-name
Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.
/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-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.

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.
/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.
/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:

Press the Help key or PF2 key
Type ? and press the Return key

/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:

FORMAT=
format-type Designates the format of the product kit as follows:

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=kit-type Specifies the type of product kit as follows:

FULL Layered product (application) software.

OPERATING_SYSTEM Operating system software.

MANDATORY_UPDATE A required correction to currently installed software. Functionally 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 (product suite).

TRANSITION Information used to register a product in the product database. This kit does not provide product material.

/LOG

/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs the operation.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces. By default, selects all producers.
/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.
/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:
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.
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.
/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.
/SPAN_VERSIONS=keyword([,...])
Specifies a range of versions. 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.
/TEST (default)

/NOTEST
Requests that the POLYCENTER Software Installation utility run the installation verification procedure (IVP) for the product.
/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.
/VERSION=version-number
Selects the software product that has the specified version. By default, selects all versions.
/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.

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.

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]

Parameter

product-name
Names the product, or list of products, whose kit contents are to be listed. This parameter is required.

Qualifiers

/BASE_SYSTEM=base-system-name
Selects software products that are in the named base system. The 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. By default, the operation is performed for products with any base system designation.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:

FORMAT=
format-type Designates the format of the product kit as follows:

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=kit-type Specifies the type of product kit as follows:

FULL Layered product (application) software.

OPERATING_SYSTEM Operating system software.

MANDATORY_UPDATE A required correction to currently installed software. Functionally 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 (product suite).

TRANSITION Information used to register a product in the product database. This kit does not provide product material.

/LOG

/NOLOG (default)
Displays messages as the POLYCENTER Software Installation utility performs an operation.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces. By default, selects all producers.
/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 (...).
/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.
/SPAN_VERSIONS=keyword([,...])
Specifies a range of versions. 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.
/VERSION=version-number
Selects the software product that has the specified version. By default, selects all versions.

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.

Contents

Index

privacy and legal statement

6048PRO_053.HTML

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

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