 |
HP OpenVMS System Management Utilities Reference
Manual
The ABOVE, BELOW, MINIMUM, and MAXIMUM keywords can be used alone or in
combination. For example,
/SPAN_VERSIONS= (MINIMUM=V2.1,BELOW=V3.0)
selects versions greater than or equal to V2.1 and less than (but not
including) V3.0. Using the MAXIMUM keyword instead of BELOW would
select versions that include V3.0.
/VERSION=version-number
Selects software products that have the specified version.
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.
DELETE 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]
Parameters
None.
Qualifiers
/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=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.
/OPTIONS=keyword
/NOOPTIONS (default)
Specifies PRODUCT command options. The keyword is:
|
NOCONFIRM
|
Omits the confirmation dialog that asks the user to verify the recovery
data sets that have been selected for processing.
|
/LOG
/NOLOG (default)
Displays the file specifications of the files within the recovery data
sets that are being deleted.
/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
/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:
- PCSI$SYSDEVICE must specify the physical disk name of the target
system disk. This disk must be mounted and allocated to the process
executing the PRODUCT command.
- PCSI$SPECIFIC must point to a system root on PCSI$SYSDEVICE. It
must be defined in the following form, where x is a valid
system root:
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.
EXTRACT FILE
Retrieves a user-specified file or files from a software product kit.
The original name of the file is preserved when it is extracted.
Format
PRODUCT EXTRACT FILE product-name[,...] [/qualifiers]
Parameter
product-name
Names the product, or list of products, from whose kits the selected
file or files are to be retrieved. This parameter is required.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products whose base system matches the one specified.
The base system name identifies both a hardware platform and an
operating system. Standard names are:
| Name |
Description |
|
AXPVMS
|
Denotes an OpenVMS Alpha product
|
|
I64VMS
|
Denotes an OpenVMS Industry Standard 64 product
|
|
VAXVMS
|
Denotes an OpenVMS VAX product
|
|
VMS
|
Indicates a product that can be installed on more than one OpenVMS
platform
|
/DESTINATION=device-name:[directory-name]
Specifies the location where the utility is to place all the files that
the user indicates are to be retrieved. If the device name is not
provided, the default is the user's default device. If the directory
name is omitted, or the /DESTINATION= qualifier is not specified, the
default is the user's default directory. The EXTRACT FILE operation
ignores the PCSI$DESTINATION logical name whether or not you use the
/DESTINATION qualifier.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
|
|
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=
kit-type
|
Specifies the type of product kit as follows:
|
FULL
|
Layered product (application) software.
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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
/NOLOG (default)
Displays the file specifications of the files that are extracted from
the kit.
/OPTIONS=keyword
/NOOPTIONS (default)
Specifies PRODUCT command options. The keywords are:
|
NOCONFIRM
|
Omits the confirmation dialog that asks the user to verify the products
that have been selected for the operation.
The NOCONFIRM and NODEFAULT_KIT keywords are mutually exclusive.
|
|
NODEFAULT_KIT
|
Directs the utility to query the user instead of choosing a default kit
when more than one kit that matches the selection criteria for the
product is found in the source directory path. The selection criteria
include the producer, base system, product name, and product version
strings that are embedded in the file name of a kit.
If multiple kits are found for a selected product, and
NODEFAULT_KIT is not specified, the utility determines the default kit
to use by applying the following rules:
- The last character of the kit's file name (1-7) is used to order
the kits by kit type. In descending order, the precedence is as
follows: full, operating system, partial, patch, platform, transition,
and mandatory update.
- The file type is used to order the kits by format. In descending
order, the precedence is as follows: compressed (.PCSI$COMPRESSED),
sequential (.PCSI), and reference (.PCSI$DESCRIPTION).
- If multiple kits are found with the same file name and file type,
but differ in their directory path names, the case of their file
specifications, or their file versions, then the first file found by
RMS search rules takes precedence.
The NODEFAULT_KIT and NOCONFIRM keywords are mutually exclusive.
|
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/SELECT=filename[,...]
Specifies the name of a file, or a list of files, to be extracted from
the specified product 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=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location that the logical name PCSI$SOURCE defines. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current
default directory.
/SPAN_VERSIONS=keyword([,...])
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-number
Selects software products that have the specified version.
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 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.
EXTRACT PDF
Retrieves the product description file (PDF) from a software product
kit. The file type of the extracted PDF file is .PCSI$DESCRIPTION.
Format
PRODUCT EXTRACT PDF product-name[,...] [/qualifiers]
Parameter
product-name
Names the product, or list of products, whose PDF file is to be
retrieved from the kit.
Qualifiers
/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. Standard names are:
| Name |
Description |
|
AXPVMS
|
Denotes an OpenVMS Alpha product
|
|
I64VMS
|
Denotes an OpenVMS Industry Standard 64 product
|
|
VAXVMS
|
Denotes an OpenVMS VAX product
|
|
VMS
|
Indicates a product that can be installed on more than one OpenVMS
platform
|
/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=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
|
|
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=
kit-type
|
Specifies the type of product kit as follows:
|
FULL
|
Layered product (application) software.
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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
/NOLOG (default)
Displays the file specification of the product description file that is
created.
/OPTIONS=keyword
/NOOPTIONS (default)
Specifies PRODUCT command options. The keywords are:
|
NOCONFIRM
|
Omits the confirmation dialog that asks the user to verify the products
that have been selected for the operation.
The NOCONFIRM and NODEFAULT_KIT keywords are mutually exclusive.
|
|
NODEFAULT_KIT
|
Directs the utility to query the user instead of choosing a default kit
when more than one kit that matches the selection criteria for the
product is found in the source directory path. The selection criteria
include the producer, base system, product name, and product version
strings that are embedded in the file name of a kit.
If multiple kits are found for a selected product, and
NODEFAULT_KIT is not specified, the utility determines the default kit
to use by applying the following rules:
- The last character of the kit's file name (1-7) is used to order
the kits by kit type. In descending order, the precedence is as
follows: full, operating system, partial, patch, platform, transition,
and mandatory update.
- The file type is used to order the kits by format. In descending
order, the precedence is as follows: compressed (.PCSI$COMPRESSED),
sequential (.PCSI), and reference (.PCSI$DESCRIPTION).
- If multiple kits are found with the same file name and file type,
but differ in their directory path names, the case of their file
specifications, or their file versions, then the first file found by
RMS search rules takes precedence.
The NODEFAULT_KIT and NOCONFIRM keywords are mutually exclusive.
|
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location that the logical name PCSI$SOURCE defines. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current
default directory.
/SPAN_VERSIONS=keyword([,...])
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-number
Selects software products that have the specified version.
Example
|
$ PRODUCT EXTRACT PDF TEST /SOURCE=[AL]
|
In this example, the POLYCENTER Software Installation utility extracts
the product description file (PDF) from the 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.
EXTRACT PTF
Retrieves the product text file (PTF) from a software product 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]
Parameter
product-name
Names the product, or list of products, whose PTF file is to be
retrieved from the kit.
Qualifiers
/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. Standard names are:
| Name |
Description |
|
AXPVMS
|
Denotes an OpenVMS Alpha product
|
|
I64VMS
|
Denotes an OpenVMS Industry Standard 64 product
|
|
VAXVMS
|
Denotes an OpenVMS VAX product
|
|
VMS
|
Indicates a product that can be installed on more than one OpenVMS
platform
|
/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=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
|
|
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=
kit-type
|
Specifies the type of product kit as follows:
|
FULL
|
Layered product (application) software.
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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
/NOLOG (default)
Displays the file specifications of the product text and product text
library files that are created.
/OPTIONS=keyword
/NOOPTIONS (default)
Specifies PRODUCT command options. The keywords are:
|
NOCONFIRM
|
Omits the confirmation dialog that asks the user to verify the products
that have been selected for the operation.
The NOCONFIRM and NODEFAULT_KIT keywords are mutually exclusive.
|
|
NODEFAULT_KIT
|
Directs the utility to query the user instead of choosing a default kit
when more than one kit that matches the selection criteria for the
product is found in the source directory path. The selection criteria
include the producer, base system, product name, and product version
strings that are embedded in the file name of a kit.
If multiple kits are found for a selected product, and
NODEFAULT_KIT is not specified, the utility determines the default kit
to use by applying the following rules:
- The last character of the kit's file name (1-7) is used to order
the kits by kit type. In descending order, the precedence is as
follows: full, operating system, partial, patch, platform, transition,
and mandatory update.
- The file type is used to order the kits by format. In descending
order, the precedence is as follows: compressed (.PCSI$COMPRESSED),
sequential (.PCSI), and reference (.PCSI$DESCRIPTION).
- If multiple kits are found with the same file name and file type,
but differ in their directory path names, the case of their file
specifications, or their file versions, then the first file found by
RMS search rules takes precedence.
The NODEFAULT_KIT and NOCONFIRM keywords are mutually exclusive.
|
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location that the logical name PCSI$SOURCE defines. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current
default directory.
/SPAN_VERSIONS=keyword([,...])
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
|
|
