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]
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.
2 – Parameters
None.
3 – Qualifiers
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.
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.
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.
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.
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.]
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.
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.
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.