15.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.
15.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.
15.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.
15.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.
15.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]
15.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.
15.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.
15.2.3 – Qualifiers
15.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.
15.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.
15.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.
15.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.
15.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.]
15.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.
15.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.
15.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.
15.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]
15.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.
15.3.2 – Qualifiers
15.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.
15.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.
15.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
15.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.
15.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=*
15.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.]
15.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.
15.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.
15.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.
15.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]
15.4.1 – Parameters
None.
15.4.2 – Qualifiers
15.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.
15.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.
15.4.2.3 /LOG
/LOG
/NOLOG (default)
Displays the file specifications of recovery data set files as
they are accessed.
15.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.
15.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.
15.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.]
15.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.
15.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.
15.5 – UTILITY
Displays the version of PCSI that you are using.
Format
PRODUCT SHOW UTILITY
15.5.1 – Parameters
None.
15.5.2 – Qualifiers
None.
15.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.
16 – UNDO
16.1 – PATCH
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]
16.1.1 – 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.
16.1.2 – Parameters
None.
16.1.3 – Qualifiers
16.1.3.1 /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.
16.1.3.2 /LOG
/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.
16.1.3.3 /NEWEST
/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.
16.1.3.4 /OPTIONS
/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.
16.1.3.5 /REMOTE
/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:
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.]
16.1.3.6 /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.
16.1.3.7 /TRACE
/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.
16.1.4 – 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.