 |
OpenVMS System Management Utilities Reference
Manual
COPY
Manipulates a product distribution kit by either creating a sequential
copy from a reference copy, creating a reference copy from a sequential
copy, or creating a copy without changing the format. You must supply
the /DESTINATION qualifier.
Format
PRODUCT COPY product-name/DESTINATION=device-name:[directory-name]
[/qualifiers]
Parameter
product-name
Names the product, or list of products, to copy.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products 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=device-name:[directory-name]
Specifies a location where the utility will place a copy of a
sequential kit; for a reference kit, specifies the top-level directory
location where the utility will place files. If the device name is not
provided, it defaults to the user's default device. If the directory
name is omitted, it defaults to the user's default directory.
The PRODUCT COPY operation ignores the PCSI$DESTINATION logical name
whether or not you use the /DESTINATION qualifier.
/FORMAT=keyword
Specifies the output format of the product kit. Keywords are:
|
REFERENCE
|
Reference format in which product files are placed in a directory tree.
|
|
|
|
|
SEQUENTIAL
|
Sequential format in which product files are placed in
<full-product-name>.PCSI, a container file.
|
The default is to preserve the format of the product kit.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
|
|
REFERENCE
|
Reference format in which product files exist in a directory tree.
|
|
|
|
|
SEQUENTIAL
|
Sequential format in which product files are placed in
<full-product-name>.PCSI, a container file.
|
|
|
|
|
TYPE=
kit-type
|
Specifies the type of product kit as follows:
|
|
|
|
FULL
|
Layered product (application) software.
|
|
|
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
|
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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 messages as the POLYCENTER Software Installation utility performs the operation.
/OWNER_UIC=uic
Specifies the owner user identification code (UIC) for files created
during a copy operation. By default, the user executing the operation
owns the software product files. For example, if you are logged in to
your own account, you can use this qualifier during a copy operation to
assign ownership of the product files to SYSTEM rather than to your own
account. Specify the UIC in alphanumeric format (in the form [name]) or
in octal group-member format (in the form [g,m]). UIC formats are
described in the OpenVMS User's Manual.
/PRODUCER=producer-name
Selects software products that the specified manufacturer produces.
/SOURCE=device-name:[directory-name]
Specifies the disk and directory where the utility searches for the
software product kit or kits. If /SOURCE is not specified, the utility
searches in the location defined by the logical name PCSI$SOURCE. If
PCSI$SOURCE is not defined, and the /SOURCE qualifier is not specified,
the POLYCENTER Software Installation utility searches the current default directory.
/SPAN_VERSIONS=keyword([,...])
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 COPY ABC /SOURCE=[SHERMAN.ABC] -
_$ /DESTINATION=[KITS] /FORMAT=SEQUENTIAL
|
The command in this example converts product kit ABC, located in the
[SHERMAN.ABC] directory on the user's default device, to a sequential
copy in the [KITS] directory on the user's default device.
EXTRACT FILE
Retrieves a user-specified file or files from a sequentially formatted
software product kit. A file type of .PCSI denotes a sequential kit.
The original name of the file is preserved when it is extracted.
Format
PRODUCT EXTRACT FILE product-name[,...] [/qualifiers]
Parameter
product-name
Names the product, or list of products, from whose kits the selected
file or files are to be retrieved. This parameter is required.
Qualifiers
/BASE_SYSTEM=base-system-name
Selects software products 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=device-name:[directory-name]
Specifies the location where the utility is to place all the files that
the user indicates are to be retrieved. If the device name is not
provided, the default is the user's default device. If the directory
name is omitted, or the /DESTINATION= qualifier is not specified, the
default is the user's default directory. The EXTRACT FILE operation
ignores the PCSI$DESTINATION logical name whether or not you use the
/DESTINATION qualifier.
/KIT_ATTRIBUTES=keyword([,...])
Selects kits by kit type or kit format, or both. Keywords are:
FORMAT=
format-type
|
Designates the format of the product kit as follows:
|
|
|
|
REFERENCE
|
Reference format in which product files exist in a directory tree.
|
|
|
|
|
SEQUENTIAL
|
Sequential format in which product files are placed in
<full-product-name>.PCSI, a container file.
|
|
|
|
|
TYPE=
kit-type
|
Specifies the type of product kit as follows:
|
|
|
|
FULL
|
Layered product (application) software.
|
|
|
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
|
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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 messages as the POLYCENTER Software Installation utility
performs an operation.
/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 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=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 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.
EXTRACT PDF
Retrieves the product description file (PDF) from a sequentially
formatted software product kit. A file type of .PCSI denotes a
sequential 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. 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=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:
|
|
|
|
REFERENCE
|
Reference format in which product files exist in a directory tree.
|
|
|
|
|
SEQUENTIAL
|
Sequential format in which product files are placed in
<full-product-name>.PCSI, a container file.
|
|
|
|
|
TYPE=
kit-type
|
Specifies the type of product kit as follows:
|
|
|
|
FULL
|
Layered product (application) software.
|
|
|
|
|
OPERATING_SYSTEM
|
Operating system software.
|
|
|
|
|
MANDATORY_UPDATE
|
A required correction to currently installed software. Functionally,
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 messages as the POLYCENTER Software Installation utility
performs an operation.
/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 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.
|
