Library /sys$common/syshlp/helplib.hlb  —  PRODUCT  CONFIGURE  Qualifiers

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.

2    /CONFIGURATION

       /CONFIGURATION=(keyword[,...])

    Specifies how the configuration choices are used. Keywords are:

    CURRENT          Uses values from the product database. These
                     values are the configuration choices made when
                     the product was installed or reconfigured.

    PRODUCER         Uses values specified by the software
                     manufacturer of the product.

    INPUT=pcf-name   Uses values from the specified product
                     configuration file.

    OUTPUT=pcf-name  Writes configuration choices to the specified
                     product configuration file. If no file
                     name is supplied, creates a file named
                     DEFAULT.PCSI$CONFIGURATION in the current
                     default directory.

    The keywords CURRENT, PRODUCER, and INPUT are mutually exclusive.
    (CURRENT is the default if none of these keywords is specified.)

    The OUTPUT keyword can be used with the CURRENT, PRODUCER, or
    INPUT keyword.

    If you specify only one keyword, you can omit the parentheses.

3    /HELP

       /HELP
       /NOHELP (default)

    Controls whether detailed explanations of product options and
    informational text are displayed. The first time you install a
    product, these explanations can help you decide which options to
    select. When you perform subsequent installations or upgrades,
    you might choose the brief explanations to save time.

    When /NOHELP is selected, you can request a detailed explanation
    about a question by performing one of the following actions at
    the prompt:

    o  Press the Help key or PF2 key

    o  Type ? and press the Return key

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

5    /LOG

       /LOG
       /NOLOG (default)

    Displays the file specification of the configuration file that is
    created.

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.

7    /PRODUCER

       /PRODUCER=producer-name

    Selects software products that the specified manufacturer
    produces.

8    /REMOTE

       /REMOTE
       /NOREMOTE (default)

    Selects the product database located on a privately mounted
    system disk. By default, PCSI searches the currently booted
    system disk for the product database.

    When you use /REMOTE, the following logical names must be
    defined:

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

    o  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:

       PCSI$SYSDEVICE:[SYSx.]

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.

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.

11    /VERSION

       /VERSION=version-number

    Selects software products that have the specified version.
Close Help