Many debug commands are available for use with the ILE source debugger. The debug commands and their parameters are entered on the Debug command line displayed on the bottom of the Display Module Source and Evaluate Expression displays. These commands can be entered in upper, lower or mixed case. Refer to ILE Concepts book for a further discussion of the debug commands.
Table 4 summarizes these debug commands. The online help for
the ILE source debugger describes the debug commands and explains their
allowed abbreviations.
Table 4. ILE Source Debugger Commands
Debug Command | Description |
---|---|
ATTR | Permits you to display the attributes of a variable. The attributes are the size and type of the variable as recorded in the debug symbol table. Refer to Table 5 for a list of attributes and their ILE COBOL equivalences. These attributes are not the same as the attributes defined by ILE COBOL. |
BREAK | Permits you to enter either an unconditional or conditional job breakpoint at a position in the program being tested. Use BREAK position WHEN expression to enter a conditional job breakpoint. |
CLEAR | Permits you to remove conditional and unconditional breakpoints, or to remove one or all active watch conditions. |
DISPLAY | Allows you to display the names and definitions assigned by using the EQUATE command. It also allows you to display a different source module than the one currently shown on the Display Module Source display. The module object must exist in the current program object. |
EQUATE | Allows you to assign an expression, variable, or debug command to a name for shorthand use. |
EVAL | Allows you to display or change the value of a variable or to display the value of expressions, records, group items, or arrays. |
QUAL | Allows you to define the scope of variables that appear in subsequent EVAL or WATCH commands. |
SET | Allows you to change debug options, such as the ability to update production files, specify if find operations are to be case-sensitive, or to enable OPM source debug support. |
STEP | Allows you to run one or more statements of the program being debugged. |
TBREAK | Permits you to enter either an unconditional or a conditional breakpoint in the current thread at a position in the program being tested. |
THREAD | Allows you to display the Work with Debugged Threads display or change the current thread. |
WATCH | Allows you to request a breakpoint when the contents of a specified storage location is changed from its current value. |
FIND | Searches ahead in the module currently displayed for a specified line number or string or text. |
UP | Moves the displayed window of source towards the beginning of the view by the amount entered. |
DOWN | Moves the displayed window of source towards the end of the view by the amount entered. |
LEFT | Moves the displayed window of source to the left by the number of characters entered. |
RIGHT | Moves the displayed window of source to the right by the number of characters entered. |
TOP | Positions the view to show the first line. |
BOTTOM | Positions the view to show the last line. |
NEXT | Positions the view to the next breakpoint in the source currently displayed. |
PREVIOUS | Positions the view to the previous breakpoint in the source currently displayed. |
HELP | Shows the online help information for the available source debugger commands. |
The ILE source debugger does not describe the attributes of variables in
the same manner as ILE COBOL. Table 5 shows the equivalence between the attributes of variables as
described by the ILE source debugger and ILE COBOL data categories.
Table 5. Equivalence Between ILE Source Debugger Variable Attributes and ILE COBOL Data Categories
ILE source debugger attributes of variables | ILE COBOL data categories |
---|---|
FIXED LENGTH STRING |
Alphabetic Alphanumeric Alphanumeric-edited Numeric-edited External floating-point Date Time Timestamp |
GRAPHIC |
DBCS DBCS-edited |
CHAR | Boolean |
BINARY | Binary |
ZONED(2,0) | Zoned Decimal |
PACKED(2,0) |
Packed Decimal Packed Date Packed Time |
PTR |
Pointer Procedure-pointer |
REAL | Internal floating-point |
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.