SET RESTORE command

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

>>-SET--RESTORE--+-SETTINGS-+--+-NOAUTO-+--;-------------------><
                 +-BPS------+  '-AUTO---'      
                 '-MONITORS-'                  

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 Debug Tool 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 Debug Tool 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, Debug Tool 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, Debug Tool 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, Debug Tool 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, Debug Tool 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.

• Related references
• RESTORE command
• SET SAVE command