 |
HP OpenVMS System Management Utilities Reference
Manual
SHOW OBJECT
Displays information about objects created during a software product
installation. Examples of software objects are files, directories, and
modules in libraries. 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 the
POLYCENTER Software Installation utility 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.
Format
PRODUCT SHOW OBJECT object-name [/qualifiers]
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 Industry Standard 64 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, this utility 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:
/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.
SHOW 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]
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 Industry Standard 64 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, this utility 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:
/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.
SHOW 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]
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
|
Refer to the OpenVMS User's Manual for information about specifying time values.
/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, this utility 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:
/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
Refer to the OpenVMS User's Manual for information about specifying time values.
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.
SHOW UTILITY
Displays the version of the POLYCENTER Software Installation utility
that you are using.
Format
PRODUCT SHOW UTILITY
Parameters
None.
Qualifiers
None.
Example
|
$ PRODUCT SHOW UTILITY
POLYCENTER Software Installation utility version: V7.3-100
.
.
.
|
The command in this example shows the version of the utility that is
executing the command.
UNDO PATCH
Uninstalls one or more patch or mandatory update kits from your system.
The associated recovery data sets are deleted at the conclusion of the
operation.
Note that you can perform this operation only if the patch or mandatory
update kits were installed with the /SAVE_RECOVERY_DATA qualifier and
if the saved recovery data is still available. You can verify that
recovery data still exist by entering the PRODUCT SHOW RECOVERY_DATA
command.
A recovery data set is created when you use the PRODUCT INSTALL
/SAVE_RECOVERY_DATA command to install one or more patches (also known
as ECOs or remedial kits). The PRODUCT UNDO PATCH command uninstalls
all patches associated with the selected recovery data sets.
Furthermore, you can "undo" patches only in the reverse
chronological order of the creation dates of their recovery data sets.
To uninstall complete products, including any patches or mandatory
updates that have been applied to them, use the PRODUCT REMOVE command.
Format
PRODUCT UNDO PATCH [/qualifiers]
Parameters
None.
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 uninstall.
/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, temporary files, 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.
By default, this utility searches the currently booted system disk for
recovery data sets. Also, the saved product database is restored to the
privately mounted system disk.
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:
/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
Refer to the OpenVMS User's Manual for information about specifying time values.
/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. 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
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.
|
