Document revision date: 19 July 1999

17.1 PRODUCT Description

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.

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:

  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.

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

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.

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

---

Previous

Next

Contents

Index

	privacy and legal statement
6048PRO_051.HTML