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.