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.
Format
PRODUCT COPY product-name
/DESTINATION=device-name:[directory-name]
[/qualifiers]
1 – Description
The PRODUCT COPY command allows you to compress a sequential kit.
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. You cannot create a kit in
compressed format directly from a kit in reference 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.
If you copy a product kit that is signed and has an associated
manifest file in the source directory, both the kit and its
manifest are copied to the destination directory. A manifest
file is used for product kit validation. It must have a file name
and file type that match the file specification of the product
kit, with _ESW appended to the file type.
2 – Parameter
product-name
Names the product, or list of products, to copy.
3 – Qualifiers
3.1 /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. Standard names are:
Name Description
AXPVMS Denotes an OpenVMS Alpha product.
I64VMS Denotes an OpenVMS I64 product.
VAXVMS Denotes an OpenVMS VAX product.
VMS Indicates a product that can be installed on more
than one OpenVMS platform.
3.2 /DESTINATION
/DESTINATION=device-name:[directory-name]
Specifies the 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 command ignores the PCSI$DESTINATION logical
name whether or not you use the /DESTINATION qualifier.
3.3 /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.
3.4 /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.
3.5 /LOG
/LOG
/NOLOG (default)
Displays the file specification of the product kit file that is
created and the files packaged in the kit.
3.6 /OPTIONS
/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:
1. 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.
2. 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).
3. 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.
NOVALIDATE_KIT Disables validation of software product kits
that are signed and have a manifest file in the
source directory.
3.7 /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.
3.8 /PRODUCER
/PRODUCER=producer-name
Selects software products that the specified manufacturer
produces.
3.9 /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, PCSI searches the current default
directory.
3.10 /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.
3.11 /VERSION
/VERSION=version-number
Selects software products that have the specified version.
4 – 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.