![[OpenVMS documentation]](../../images/openvms_doc_banner_top.gif)
|
![[Site home]](../../images/buttons/bn_site_home_off.gif)
![[Send comments]](../../images/buttons/bn_comments_off.gif)
![[Help with this site]](../../images/buttons/bn_site_help_off.gif)
![[How to order documentation]](../../images/buttons/bn_order_docs_off.gif)
![[OpenVMS site]](../../images/buttons/bn_openvms_off.gif)
![[Compaq site]](../../images/buttons/bn_compaq_off.gif)
|
|
Updated:
11 December 1998
|
OpenVMS System Management Utilities Reference
Manual
Chapter 17
POLYCENTER Software Installation Utility
17.1 PRODUCT Description
The POLYCENTER Software Installation utility installs or removes layered software products,
registers products, sets up configuration choices offered by products,
and extracts a product's release notes.
17.2 PRODUCT Usage Summary
The POLYCENTER Software Installation utility installs, removes, and performs other operations on
layered software products.
Format
PRODUCT [subcommand product-name [/qualifiers]]
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 (,).
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.
17.3 PRODUCT Commands
The following table describes PRODUCT commands.
| Command |
Description |
|
CONFIGURE
|
Creates a product configuration file (PCF)
|
|
COPY
|
Copies a software product kit or converts it to another format
|
|
EXTRACT FILE
|
Retrieves a specified file or files from a software product kit
packaged in sequential format
|
|
EXTRACT PDF
|
Retrieves the product description file (PDF) from a software product
kit packaged in sequential format
|
|
EXTRACT PTF
|
Retrieves the product text file (PTF) from a software product kit
packaged in sequential format
|
|
EXTRACT RELEASE_NOTES
|
Retrieves the release notes for a selected product
|
|
FIND
|
Displays the name of product kits found in a specified directory
|
|
INSTALL
|
Installs one or more software products and updates the product database
|
|
LIST
|
Lists a file or files contained in a specified product kit that is
packaged in sequential format
|
|
PACKAGE
|
Creates a software product kit.
|
|
RECONFIGURE
|
Modifies the configuration choices for an installed product and updates
the product database
|
|
REGISTER PRODUCT
|
Records product information in the product database
|
|
REGISTER VOLUME
|
Records a volume label change of the volume containing the installed
products
|
|
REMOVE
|
Removes a product from the system and from the product database
|
|
SHOW HISTORY
|
Displays in chronological order the operations performed on software
products
|
|
SHOW OBJECT
|
Displays information about objects created during software product
installation
|
|
SHOW PRODUCT
|
Displays information about installed products
|
|
SHOW UTILITY
|
Displays information about the POLYCENTER Software Installation utility
|
CONFIGURE
Creates a product configuration file (PCF) for one or more products.
Optionally uses the values in an existing PCF to create the new PCF.
Format
PRODUCT CONFIGURE product-name[,...] [/qualifiers]
Parameter
product-name
Names the product, or list of products, for which product configuration
files will be generated.
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
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.
/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.
/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:
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.
/VERSION=version-number
Selects the software product that has the specified version. By
default, selects all versions.
Example
|
$ PRODUCT CONFIGURE EDITOR -
_$ /CONFIGURATION=(INPUT=EDITOR_REV1.PCF,OUTPUT=EDITOR_REV2.PCF)
|
The command in this example reads an existing PCF named EDITOR_REV1.PCF
for a product named EDITOR and then saves your changes in
EDITOR_REV2.PCF.
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]
Parameter
product-name
Names the product, or list of products, to copy.
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.
/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.
/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.
/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.
/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.
/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 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.
EXTRACT 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]
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.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products that are in the named base system. 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.
/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.
/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, 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 extract
from the specified kit or kits.
/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
|
![[OpenVMS documentation]](../../images/openvms_doc_banner_bottom.gif)