HELPLIB.HLB  —  PRODUCT  SHOW
    Displays one of the following:

    o  A chronological log of operations performed on software
       products (SHOW HISTORY)

    o  Information about objects created during a software product
       installation (SHOW OBJECT)

    o  Information about installed products (SHOW PRODUCT)

    o  Information about installed patches that can be uninstalled
       using the PRODUCT UNDO PATCH command (SHOW RECOVERY_DATA)

    o  Information about PCSI (SHOW UTILITY)

1  –  HISTORY

    Displays a chronological log of operations performed on the
    specified products.

    Format

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

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

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

1.3  –  Qualifiers

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

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

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

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

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

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

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

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

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

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

2  –  OBJECT

    Displays information about objects created during a software
    product installation. Examples of software objects are files,
    directories, and modules in libraries.

    Format

      PRODUCT SHOW OBJECT  object-name [/qualifiers]

2.1  –  Description

    The standard display lists the name, type, generation number, and
    status of each object. The expanded display, which you request
    by using the /FULL qualifier, includes the destination root
    directory and the product that owns the object.

    Each file and library module object has an associated generation
    number, either explicit or implied. A generation number is an
    integer value in which the largest value in a comparison of
    generation numbers denotes the object that supersedes the others.

    The product developer specifies generation numbers to aid PCSI in
    resolving conflict on installation when two or more products or
    patch kits supply the same object. An explicit or implicit value
    of zero means no generation information has been supplied. A tie
    of non-zero generation numbers means the objects are identical
    and that an object from a product kit should replace a previously
    installed object. If all generation numbers in a comparison are
    zero, the conflict cannot be resolved.

    Each object has an installation status. A status of "OK" means
    that the object is currently installed. A status of "Conflict"
    indicates that the object lost a generation comparison with an
    object of the same name supplied by another product or patch.
    This is not an error condition. "OK/Adopt" indicates that a
    product inherited the object from another product. This happens
    only when a product loses an object conflict to another product,
    and, subsequently, the other product is removed, causing the file
    or module on the system to be adopted by the surviving product.

2.2  –  Parameter

 object-name

    Names the object or list of objects to include in the display.
    This is an optional parameter. If you omit it, all objects for
    the selected products will be shown. You can use the asterisk
    (*) and the percent sign (%) wildcard characters to specify the
    object-name.

    The name of a file object includes its directory
    specification relative to the destination root directory
    for the installed product. For example, a file placed in
    DISK$ALPHA:[VMS$COMMON.SYSEXE]TEST.EXE is identified in the
    product database as the file object [SYSEXE]TEST.EXE.

2.3  –  Qualifiers

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

2.3.2    /FULL

       /FULL
       /NOFULL (default)

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

2.3.3    /PRODUCER

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

    Selects software products that the specified manufacturer
    produces.

    Note that the PRODUCT SHOW HISTORY command allows you to specify
    both the /PRODUCER and /PRODUCT qualifiers, which you need to
    spell out because they are not unique within the first four
    characters.

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

2.3.4    /PRODUCT

       /PRODUCT=(product-name[,...])

    Selects products with the specified product name.

    Note that the PRODUCT SHOW HISTORY command allows you to specify
    both the /PRODUCER and /PRODUCT qualifiers, which you need to
    spell out because they are not unique within the first four
    characters.

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

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

2.3.6    /TYPE

       /TYPE=(object-type[,...])

    Selects one or more class of objects to display. Keywords are:

    ACCOUNT            Selects account objects.

    DIRECTORY          Selects directory objects.

    FILE               Selects file objects.

    IMAGE_LIBRARY      Selects image library objects.

    LOADABLE_IMAGE     Selects loadable image objects.

    MODULE             Selects module objects, including command
                       definition, help, macro, object, and text
                       library modules.

    NETWORK            Selects network objects.

    RIGHTS_IDENTIFIER  Selects rights identifier objects.

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

2.4  –  Example

  $ PRODUCT SHOW OBJECT * /PRODUCT=ABC /FULL

      The command in this example lists all objects such as files,
      directories, library modules, and other objects that were
      created when the product ABC was installed.

3  –  PRODUCT

    Displays a list of software products installed on your system.
    Use the /FULL qualifier to display additional information such as
    kit type, maintenance activity, and software dependencies.

    Format

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

3.1  –  Parameter

 product-name

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

3.2  –  Qualifiers

3.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. 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.2    /FULL

       /FULL
       /NOFULL (default)

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

3.2.3    /MAINTENANCE

       /MAINTENANCE=(product-name[,...])

    Displays the products to which the named maintenance products
    have been applied. A maintenance product is either a patch kit or
    a mandatory update kit.

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

    To list all maintenance products that have been applied to a
    particular product, use the following command:

    PRODUCT SHOW PRODUCT product-name /FULL

3.2.4    /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.2.5    /REFERENCED_BY

       /REFERENCED_BY=(product-name[,...])

    Displays products that are referenced by the named product.
    Use this qualifier to show if the product, specified in the
    /REFERENCED_BY qualifier, has a software dependency on the
    product or products specified in the product-name parameter of
    the SHOW PRODUCT command. If you specify an asterisk (*)  as the
    product name, all referenced products are listed for the product
    named in the /REFERENCED_BY qualifier.

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

    To list all products that require a specified product to be
    installed, use the command:

    PRODUCT SHOW PRODUCT product-name /FULL /REFERENCED_BY=*

    To list all products that are referenced by (that is, required
    by) a particular product, use the command:

    PRODUCT SHOW PRODUCT * /REFERENCED_BY=product-name

    To list all products that are referenced by (that is, required
    by) other products, use the command:

    PRODUCT SHOW PRODUCT * /REFERENCED_BY=*

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

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

3.3  –  Example

  $ PRODUCT SHOW PRODUCT * /REFERENCED_BY=DECNET_OSI

      The command in this example lists all products on which the
      DECnet-Plus product is dependent.

4  –  RECOVERY_DATA

    Displays patch recovery data sets in chronological order,
    starting with the set created most recently and ending with the
    oldest one. Each recovery data set identifies one or more patches
    that can be uninstalled.

    Format

      PRODUCT SHOW RECOVERY_DATA  [/qualifiers]

4.1  –  Parameters

    None.

4.2  –  Qualifiers

4.2.1    /BEFORE

       /BEFORE=time

    Selects recovery data sets 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.

4.2.2    /FULL

       /FULL
       /NOFULL (default)

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

4.2.3    /LOG

       /LOG
       /NOLOG (default)

    Displays the file specifications of recovery data set files as
    they are accessed.

4.2.4    /NEWEST

       /NEWEST=count

    Displays the most recently created patch recovery data sets. For
    example, if you specify /NEWEST=2, the SHOW RECOVERY_DATA command
    displays the two newest recovery data sets. If you do not specify
    a number with this qualifier, the default value is 1.

4.2.5    /OLDEST

       /OLDEST=count

    Displays the oldest recovery data sets. For example, if you
    specify /OLDEST=2, the SHOW RECOVERY_DATA command displays the
    two oldest recovery data sets. If you do not specify a number
    with this qualifier, the default value is 1.

4.2.6    /REMOTE

       /REMOTE
       /NOREMOTE (default)

    Selects recovery data sets located on a privately mounted system
    disk. By default, PCSI searches the currently booted system disk
    for recovery data sets.

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

4.2.7    /SINCE

       /SINCE=time

    Selects recovery data sets 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, see the OpenVMS
    User's Manual.

4.3  –  Example

  $ PRODUCT SHOW RECOVERY_DATA /SINCE=10-DEC-2002

      The command in this example displays the recovery data sets
      created on or after December 10, 2002, starting with the one
      created most recently.

5  –  UTILITY

    Displays the version of PCSI that you are using.

    Format

      PRODUCT SHOW UTILITY

5.1  –  Parameters

    None.

5.2  –  Qualifiers

    None.

5.3  –  Example

   $ PRODUCT SHOW UTILITY
   POLYCENTER Software Installation utility version: V8.3-134

   Product Configuration File (PCF) support level: 1
   Product Description File (PDF) support level: 10
   Product Text File (PTF) support level: 2
   Image Name: DISK$V83SYS:[SYS0.][SYSEXE]PCSI$MAIN.EXE;1

      The command in this example shows the version of the PCSI
      utility, its component support levels, and the full file
      specification of the PCSI image that is executing the command.
Close Help