VMS Help PRODUCT, COPY  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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]

1 - Parameter

 product-name

    Names the product, or list of products, to copy.

2 - Qualifiers

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

 2.2 - /DESTINATION

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

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

    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.

 2.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
                 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=        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.

 2.5 - /LOG

       /LOG
       /NOLOG (default)

    Displays messages as the POLYCENTER Software Installation utility
    performs the operation.

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

 2.7 - /PRODUCER

       /PRODUCER=producer-name

    Selects software products that the specified manufacturer
    produces.

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

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

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