Customizing profile settings

The PANEL PROFILE command displays the Profile Settings Panel, which contains profile settings that affect the way z/OS® Debugger runs. This panel is shown below with the IBM®-supplied initial settings.

                          Profile Settings Panel
 Command ===>

                                 Current Setting
                                 ---------------
  Change Test Granularity        STATEMENT      (All,Blk,Line,Path,Stmt)
  DBCS characters                NO             (Yes or No)
  Default Listing PDS name
  Default scroll amount          PAGE           (Page,Half,Max,Csr,Data,int)
  Default window                 SOURCE         (Log,Monitor,Source, Memory)
  Execute commands               YES            (Yes or No)
  History                        YES            (Yes or No)
  History size                   100            (nonnegative integer)
  Logging                        YES            (Yes or No)
  Pace of visual trace           2              (steps per second)
  Refresh screen                 NO             (Yes or No)
  Rewrite interval               50             (number of output lines)
  Session log size               1000           (number of retained lines)
  Show log line numbers          YES            (Yes or No)
  Show message ID numbers        NO             (Yes or No)
  Show monitor line numbers      YES            (Yes or No)
  Show scroll field              YES            (Yes or No)
  Show source/listing suffix     YES            (Yes or No)
  Show warning messages          YES            (Yes or No)
  Test level                     ALL            (All,Error,None)
 Enter  END/QUIT    to return with current settings saved.
        CANCEL      to return without current settings saved.

You can change the settings either by typing your desired values over them, or by issuing the appropriate SET command at the command line or from within a commands file.

The profile parameters, their descriptions, and the equivalent SET commands are as follows:

Change Test Granularity
Specifies the granularity of testing for AT CHANGE. Equivalent to SET CHANGE.
DBCS characters
Controls whether the shift-in or shift-out characters are recognized. Equivalent to SET DBCS.
Default Listing PDS name
If specified, the data set where z/OS Debugger looks for the source or listing. Equivalent to SET DEFAULT LISTINGS.
Default scroll amount
Specifies the default amount assumed for SCROLL commands where no amount is specified. Equivalent to SET DEFAULT SCROLL.
Default window
Selects the default window acted upon when WINDOW commands are issued with the cursor on the command line. Equivalent to SET DEFAULT WINDOW.
Execute commands
Controls whether commands are executed or just checked for syntax errors. Equivalent to SET EXECUTE.
History
Controls whether a history (an account of each time z/OS Debugger is entered) is maintained. Equivalent to SET HISTORY.
History size
Controls the size of the z/OS Debugger history table. Equivalent to SET HISTORY.
Logging
Controls whether a log file is written. Equivalent to SET LOG.
Pace of visual trace
Sets the maximum pace of animated execution. Equivalent to SET PACE.
Refresh screen
Clears the screen before each display. REFRESH is useful when there is another application writing to the screen. Equivalent to SET REFRESH.
Rewrite interval
Defines the number of lines of intercepted output that are written by the application before z/OS Debugger refreshes the screen. Equivalent to SET REWRITE.
Session log size
The number of session log output lines retained for display. Equivalent to SET LOG.
Show log line numbers
Turns line numbers on or off in the log window. Equivalent to SET LOG NUMBERS.
Show message ID numbers
Controls whether ID numbers are shown in z/OS Debugger messages. Equivalent to SET MSGID.
Show monitor line numbers
Turns line numbers on or off in the Monitor window. Equivalent to SET MONITOR NUMBERS.
Show scroll field
Controls whether the scroll amount field is shown in the display. Equivalent to SET SCROLL DISPLAY.
Show source/listing suffix
Controls whether the frequency suffix column is displayed in the Source window. Equivalent TO SET SUFFIX.
Show warning messages (C and C++ and PL/I only)
Controls whether warning messages are shown or conditions raised when commands contain evaluation errors. Equivalent to SET WARNING.
Test level
Selects the classes of exceptions to cause automatic entry into z/OS Debugger. Equivalent to SET TEST.

A field indicating scrolling values is shown only if the screen is not large enough to show all the profile parameters at once. This field is not shown in the example panel above.

You can change the settings of these profile parameters at any time during your session. For example, you can increase the delay that occurs between the execution of each statement when you issue the STEP command by modifying the amount specified in the Pace of visual trace field at any time during your session.

To modify the profile settings for your session, enter a new value over the old value in the field you want to change. Equivalent SET commands are issued when you QUIT from the panel.

Entering the equivalent SET command changes the value on the Profile Settings panel as well.

Settings remain in effect for the entire debug session.

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