RESTORE command

The RESTORE command enables you to explicitly restore the settings, breakpoints, and monitor specifications that were previously saved by the SET SAVE AUTO command when z/OS® Debugger terminated.

Read syntax diagramSkip visual syntax diagramRESTORE SETTINGSBPSMONITORSBPSMONITORSMONITORSBPS ;
SETTINGS
Indicates that all SET values except the following values are to be restored:
  • SET DBCS
  • SET FREQUENCY
  • SET NATIONAL LANGUAGE
  • SET PROGRAMMING LANGUAGE
  • FILE operand of SET RESTORE SETTINGS
  • SET QUALIFY
  • SET SOURCE
  • SET TEST
BPS
Indicates that breakpoints and LOADDEBUGDATA (LDD) specifications are to be restored. The following breakpoints are restored:
  • APPEARANCE breakpoints
  • CALL breakpoints
  • DELETE breakpoints
  • ENTRY breakpoints
  • EXIT breakpoints
  • GLOBAL APPEARANCE breakpoints
  • GLOBALCALL breakpoints
  • GLOBAL DELETE breakpoints
  • GLOBAL ENTRY breakpoints
  • GLOBAL EXIT breakpoints
  • GLOBAL LABEL breakpoints
  • GLOBAL LOAD breakpoints
  • GLOBAL STATEMENT and GLOBAL LINE breakpoints
  • LABEL breakpoints
  • LOAD breakpoints
  • OCCURRENCE breakpoints
  • STATEMENT and LINE breakpoints
  • TERMINATION breakpoint

If a deferred AT ENTRY breakpoint has not been encountered, it is not saved nor restored.

MONITORS
Indicates that monitor and LOADDEBUGDATA (LDD) specifications are to be restored.

Usage notes

  • The data restored by this command is retrieved from the default data set or the data set specified by the SET RESTORE SETTINGS, SET RESTORE BPS, or SET RESTORE MONITORS commands.
  • The member name used to restore the breakpoints or monitor specifications is the name of the initial load module for the current enclave.
  • Do not precede the RESTORE command with any other z/OS Debugger command except SET SAVE or another RESTORE command.

Example

  • Restore the settings: 
    RESTORE SETTINGS;
  • Restore the breakpoints and monitor specifications: 
    RESTORE BPS MONITORS;

Refer to the following topics for more information related to the material discussed in this topic.

  • Related tasks
  • IBM® z/OS Debugger User's Guide