1 PRODUCT Invokes the POLYCENTER Software Installation utility to perform the following operations: o Install and reconfigure software products. o 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, compressed, 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 Perform other operations 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. o Uninstall the last patch or set of patches applied to a product. Format PRODUCT [subcommand product-name [/qualifiers]] 2 Parameters subcommand Specifies an operation you want the POLYCENTER Software Installation utility to perform. If you do not supply a subcommand, the utility prompts you to select one from a list. 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 (,). The product name is the same as the third component of the file name of the product kit. For example, the product name parameter that you would use to refer to a kit named DEC-AXPVMS- FORTRAN-V0702-3-1.PCSI is FORTRAN. A product name can include an underscore character (_) but never a hyphen (-). For example, VMS73_DRIVER is the name of a remedial kit for OpenVMS whose file name is DEC-AXPVMS-VMS73_DRIVER-V0300-4.PCSI. 2 Description To use the POLYCENTER Software Installation utility from the DCL prompt, enter the PRODUCT command, a subcommand, and any required parameters and optional qualifiers. For example: $ PRODUCT INSTALL FORTRAN /VERSION=V7.2-3 /SOURCE=DISK1:[KITS] This command installs FORTRAN V7.2-3 on your system from a product kit located in DISK1:[KITS]. 2 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 Parameter product-name Names the product, or list of products, for which product configuration files will be generated. 3 Qualifiers /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. /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. /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 /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specification of the configuration file that is created. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /REMOTE /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. 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.] /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 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. 2 COPY Copies or converts one or more existing product kits that you specify to product kits in the format you request. For example, you can create a kit in reference format from a kit in sequential format, create a compressed kit from a kit in sequential format, or simply copy a kit to a new location without changing its format. You cannot create a kit in compressed format directly from a kit in reference format. If you do not have a kit in sequential format, you must first use the PRODUCT PACKAGE command to create a sequential kit from the product materials. Then you can use the PRODUCT COPY command to convert it to compressed format. Use the /FORMAT qualifier to determine the format of the product kits that you create. Use the /KIT_ATTRIBUTES=FORMAT qualifier to select kits of a particular format to be copied or converted. Format PRODUCT COPY product-name /DESTINATION=device-name:[directory-name] [/qualifiers] 3 Parameter product-name Names the product, or list of products, to copy. 3 Qualifiers /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. /DESTINATION /DESTINATION=device-name:[directory-name] Specifies a location where the utility will create the sequential or compressed kit. For a reference kit, specifies the top-level directory location where the utility will place files. If you do not provide a device name, the default is the user's default device. If you omit the directory name, the default is the user's default directory. The PRODUCT COPY operation ignores the PCSI$DESTINATION logical name whether or not you use the /DESTINATION qualifier. /FORMAT /FORMAT=keyword Specifies the output format of the product kit. Keywords are: COMPRESSED Compressed format in which a data compression technique is applied to a sequential kit to produce a .PCSI$COMPRESSED file, which is the compressed form of a sequential kit. REFERENCE Reference format in which product files are placed in a directory tree for direct access. The utility creates a product description file, with a file type of .PCSI$DESCRIPTION, in the top level of the directory tree. SEQUENTIAL Sequential format in which product files are placed in a container file having a .PCSI file type. The default is to preserve the format of the product kit. You must use this qualifier if you want to change the format of the product kit. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specification of the product kit file that is created and the files packaged in the kit. /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. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 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. 2 DELETE 3 RECOVERY_DATA Deletes one or more patch recovery data sets in order of creation date, starting with the oldest one first. A recovery data set is created when a patch kit is successfully installed with the /SAVE_RECOVERY_DATA qualifier. Recovery data sets are used to uninstall patches when you use the PRODUCT UNDO PATCH command. Note that once patch recovery data is deleted, you cannot uninstall any patch that is associated with this data. Installed patches are not affected when you use the PRODUCT DELETE RECOVERY_DATA command. Format PRODUCT DELETE RECOVERY_DATA [/qualifiers] 4 Parameters None. 4 Qualifiers /ALL /ALL (default) Selects all patch recovery data sets to be deleted. The recovery data is deleted in the order it was created, starting with the oldest set first. If you omit this qualifier from the command line, the effect is the same as if you specified it. /BEFORE /BEFORE=time Selects patch recovery data sets 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. /LOG /LOG /NOLOG (default) Displays the file specifications of the files within the recovery data sets that are being deleted. /OLDEST /OLDEST=count Specifies the number of oldest recovery data sets that you want to delete. For example, if you specify /OLDEST=2, the PRODUCT DELETE RECOVERY_DATA command deletes the two oldest recovery data sets. If you do not specify a number with this qualifier, the default value is 1. /REMOTE /REMOTE /NOREMOTE (default) Selects recovery data sets located on a privately mounted system disk. By default, this utility searches the currently booted system disk for recovery data sets. 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.] 4 Example $ PRODUCT DELETE RECOVERY_DATA /OLDEST=2 The command in this example deletes the two oldest recovery data sets starting with the one that was created first, followed by next oldest recovery data set. If, for example, three patch recovery data sets are on the system disk, you still have one set preserved after this operation completes. Remember that once a patch recovery data set is deleted, you cannot uninstall the patch kit associated with the deleted recovery data. The installed patch kits, however, are not affected by this action. 2 EXTRACT Retrieves a specified file or files. 3 FILE Retrieves a user-specified file or files from a sequentially formatted software product kit. A file type of .PCSI indicates a sequential kit. The original name of the file is preserved when it is extracted. Format PRODUCT EXTRACT FILE product-name[,...] [/qualifiers] 4 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. 4 Qualifiers /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. /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specifications of the files that are extracted from the kit. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 4 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. 3 PDF Retrieves the product description file (PDF) from a sequentially formatted software product kit. A file type of .PCSI indicates a sequential kit. The file type of the extracted PDF file is .PCSI$DESCRIPTION. Format PRODUCT EXTRACT PDF product-name[,...] [/qualifiers] 4 Parameter product-name Names the product, or list of products, whose PDF file is to be retrieved from the kit. 4 Qualifiers /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. /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specification of the product description file that is created. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 4 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. 3 PTF Retrieves the product text file (PTF) from a sequentially formatted software product kit. A file type of .PCSI indicates 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] 4 Parameter product-name Names the product, or list of products, whose PTF file is to be retrieved from the kit. 4 Qualifiers /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. /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specifications of the product text and product text library files that are created. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 4 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. 3 RELEASE_NOTES Retrieves the release notes for the selected product or group of products. The name of each release notes file is preserved unless you override it with the /FILE qualifier. Format PRODUCT EXTRACT RELEASE_NOTES product-name[,...] [/qualifiers] 4 Parameter product-name Names the product, or list of products, from which to extract release notes. 4 Qualifiers /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. /FILE /FILE=filespec Specifies the name of the output file that will contain the release notes. If no file name is given, the original name of the release notes file is preserved and the file is written to your default directory. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specification of the release notes file that is created. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. /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. 4 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. 2 FIND Displays the names of software product kits located in the specified directory. Format PRODUCT FIND product-name[,...] [/qualifiers] 3 Parameter product-name Names the product, or list of products to find. 3 Qualifiers /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 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. 2 INSTALL Installs one or more software products on your system and updates the product database. You can also use this command to install patch and mandatory update kits that modify previously installed products. To uninstall complete products, including any patches or mandatory updates that might have been applied to them, use the PRODUCT REMOVE command. To uninstall patches or mandatory updates while still retaining the original product that was installed, use the PRODUCT UNDO PATCH command. However, to use this command, you must use the /SAVE_RECOVERY_DATA qualifier on the PRODUCT INSTALL command when you install these patches and mandatory updates. Format PRODUCT INSTALL product-name[,...] [/qualifiers] 3 Parameter product-name Names the product, or list of products, to install. 3 Qualifiers /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. /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-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 /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 /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 /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specifications of files as they are accessed; also provides other information related to file activity. For example, when logging is enabled, messages notify you when product files, libraries, directories, temporary files, and product database files are created, deleted, or modified. Information is also provided about disk space consumption and any file conflict resolution. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /RECOVERY_MODE /RECOVERY_MODE /NORECOVERY_MODE (default) Allows you to perform product installation in recovery mode. When you use this qualifier, the directories, files, and modules that are modified, deleted, or removed in the installation process are saved in a directory tree on the system disk. These files, along with a copy of the product database, comprise the recovery data set. The recovery data set is handled somewhat differently when an installation ends successfully or if it terminates, at some point, unsuccessfully. o If an installation terminates in its execution phase, either voluntarily (by using Ctrl/Y or Ctrl/C) or involuntarily (because of a fatal error), the saved recovery data is used to roll back all the displaced objects in an attempt to reinstate the product environment prior to the interrupted operation. Then the recovery data set is deleted. o At the end of a successful installation of one or more full, platform, or partial kits, the recovery data set is automatically deleted. o At the end of a successful installation of one or more patch or mandatory update kits, the recovery data set is automatically deleted unless you specify the /SAVE RECOVERY_ DATA qualifier. This qualifier retains the recovery data set for possible future use with the PRODUCT UNDO PATCH command. /REMARK /REMARK=string Records a comment in the product database about the task you are performing. The PRODUCT 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 /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. This qualifier is primarily for use in command procedures that HP supplies. Incorrect use of this qualifier can create an inconsistency in the product database or cause subsequent PRODUCT commands to fail. 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.] /SAVE_RECOVERY_DATA /SAVE_RECOVERY_DATA /NOSAVE_RECOVERY_DATA (default) This qualifier applies only to patch and mandatory update kit installation. It is ignored when other types of products are installed. This qualifier causes all the directories, files, and modules that are modified, deleted, or removed in the process of installation to be saved in a directory tree on the system disk. These files, along with a copy of the product database, comprise the recovery data set. This recovery data set can be used later to uninstall patch and mandatory update kits by using the PRODUCT UNDO PATCH command. Note that the /SAVE_RECOVERY_DATA qualifier automatically enables recovery mode operation even if you do not explicitly specify the /RECOVERY_MODE qualifier. /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. /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. /TEST /TEST (default) /NOTEST Requests that the POLYCENTER Software Installation utility run the installation verification procedure (IVP) for the product. /TRACE /TRACE /NOTRACE (default) Identifies DCL commands and command procedures that are run in a subprocess during the execution of the PRODUCT command. Any output from these commands is also displayed. This qualifier is primarily a debugging aid for product developers to trace the execution of non-interactive command procedures embedded in their product kits. This qualifier is not useful for command procedures running in interactive mode. See the POLYCENTER Software Installation Utility Developer's Guide for more information. /VERSION /VERSION=version-number Selects software products that have the specified version. /WORK /WORK=device:[directory] Specifies the name of the device and directory acting as a temporary work area. By default, temporary files are created in subdirectories of the user's login directory. 3 Example $ PRODUCT INSTALL POSIX/VERSION=3.0 /CONFIGURATION=OUTPUT=POSIX.PCF The command in this example installs POSIX Version 3.0 and creates a product configuration file. 2 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] 3 Parameter product-name Names the product, or list of products, whose kit contents are to be listed. This parameter is required. 3 Qualifiers /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. /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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 (...). /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 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. 2 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 can create a product kit in either sequential or reference format. To create a kit in compressed format, first use the PRODUCT PACKAGE command to create a kit in sequential format. Then use the PRODUCT COPY command to convert this sequential kit to a kit in compressed 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[,...]) 3 Parameter product-name Names the product or list of products to be packaged. 3 Qualifiers /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. /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. /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. /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 for direct access. The utility creates a product description file, with a file type of .PCSI$DESCRIPTION, in the top level of the directory tree. SEQUENTIAL Sequential format in which product files are placed in a container file having a .PCSI file type. The default is /FORMAT=REFERENCE. /LOG /LOG /NOLOG (default) Displays the file specifications of the files that are packaged in the product kit and the name of the product kit file. /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 Only one directory is searched. directory Root A period (.) following the directory name directory indicates a root directory specification. For example, TEST$:[ABC.FT2.] limits the search path to subdirectories of [ABC.FT2]. Wildcard The directory name includes one or more of the directory 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. /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. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /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 .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 .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. /VERSION /VERSION=version-number Selects software products that have the specified version. 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. 2 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] 3 Parameter product-name Names the product, or list of products, to reconfigure. 3 Qualifiers /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. /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-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. /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 /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specifications of files as they are accessed; also provides other information related to file activity. For example, when logging is enabled, messages notify you when product files, libraries, directories, temporary files, and product database files are created, deleted, or modified. Information is also provided about disk space consumption and any file conflict resolution. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /RECOVERY_MODE /RECOVERY_MODE /NORECOVERY_MODE (default) Allows you to perform product reconfiguration in recovery mode. When you use this qualifier, the directories, files, and modules that are modified, deleted, or removed in the reconfiguration process are saved in a directory tree on the system disk. These files, along with a copy of the product database, comprise the recovery data set. The recovery data set is handled somewhat differently when a reconfiguration ends successfully or if it terminates, at some point, unsuccessfully. o If a reconfiguration terminates in its execution phase, either voluntarily (by using Ctrl/Y or Ctrl/C) or involuntarily (because of a fatal error), the saved recovery data is used to roll back all the displaced objects in an attempt to reinstate the product environment prior to the interrupted operation. Then the recovery data set is deleted. o At the end of a successful reconfiguration, the recovery data set is automatically deleted. /REMARK /REMARK=string Records a comment in the product database about the task you are performing. The PRODUCT 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 /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. This qualifier is primarily for use in command procedures that HP supplies. Incorrect use of this qualifier can create an inconsistency in the product database or cause subsequent PRODUCT commands to fail. 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.] /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. /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. /TRACE /TRACE /NOTRACE (default) Identifies DCL commands and command procedures that are run in a subprocess during the execution of the PRODUCT command. Any output from these commands is also displayed. This qualifier is primarily a debugging aid for product developers to trace the execution of non-interactive command procedures embedded in their product kits. This qualifier is not useful for command procedures running in interactive mode. See the POLYCENTER Software Installation Utility Developer's Guide for more information. /VERSION /VERSION=version-number Selects software products that have the specified version. /WORK /WORK=device:[directory] Specifies the name of the device and directory acting as a temporary work area. By default, temporary files are created in subdirectories of the user's login directory. 3 Example $ 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. 2 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). 3 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 kit 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] 4 Parameter product-name Names the product, or list of products, to register. 4 Qualifiers /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. /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. /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 COMPRESSED Compressed format in which a data compression technique has been applied to a sequential kit. A compressed kit has a .PCSI$COMPRESSED file type. REFERENCE Reference format in which product files exist in a directory tree. A .PCSI$DESCRIPTION file in the top level of the directory tree denotes a reference kit. SEQUENTIAL Sequential format in which product files are placed in a container file. A file type of .PCSI indicates a sequential kit. 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. /LOG /LOG /NOLOG (default) Displays the file specifications of the product database files that are created or modified. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /REMARK /REMARK=string Records a comment in the product database about the task you are performing. The PRODUCT 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 /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. This qualifier is primarily for use in command procedures that HP supplies. Incorrect use of this qualifier can create an inconsistency in the product database or cause subsequent PRODUCT commands to fail. 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.] /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. /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. /VERSION /VERSION=version-number Selects software products that have the specified version. 4 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. 3 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. Note that if you use the SET VOLUME command to change the volume label of a device that has installed products, you must also use the PRODUCT REGISTER VOLUME command to update the product database with this information. Format PRODUCT REGISTER VOLUME old-volume-label device-name [/qualifiers] 4 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. 4 Qualifiers /LOG /LOG /NOLOG (default) Displays the file specifications of the product database files that are created or modified. /REMOTE /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. This qualifier is primarily for use in command procedures that HP supplies. Incorrect use of this qualifier can create an inconsistency in the product database or cause subsequent PRODUCT commands to fail. 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.] 4 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. 2 REMOVE Uninstalls one or more software products from your system and updates the product database. This command operates on complete products. Any patches or mandatory updates that might have been applied to complete products are also removed. To uninstall patches or mandatory updates while still retaining the original product that was installed, use the PRODUCT UNDO PATCH command. Format PRODUCT REMOVE product-name[,...] [/qualifiers] 3 Parameter product-name Names the installed product or list of installed products to remove. Specify only the names of complete products, not the names of patches or mandatory updates applied to products. 3 Qualifiers /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. /LOG /LOG /NOLOG (default) Displays the file specifications of files as they are accessed; also provides other information related to file activity. For example, when logging is enabled, messages notify you when product files, libraries, directories, temporary files, and product database files are created, deleted, or modified. Information is also provided about disk space consumption. /PRODUCER /PRODUCER=producer-name Selects software products that the specified manufacturer produces. /REMARK /REMARK=string Records a comment in the product database about the task you are performing. The PRODUCT 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 /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. This qualifier is primarily for use in command procedures that HP supplies. Incorrect use of this qualifier can create an inconsistency in the product database or cause subsequent PRODUCT commands to fail. 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.] /TRACE /TRACE /NOTRACE (default) Identifies DCL commands and command procedures that are run in a subprocess during the execution of the PRODUCT command. Any output from these commands is also displayed. This qualifier is primarily a debugging aid for product developers to trace the execution of non-interactive command procedures embedded in their product kits. This qualifier is not useful for command procedures running in interactive mode. See the POLYCENTER Software Installation Utility Developer's Guide for more information. /VERSION /VERSION=version-number Selects software products that have the specified version. /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. 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. 2 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) 3 HISTORY Displays a chronological log of operations performed on the specified products. Format PRODUCT SHOW HISTORY product-name[,...] [/qualifiers] 4 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. 4 Qualifiers /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. /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. /FULL /FULL /NOFULL (default) Displays information in 132-column format. The /NOFULL qualifier displays a subset of available information in 80-column format. /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. /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. /REMOTE /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. 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.] /SINCE /SINCE=time Selects entries 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. /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. /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. 4 Example $ PRODUCT SHOW HISTORY * /OPERATION=INSTALL /BEFORE=22-MAY-2002 The command in this example lists all the products that were installed before May 22, 2002. 3 OBJECT Displays information about objects created during a software product installation. Examples of software objects are files, directories, and modules in libraries. The standard display lists the name, type, generation number, and status of each object. The expanded display, which you request by using the /FULL qualifier, includes the destination directory and the product that provided the object. Each file and library module object has an associated generation number, either explicit or implied. The product developer specifies generation numbers to aid the POLYCENTER Software Installation utility in resolving conflict on installation when two or more products or patch kits supply the same object. A generation number is an integer value in which the largest value in a comparison of generation numbers denotes the object that supersedes the others. An explicit or implicit value of zero means no generation information has been supplied. A tie of non-zero generation numbers means the objects are identical and that an object from a product kit should replace a previously installed object. If all generation numbers in a comparison are zero, the conflict cannot be resolved. Each object has an installation status. A status of "OK" means that the object is currently installed. A status of "Conflict" indicates that the object lost a generation comparison with an object of the same name supplied by another product or patch. This is not an error condition. "OK/Adopt" indicates that a product inherited the object from another product. This happens only when a product loses an object conflict to another product, and, subsequently, the other product is removed, causing the file or module on the system to be adopted by the surviving product. Format PRODUCT SHOW OBJECT object-name [/qualifiers] 4 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. 4 Qualifiers /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. /FULL /FULL /NOFULL (default) Displays information in 132-column format. The /NOFULL qualifier displays a subset of available information in 80-column format. /PRODUCER /PRODUCER=(producer-name[,...]) Selects software products that the specified manufacturer produces. Note that the PRODUCT SHOW HISTORY command allows you to specify both the /PRODUCER and /PRODUCT qualifiers, which you need to spell out because they are not unique within the first four characters. Parentheses (()) are optional only when you specify a single producer name. They are required when you specify multiple producer names. /PRODUCT /PRODUCT=(product-name[,...]) Selects products with the specified product name. Note that the PRODUCT SHOW HISTORY command allows you to specify both the /PRODUCER and /PRODUCT qualifiers, which you need to spell out because they are not unique within the first four characters. Parentheses (()) are optional only when you specify a single product name. They are required when you specify multiple product names. /REMOTE /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. 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.] /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. 4 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. 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] 4 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. 4 Qualifiers /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. /FULL /FULL /NOFULL (default) Displays information in 132-column format. The /NOFULL qualifier displays a subset of available information in 80-column format. /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 /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. /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 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=* /REMOTE /REMOTE /NOREMOTE (default) Selects the product database located on a privately mounted system disk. By default, this utility searches the currently booted system disk for the product database. 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.] /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. /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. 4 Example $ PRODUCT SHOW PRODUCT * /REFERENCED_BY=DECNET_OSI The command in this example lists all products on which the DECnet-Plus product is dependent. 3 RECOVERY_DATA Displays patch recovery data sets in chronological order, starting with the set created most recently and ending with the oldest set. Each recovery data set identifies one or more patches that can be uninstalled. Format PRODUCT SHOW RECOVERY_DATA [/qualifiers] 4 Parameters None. 4 Qualifiers /BEFORE /BEFORE=time Selects recovery data sets 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. /FULL /FULL /NOFULL (default) Controls how available information is displayed. The /FULL qualifier displays the information in 132-column format and includes additional lines of recovery data details. The /NOFULL qualifier displays a condensed version of the information. /LOG /LOG /NOLOG (default) Displays the file specifications of recovery data set files as they are accessed. /NEWEST /NEWEST=count Displays the most recently created patch recovery data sets. For example, if you specify /NEWEST=2, the SHOW RECOVERY_DATA command displays the two newest recovery data sets. If you do not specify a number with this qualifier, the default value is 1. /OLDEST /OLDEST=count Displays the oldest recovery data sets. For example, if you specify /OLDEST=2, the SHOW RECOVERY_DATA command displays the two oldest recovery data sets. If you do not specify a number with this qualifier, the default value is 1. /REMOTE /REMOTE /NOREMOTE (default) Selects recovery data sets located on a privately mounted system disk. By default, this utility searches the currently booted system disk for recovery data sets. 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.] /SINCE /SINCE=time Selects recovery data sets 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. 4 Example $ PRODUCT SHOW RECOVERY_DATA /SINCE=10-DEC-2002 The command in this example displays the recovery data sets created on or after December 10, 2002, starting with the one created most recently. 3 UTILITY Displays the version of the POLYCENTER Software Installation utility that you are using. Format PRODUCT SHOW UTILITY 4 Parameters None. 4 Qualifiers None. 4 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. 2 UNDO 3 PATCH Uninstalls one or more patch or mandatory update kits from your system. The associated recovery data sets are deleted at the conclusion of the operation. Note that you can perform this operation only if the patch or mandatory update kits were installed with the /SAVE_RECOVERY_DATA qualifier and if the saved recovery data is still available. You can verify that recovery data still exist by entering the PRODUCT SHOW RECOVERY_DATA command. A recovery data set is created when you use the PRODUCT INSTALL /SAVE_RECOVERY_DATA command to install one or more patches (also known as ECOs or remedial kits). The PRODUCT UNDO PATCH command uninstalls all patches associated with the selected recovery data sets. Furthermore, you can "undo" patches only in the reverse chronological order of the creation dates of their recovery data sets. To uninstall complete products, including any patches or mandatory updates that have been applied to them, use the PRODUCT REMOVE command. Format PRODUCT UNDO PATCH [/qualifiers] 4 Parameters None. 4 Qualifiers /ALL Uninstalls all patch and mandatory updates for which recovery data has been saved. Once the operation completes, all the recovery data sets are deleted and cannot be reused. If you do not specify the /ALL, /NEWEST, or /SINCE qualifier, only the most recently created recovery data set is used to select patches and mandatory updates to uninstall. /LOG /LOG /NOLOG (default) Displays the file specifications of files as they are accessed; also provides other information related to file activity. For example, when logging is enabled, messages notify you when product files, libraries, directories, temporary files, and product database files are created, deleted, or modified. /NEWEST /NEWEST=count Selects the most recently created patch recovery data sets. For example, if you specify /NEWEST=3, the PRODUCT UNDO PATCH command uninstalls patches using data from the three newest recovery data sets. If you do not specify a number with this qualifier, the default value is 1. /REMOTE /REMOTE /NOREMOTE (default) Selects recovery data sets located on a privately mounted system disk. By default, this utility searches the currently booted system disk for recovery data sets. Also, the saved product database is restored to the privately mounted system disk. 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.] /SINCE /SINCE=time Selects recovery data sets 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. /TRACE /TRACE /NOTRACE (default) Identifies DCL commands and command procedures that are run in a subprocess during the execution of the PRODUCT command. Any output from these commands is also displayed. This qualifier is primarily a debugging aid for product developers to trace the execution of non-interactive command procedures embedded in their product kits. This qualifier is not useful for command procedures running in interactive mode. See the POLYCENTER Software Installation Utility Developer's Guide for more information. 4 Example $ PRODUCT UNDO PATCH The command in this example uninstalls all patch and mandatory update kits that were installed in the last INSTALL operation performed with the /SAVE_RECOVERY_DATA qualifier. The recovery data set used in this operation is deleted at the end of the operation and cannot be reused.