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

    Modifies the configuration of an installed product by allowing a
    user to change installation options.

    Reconfiguration of a product might result in the addition or
    deletion of files, or both, depending on the user's selection
    or deselection of options; that is, users can select options
    that were not selected when the product was installed, or they
    can deselect options that were selected when the product was
    installed. At the conclusion of the operation, the product
    database is updated to reflect the changes.

    Format

      PRODUCT RECONFIGURE  product-name[,...] [/qualifiers]

1 - Parameter

 product-name

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

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

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

    Specifies how the configuration choices will be supplied.
    Keywords are:

    CURRENT        This is the default. It uses values from the
                   product database, which has the current values
                   recorded from the last time the product was
                   installed or reconfigured.

    PRODUCER       Uses values specified by the software manufacturer
                   for this version of the product.

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

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

    The keywords CURRENT, PRODUCER, and INPUT are mutually exclusive.
    Each of these, however, can be used with the keyword OUTPUT. If
    you specify only one keyword, you can omit the parentheses.

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

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

       /PRODUCER=producer-name

    Selects software products that the specified manufacturer
    produces.

 2.7 - /REMARK

       /REMARK=string

    Records a comment in the product database about the task you
    are performing. The SHOW HISTORY command displays the recorded
    comments. For each product, the POLYCENTER Software Installation
    utility stores a chronological list of tasks you perform and the
    associated remarks. The default behavior is that no remark is
    recorded.

 2.8 - /REMOTE

       /REMOTE
       /NOREMOTE (default)

    Uses the product database on a system other than the currently
    running system. This qualifier is primarily for use in command
    procedures that Compaq supplies. Incorrect use of this qualifier
    can corrupt the POLYCENTER Software Installation utility
    database, corrupt installed products, or cause other problems.
    In some cases, /REMOTE can be useful with the CONFIGURE and SHOW
    commands.

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

    Note that the definition of PCSI$SYSDEVICE and PCSI$SPECIFIC
    specify only where the utility will find or place its database.

 2.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, the POLYCENTER Software Installation
    utility searches the current default directory.

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

 2.11 - /TRACE

       /TRACE
       /NOTRACE (default)

    Displays all DCL commands that the POLYCENTER Software
    Installation utility may execute while performing the operation.
    Any output generated by these commands is also displayed. This
    qualifier is a debugging aid to trace the execution of DCL
    commands and command procedures executed in a subprocess.

 2.12 - /VERSION

       /VERSION=version-number

    Selects software products that have the specified version.

 2.13 - /WORK

       /WORK=device:[directory]

    Specifies the name of the device and directory acting as a
    temporary work area. By default, temporary files are created
    in subdirectories of the user's login directory.

3 - Example

  $ DEFINE PCSI$SOURCE DKA500:[DWMOTIF.KIT]
  $ PRODUCT RECONFIGURE DWMOTIF /VERSION=V1.2-3

      The command in this example enters into a dialog with the user
      to change the configuration options for the product DECwindows
      Motif Version 1.2-3.