Library /sys$common/syshlp/helplib.hlb  —  PRODUCT  SHOW  HISTORY
    Displays a chronological log of operations performed on the
    specified products.

    Format

      PRODUCT SHOW HISTORY  product-name[,...] [/qualifiers]

1  –  Description

    For each operation performed, the following information is
    displayed:

    o  Name of the product

    o  Type of product kit: full LP, operating system, mandatory
       update, partial, patch, platform, or transition

    o  Kit validation status

    o  Date of the operation

    If you specify /FULL, the following additional information is
    also included:

    o  Complete date and time of the operation

    o  Number of times the user chose to continue from an error

    o  Account name from which the operation was performed

    o  Any text found in the remark field

    The kit validation status field (VAL) codes are the following:

    Code    Meaning

    Val     Kit was successfully validated.
    Sys     Kit was not validated, but it was installed from OS media
            as part of an OpenVMS installation or upgrade.
    (U)     Kit was not validated because it was an unsigned kit and
            therefore it did not have a manifest file created for it.
    (M)     Kit was not validated because its manifest file was not
            found in the source directory.
    (D)     Kit was not validated because the validation feature was
            explicitly disabled by the user.
    (C)     Kit was not validated because CDSA was not operational.
     -      Not applicable for the operation (such as product
            removal).
    <none>  A blank entry indicates that the version of PCSI used to
            perform the operation did not support the kit validation
            feature or was running on a pre-V8.3 OpenVMS system.

2  –  Parameter

 product-name

    Names the product or list of products to include in the display.
    This is an optional parameter. If you omit it, operations
    performed on all products will be shown.

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.

    Parentheses (())  are optional only when you specify a single
    base system name. They are required when you specify multiple
    base system names.

3.2    /BEFORE

       /BEFORE=time

    Selects entries that were created before the specified date and
    time. You can specify time as an absolute time, as a combination
    of absolute and delta times, or as one of the following keywords:

       TODAY (default)
       TOMORROW
       YESTERDAY

    For information about specifying time values, see the OpenVMS
    User's Manual.

3.3    /FULL

       /FULL
       /NOFULL (default)

    Displays information in 132-column format. The /NOFULL qualifier
    displays a subset of available information in 80-column format.

3.4    /OPERATION

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

    Specifies one or more of the following operations as the value
    for keyword:

       INSTALL
       RECONFIGURE
       REGISTER_PRODUCT
       REGISTER_VOLUME
       REMOVE

    Parentheses (())  are optional only when you specify a single
    keyword. They are required when you specify multiple keywords.

3.5    /PRODUCER

       /PRODUCER=(producer-name[,...])

    Selects software products that the specified manufacturer
    produces.

    Parentheses (())  are optional only when you specify a single
    producer name. They are required when you specify multiple
    producer names.

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

3.7    /SINCE

       /SINCE=time

    Selects entries that were created on or after the specified
    date and time. You can specify time as an absolute time, as
    a combination of absolute and delta times, or as one of the
    following keywords:

       TODAY (default)
       YESTERDAY

    For information about specifying time values, the OpenVMS User's
    Manual.

3.8    /USER

       /USER=(username[,...])

    Displays information about the products installed, configured, or
    removed by the specified user.

    Parentheses (())  are optional only when you specify a single
    user name. They are required when you specify multiple user
    names.

3.9    /VERSION

       /VERSION=(version-number[,...])

    Selects software products that have the specified version.

    Parentheses (())  are optional only when you specify one version
    number. They are required when you specify more than one version
    number.

4  –  Example

  $ PRODUCT SHOW HISTORY * /OPERATION=INSTALL /BEFORE=22-MAY-2002

      The command in this example lists all the products that were
      installed before May 22, 2002.
Close Help