Set Profile Defaults. (0.1)

The Set Profile Defaults screen (0.1) shown in Set Profile Defaults Screen (0.1) Page 1 is used to set profile values for controlling Code Debug CICS sessions. The fields on this screen establish the automatic transaction values that are used when you begin a Code Debug CICS session. The options are carried throughout the session unless you override them.

Access this screen by typing the number 1 on the Session Profile Menu, or as described in Transferring Between Screens.

 Set Profile Defaults Screen (0.1) Page 1

Global Parameters Used to Initialize Defaults

The input fields on the Set Profile Defaults screen are initialized based on the values of the Code Debug CICS global parameters listed in following screen. The only exceptions are AUTOKEEP and OPTWARN (both with a default of ON) and REGS (with a default of 64). For a complete description of Code Debug’s global parameters, see Code Debug CICS Advanced Configuration space.

PROFILE

Name of the current profile record being used for this Code Debug session. This field can be modified. If modified and the entered value exists, the 0.1 screen is repopulated with that profile’s values. If the entered value does not exist, the user is transferred to the 0.4 screen to get a listing of available profiles.

DESCRIPTION

Allows users to enter a free-form description of the profile record.

Debugging Options

FOOT

Turns footings on or off and establishes the type of data to be shown in the footing. Valid entries are:

ANALYZE: Displays statement analysis information that can be activated using the COUNT command.

DATA: Displays four lines of block hex, showing the contents of the block to which the result of the last CALC command points.

KEYS: Displays the PF key settings for your current session.

MENU: Displays a menu of the screens for whichever transaction you are using.

REGS: Displays the current program registers, PSW, and disassembled current assembler instruction.

FLOAT: If the machine that CICS is running on does not support IEEE, then it displays the current program general registers, the standard floating point registers (0,2,4,6), the PSW, the program offset, and the current disassembled instruction. If the machine does support IEEE, then only the 16 floating point registers are displayed.

SOURCE: Displays the current source statement, the preceding statement, and the following two statements when at a break or abend. The current statement is highlighted.

STATUS: Displays a summary of the current abend and terminal information.

OFF: No footing is displayed, leaving more room for data.

DELAY

Number of seconds you want to wait between the execution of successive statements when single-stepping a program. Valid entries are 0 through the maximum wait value your system administrator set in the GO_COMMAND_MAXIMUM_WAIT_TIME global parameter.

TRACE

Specifies whether the program execution trace facility is active (ON) or inactive (OFF).

Specifies whether storage protection is active (ON) or inactive (OFF).

MAXSTEP

Specifies a default maximum number of statements to execute when the delay value of the GO command is greater than zero. Valid values are 1 to 99.

REGS

Specifies the display format for the General Purpose (GP) registers. These registers are shown on the Assembler Break/Abend screen (2.20) and on the REGISTERS footing.

Valid values are:

64: Displays all positions of the GP registers.

32: Displays only the lower 32 bits of the GP registers.

Trap Options

TRAP

Specifies whether to trap any abend or breakpoint that occurs at your terminal during a debugging session. Valid entries are ON and OFF.

If global parameter WORKSTATIONS_USE_UNIQUE_IP_ADDRESSES is YES, TRAP also controls whether Code Debug will trap any abends or breakpoints that occur at your TCPIP-based workstation during a debugging session. (For more information, see PROFILE_DEFAULT_AUTO_ABEND_TRAPPING and WORKSTATIONS_USE_UNIQUE_IP_ADDRESSES in the Code Debug CICS Advanced Configuration space section entitled Configuration Parameters.)

SAVE TRAPS

Saves traps automatically at session end. This parameter is ignored if the profile data set is in the old format. Valid entries are:

ON: (Default) Saves traps automatically at session end.

OFF: Does not save traps automatically at session end.

LOAD TRAPS

Loads saved traps at session start. This parameter is ignored if the profile data set is in the old format. Valid entries are:

ON: Loads saved traps at session start.

OFF: (Default) Does not load saved traps at session start.

Source Options

SOURCE

Specifies whether to display the Source Listing screen (2.L) whenever a breakpoint or abend is encountered. Valid values are:

ON: Causes the Source Listing screen (2.L) to be displayed whenever a breakpoint or abend is encountered.

OFF: Causes the View Break/Abend screen (2.1) to be displayed whenever a breakpoint or abend is encountered.

JUSTIFY

Specifies whether to clip or expand program source listings. Valid entries are:

ON: Clips the current source listing so that data to the left and right of the source lines are removed from the display. ON also removes areas of the source listing, such as the cross reference, from in front and following the active source listing for this program.

OFF: Expands the display to show all data provided in the source listing.

OPTWARN

Specifies whether program optimized warnings are to be displayed in the footer section of the screen. Valid values are:

ON: Program optimized warnings will be displayed on the first line of the screen footer. If foot is set to OFF, a one-line footer will be generated with the optimized warning. The default is ON.

OFF: No program optimized warnings will be displayed in the footer.

You can set additional user default settings by scrolling DOWN. The following screen is displayed.

Set Profile Defaults Screen (0.1) Page 2

Keep Options

KEEP

Specifies whether the keep window is to be open or closed on the Source Listing screen (2.L). The keep window allows you to perform most debugging functions from the Source Listing screen (2.L). Valid entries are:

n: Specifies the size (in lines deep) of the keep window. Valid entries are 0 (OFF) and any number 3-11 (5 is the default).

OFF: Closes the keep window on the Source Listing screen (2.L). Setting the KEEP value to 0 is equivalent to setting it to OFF.

Specifies whether or not automatic keeps should be displayed when stepping. Valid values are:

ON: Automatic and manual keeps are displayed when stepping.

OFF: Only manual keeps are displayed when stepping.

Specifies whether the Intelligent Autokeeps feature will be available during stepping. For more information, see Intelligent Autokeeps.

ON: If AUTOKEEP is also set to ON, intellikeeps will be displayed during stepping and duplicate autokeeps will be removed.

OFF: Deactivates the Intelligent Autokeeps feature.

WIDEHEX

Specifies whether to use the alternate format for displaying vertical hex in keep windows and on the Working Storage screen (2.3). The standard format for vertical hex shows up to 24 positions of each field on a screen using three screen lines per field to display field name, field attributes, and the data vertically (character, zone, and decimal). When WIDEHEX is set to YES, up to 74 positions of each field will be displayed, using five screen lines per field as follows:

• 
  
  • 
    
    • the field name and attributes are displayed on line 1
    • data is displayed vertically (character, zone and decimal) on lines 2, 3, and 4
    • a scale is displayed on line 5.

Because five screen lines are used, setting WIDEHEX to YES impacts the KEEP value. When WIDEHEX is set to NO, the value for KEEP can be from 3 to 11. When WIDEHEX is set to YES, the value for KEEP can only be from 5 to 11. Attempting to set WIDEHEX to YES while the value for KEEP is 3 or 4 will generate an error message and WIDEHEX will remain set to NO.

Specifies whether to use an alternate screen size for the terminal, if it supports more than one size. Valid entries are:

ON: Uses the alternate screen size generated in the CICS terminal definition for the terminal.

OFF: Uses the default screen size from the CICS terminal definition in use.

OPT

Turns the internal screen optimizer on and off. Valid values are:

ON: Screen optimization is on; only modified data is sent to the screen.

OFF: Screen optimization is off. A SEND/ERASE command is issued every time a screen is displayed.

ALARM

Specifies whether to sound the audible alarm on your terminal when an error is detected. Valid entries are ON and OFF.

DELIM

Specifies the delimiting character to be used to separate multiple Code Debug CICS primary commands entered together. Any character is a valid delimiter except alphanumeric characters (a to z, A to Z, and 0 to 9), period (.), comma (,), blank ( ), underscore (_), and equal (=). The default is a semi-colon (;).

CMDSIZE

Allows users to set the command line size. Valid values are:

1: (Default) Sets the command line size to one line.

2: Sets the command line size to two lines.

3: Sets the command line size to three lines.

TRANSLATE

Specifies whether the profile-level translate overrides should be used.

OFF: (Default) Does not use the profile-level output translate table.

ON: Uses the profile-level output translate table.

CSECTS

Specifies whether to automatically select CSECTs for debugging when you initiate a debugging session. Valid values are:

NONE: (Default) No CSECTs are to be selected automatically.

ALL: All CSECTs are to be selected automatically.

Mask: CSECTs matching the specified mask are to be selected automatically. You may specify up to six masks. As asterisk (*) can be used as a wildcard character.