HP OpenVMS Systems Documentation

HP OpenVMS System Management Utilities Reference Manual

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]

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.

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.

Qualifiers

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

/FULL

/NOFULL (default)

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

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

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

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

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

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

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

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.

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]

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.

Qualifiers

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

/FULL

/NOFULL (default)

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

/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

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

/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=*

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

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

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

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

Example

$ PRODUCT SHOW PRODUCT * /REFERENCED_BY=DECNET_OSI

      

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

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]

Parameters

None.

Qualifiers

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

/FULL

/NOFULL (default)

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

/LOG

/NOLOG (default)

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

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

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

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

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

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

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.

Displays the version of PCSI that you are using.

Format

PRODUCT SHOW UTILITY

Parameters

None.

Qualifiers

None.

Example

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

 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.

Uninstalls patches or mandatory updates from your system. This command uses the recovery data sets that were created by the PRODUCT INSTALL command when these patches were installed. The associated recovery data sets are deleted at the conclusion of the operation.

Format

PRODUCT UNDO PATCH [/qualifiers]

Description

You can "undo" patches only in reverse chronological order of the creation dates of their recovery data sets. Thus, if you install patches A, B, and C with separate PRODUCT INSTALL commands, and you want to "undo" patch B, the PRODUCT UNDO PATCH command requires that patch C be removed along with patch B. To remove complete products, including any patches or mandatory updates that have been applied to them, use the PRODUCT REMOVE command instead.

A recovery data set contains a copy of the directories, files, and libraries that were modified or deleted by the execution of a PRODUCT INSTALL command. In addition, a snapshot of the product database is included, along with other information needed to restore the software environment. Each recovery data set is stored in a directory tree on the system device in [PCSI$UNDO_nnn], where nnn is a number from 001 to 999. The most recent data set is number 001; all data sets are renumbered when a new data set is added or deleted from the stack.

The PRODUCT INSTALL command creates a recovery data set when patches (also known as remedial kits or ECOs) are installed unless you disable this feature with the /NOSAVE_RECOVERY_DATA qualifier. A recovery data set contains information about all patches that are installed concurrently. The PRODUCT UNDO command removes all the patches that are in the selected recovery data sets. Therefore, if multiple patches are installed in one operation, they can be removed only as a group.

You can use the PRODUCT SHOW RECOVERY_DATA command to list all recovery data sets and find out which patches can be removed. To delete unwanted recovery data sets, use the DELETE RECOVERY_DATA command.

Qualifiers

/ALL

Uninstalls all patch and mandatory updates for which recovery data has been saved. Once the operation completes, all the recovery data sets are deleted and cannot be reused. If you do not specify the /ALL, /NEWEST, or /SINCE qualifier, only the most recently created recovery data set is used to select patches and mandatory updates to remove.

/LOG

/NOLOG (default)

Displays the file specifications of files as they are accessed; also provides other information related to file activity. For example, when logging is enabled, messages notify you when product files, libraries, directories, and product database files are created, deleted, or modified.

/NEWEST=count

Selects the most recently created patch recovery data sets. For example, if you specify /NEWEST=3, the PRODUCT UNDO PATCH command uninstalls patches using data from the three newest recovery data sets. If you do not specify a number with this qualifier, the default value is 1.

/OPTIONS=keyword

/NOOPTIONS (default)

Specifies PRODUCT command options. The keyword is:

NOCONFIRM

Omits the confirmation dialog that asks the user to verify the recovery data sets that have been selected for processing.

/REMOTE

/NOREMOTE (default)

Selects recovery data sets located on a privately mounted system disk and restores the product database to this 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:

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

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

/TRACE

/NOTRACE (default)

Identifies the creation and deletion of subprocesses and the DCL commands and command procedures submitted to these subprocesses for execution during the processing of the PRODUCT command. Messages log the creation and deletion of scratch directories and temporary files that the PCSI utility provides for the subprocess environment. Any output that DCL produces is also displayed.

This qualifier is primarily a debugging aid for product developers to trace the execution of command procedures included in their product kits. See the POLYCENTER Software Installation Utility Developer's Guide for more information.

Example

$ PRODUCT UNDO PATCH

      

The command in this example uninstalls all patch and mandatory update kits that were installed in the last INSTALL operation performed with the /SAVE_RECOVERY_DATA qualifier. The recovery data set used in this operation is deleted at the end of the operation and cannot be reused.