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]
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 – 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.
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 /FULL
/FULL
/NOFULL (default)
Displays information in 132-column format. The /NOFULL qualifier
displays a subset of available information in 80-column format.
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.
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.
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.]
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.
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.
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.