Library /sys$common/syshlp/helplib.hlb  —  PRODUCT  UNDO

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]

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.

1.2  –  Parameters 

    None.

1.3  –  Qualifiers

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.

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.

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.

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.

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

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.

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.

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.
Close Help