SET RESTORE command

Controls the restoring of settings, breakpoints, and monitor specifications.

Read syntax diagramSkip visual syntax diagramSETRESTORE SETTINGSBPSMONITORS NOAUTOAUTO ;
SETTINGS
Indicates that SET values and WINDOW SIZE and WINDOW CLOSE settings are to be restored. The following SET values are not 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
MONITORS
Indicates that monitor and LOADDEBUGDATA (LDD) specifications are to be restored.
NOAUTO
Indicates that the specified data is not to be restored automatically at z/OS® Debugger startup. It will be restored only when you explicitly request it by entering the RESTORE command. NOAUTO is the default until AUTO is specified.
AUTO
Indicates that, if possible, the specified data set is to be automatically restored by z/OS Debugger at startup.

Usage notes

  • When SETTINGS are restored, they are restored before any preference or commands files are processed.
  • If you use any of the following combinations of commands, z/OS Debugger restores only specific settings:
    • SET RESTORE BPS AUTO with SET SAVE SETTINGS AUTO and SET RESTORE SETTINGS NOAUTO
    • SET RESTORE MONITORS AUTO with SET SAVE SETTINGS AUTO and SET RESTORE SETTINGS NOAUTO
    With any of these combinations of commands, z/OS Debugger restores the following settings:
    • SET RESTORE BPS
    • SET RESTORE MONITORS
    • SET SAVE BPS
    • SET SAVE MONITORS
    If you use SET RESTORE BPS NOAUTO and SET RESTORE MONITORS NOAUTO with SET RESTORE SETTINGS NOAUTO, z/OS Debugger does not restore any settings.
  • Monitors are not necessarily restored to the same slot number from which they were saved.
  • If you are debugging a CICS® program and you want to use SET RESTORE parameter_name AUTO, you must log on with a user ID that is different from the default user ID.
  • If you are debugging Db2® stored procedures, you must do one of the following tasks:
    • Ensure that the default data set does not exist.
    • Ensure that the name of the default data set is NULLFILE.
    • Change the name of the data set by using the SET SAVE SETTINGS command.

    Because multiple users share the same default data set, other users can alter the settings in that data set. You can specify that NULLFILE be the name of the default data set through the EQAOPTS commands SAVESETDSN and SAVEBPDSN.

  • If the EQAOPTS commands SAVESETDSNALLOC and SAVEBPDSNALLOC are specified, z/OS Debugger creates the data sets, if they don't exist, then runs the corresponding SET RESTORE SETTINGS AUTO or SET RESTORE BPS AUTO commands to enable their usage. To learn how to specify the EQAOPTS commands SAVESETDSNALLOC and SAVEBPDSNALLOC, see EQAOPTS commands.

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