Copyright Digital Equipment Corp. All rights reserved.

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

/DESTINATION
      /DESTINATION=device-name:[directory-name]

   Specifies the location where the utility will place all of 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 PRODUCT EXTRACT FILE command 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.
 

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

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