HP 3000 Manuals HP 3000 Manuals
Breakpoint Commands
Overall Breakpoint Commands
Table I-7. Overall Breakpoint Commands
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| lb | | Displays all breakpoints in the program, |
| | { lb } | both active and suspended, and the overall |
| | { list breakpoints} | breakpoint state. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| tb | | Toggles the overall breakpoint state from |
| | { tb } | active to suspended or vice versa. The |
| | { toggle breakpoints} | state of the individual breakpoints remains |
| | | unchanged. |
| | | |
------------------------------------------------------------------------------------------------
Breakpoint Creation Commands
Table I-8. Breakpoint Creation Commands
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| b | | Sets a breakpoint at |
| | { b } [ location] [ \count] [ command-list] | the location that you |
| | { breakpoint} | specify. If you do not |
| | | enter a location, the |
| | | current line in the |
| | | source window is used. |
| | | The breakpoint is |
| | | executed on each |
| | | occurrence (count) that |
| | | you specify. You can |
| | | enter a list of |
| | | commands to be executed |
| | | at the breakpoint by |
| | | entering the command |
| | | list. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| ba | | Sets a breakpoint at |
| | { ba } address [ \count] [ command-list] | the specified address. |
| | { breakpoint address} | Note that the address |
| | | can be specified by |
| | | giving the name of a |
| | | procedure or an |
| | | expression containing a |
| | | name. The breakpoint |
| | | is executed on each |
| | | occurrence (count) that |
| | | you specify. You can |
| | | enter a list of |
| | | commands to be executed |
| | | at the breakpoint by |
| | | entering the command |
| | | list. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| bb | | Sets a breakpoint at |
| | { bb } [ depth] [ \count] | the first executable |
| | { breakpoint beginning} | statement of the |
| | | procedure at the |
| | [ command-list] | specified depth on the |
| | | program stack. If you |
| | | do not enter a depth, |
| | | the procedure shown in |
| | | the source window is |
| | | used. The breakpoint |
| | | is executed on each |
| | | occurrence (count) that |
| | | you specify. You can |
| | | enter a list of |
| | | commands to be executed |
| | | at the breakpoint by |
| | | entering the command |
| | | list. |
| | | |
------------------------------------------------------------------------------------------------
Table I-8. Breakpoint Creation Commands (cont.)
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| bt | | Sets a trace breakpoint |
| | { bt } [ proc ] [ \count] [ command-list] | at the current or named |
| | { breakpoint trace} [ depth] | procedure or at the |
| | | procedure that is at |
| | | the specified depth on |
| | | the program stack. A |
| | | breakpoint is set at |
| | | the entry and exit |
| | | point of the procedure. |
| | | If you include a |
| | | command list, it is |
| | | executed at the |
| | | beginning of the |
| | | procedure or |
| | | subprogram. The |
| | | following command list |
| | | will be executed at the |
| | | end of the procedure or |
| | | subprogram. |
| | | |
| | | |
| | | { Q;p $ret0\d;c} |
| | | |
| | | If you omit a command |
| | | list, the following two |
| | | command lists are |
| | | executed at the |
| | | beginning and end of |
| | | the procedure or |
| | | subprogram, |
| | | respectively. |
| | | |
| | | |
| | | { Q; t 2; c} |
| | | |
| | | { Q;p $ret0\d;c} |
| | | |
------------------------------------------------------------------------------------------------
Table I-8. Breakpoint Creation Commands (cont.)
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| bu | | Sets an uplevel |
| | { bu } [ depth] [ \count] [ command-list] | breakpoint to occur |
| | { breakpoint uplevel} | immediately on return |
| | | from the procedure at |
| | | the specified depth on |
| | | the program stack. If |
| | | you do not enter a |
| | | depth, the procedure |
| | | shown in the source |
| | | window is used. The |
| | | breakpoint is executed |
| | | on each occurrence |
| | | (count) that you |
| | | specify. You can enter |
| | | a list of commands to |
| | | be executed at the |
| | | breakpoint by entering |
| | | the command list. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| bx | | Sets an exit breakpoint |
| | { bx } [ depth] [ \count] [ command-list] | at the epilogue code of |
| | { breakpoint exit} | the procedure at the |
| | | specified depth on the |
| | | program stack. If you |
| | | do not enter a depth, |
| | | the procedure shown in |
| | | the source window is |
| | | used. The breakpoint |
| | | is executed on each |
| | | occurrence (count) that |
| | | you specify. You can |
| | | enter a list of |
| | | commands to be executed |
| | | at the breakpoint by |
| | | entering the command |
| | | list. |
| | | |
------------------------------------------------------------------------------------------------
Breakpoint Status Commands
Table I-9. Breakpoint Status Commands
-----------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| ab | | Activates the breakpoint having the |
| | { ab } [ number] | number (ID) that you specify. If you do |
| | { activate breakpoint} [ * ] | not enter a number, the breakpoint at the |
| | | current line is activated. Use the |
| | | asterisk (*) to activate all breakpoints, |
| | | including all-procedure breakpoints. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| bc | | Sets the count of the specified |
| | { bc } number expr | breakpoint number to the integer value of |
| | { breakpoint count} | the evaluated expression that you enter. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| db | | Deletes the breakpoint having the number |
| | { db } [ number] | (ID) that you specify. If you do not |
| | { delete breakpoint} [ * ] | enter a number, the breakpoint at the |
| | | current line is deleted. Use the |
| | | asterisk (*) to delete all breakpoints |
| | | including all-procedure breakpoints. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| sb | | Suspends (deactivates) the breakpoint |
| | { sb } [ number] | having the number (ID) that you specify. |
| | { suspend breakpoint} [ * ] | If you do not enter a number, the |
| | | breakpoint at the current line is |
| | | suspended. Use the asterisk (*) to |
| | | suspend all breakpoints, including |
| | | all-procedure breakpoints. This also |
| | | causes the overall breakpoint state to |
| | | become suspended. |
| | | |
-----------------------------------------------------------------------------------------------
All-Procedures Breakpoint Commands
Table I-10. All-Procedures Breakpoint Commands
-----------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| bp | | Sets permanent procedure breakpoints at |
| | { bp } | the first executable statement of every |
| | { breakpoint procedure} | procedure for which debugger information |
| | | is available. The breakpoint is |
| | [ command-list] | encountered each time the procedure is |
| | | entered. When any entry procedure |
| | | breakpoint is encountered, the command |
| | | list is executed. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| bpt | | Sets permanent procedure trace |
| | | breakpoints at the first and last |
| | bpt [ command-list] | executable statement of every procedure |
| | | for which debugger information is |
| | | available. The breakpoints are |
| | | encountered each time the procedure is |
| | | entered. The commands, if any, are |
| | | associated with the entry breakpoint. If |
| | | no command list is specified, the entry |
| | | command list defaults to: |
| | | |
| | | {Q;t 2;c} |
| | | |
| | | The exit command list is: |
| | | |
| | | {Q;p $ret\d;c} |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| bpx | | Sets permanent procedure exit breakpoints |
| | | after the last executable statement of |
| | bpx [ command-list] | every procedure for which debugger |
| | | information is available. The breakpoint |
| | | is encountered each time the procedure is |
| | | exited. When any procedure exit |
| | | breakpoint is encountered, the command |
| | | list is executed. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| dp | | Deletes all procedure breakpoints set |
| | { dp } | with the bp (breakpoint procedure) |
| | { delete procedure} | command. All breakpoints set by commands |
| | | other than the bp command will remain in |
| | | effect. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| Dpt | | Deletes all procedure trace breakpoints |
| | | at the first and last executable |
| | Dpt | statement of every procedure. All |
| | | breakpoints set by commands other than |
| | | the bpt command will remain in effect. |
| | | |
-----------------------------------------------------------------------------------------------
| | | |
| Dpx | | Deletes all procedure exit breakpoints at |
| | | the last executable statement of every |
| | Dpx | procedure. All breakpoints set by |
| | | commands other than the bpx command will |
| | | remain in effect. |
| | | |
-----------------------------------------------------------------------------------------------
Global Breakpoint Commands
Table I-11. Global Breakpoint Commands
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| abc | | Defines a global breakpoint command list |
| | | which will be executed whenever any user |
| | abc command-list | defined breakpoint is encountered. These |
| | | include normal, procedure, procedure trace, |
| | | and procedure exit breakpoints. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| dbc | | Deletes the global breakpoint command list. |
| | | |
| | dbc | |
| | | |
------------------------------------------------------------------------------------------------
All-Paragraph Breakpoint Commands
Table I-12. Paragraph Breakpoint Commands
------------------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| bpg | | Sets permanent paragraph breakpoints |
| | { bpg } [ command-list] | at the first executable statement of |
| | { breakpoint paragraph} | every HP COBOL II paragraph and |
| | | section for which debugger |
| | | information is available. The |
| | | breakpoint is encountered each time |
| | | the paragraph or section is entered. |
| | | When any entry paragraph breakpoint |
| | | is encountered, the command list is |
| | | executed. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| dpg | | Deletes all paragraph breakpoints set |
| | { dpg } | with the bpg (breakpoint paragraph) |
| | { delete paragraph} | or tpg (trace paragraph) commands. |
| | | Breakpoints set with other commands |
| | | will remain in effect. |
| | | |
------------------------------------------------------------------------------------------------
| | | |
| tpg | | Sets permanent paragraph trace |
| | { tpg } [ command-list] | breakpoints at the first executable |
| | { trace paragraph} | statement of every HP COBOL II |
| | | paragraph and section for which |
| | | debugger information is available. |
| | | The breakpoints are encountered each |
| | | time the paragraph or section is |
| | | entered. The command list, if any, |
| | | is associated with the entry |
| | | breakpoint. If no command list is |
| | | specified, the entry command list |
| | | defaults to: |
| | | |
| | | {Q;t 2;c} |
| | | |
------------------------------------------------------------------------------------------------
Auxiliary Breakpoint Commands
Table I-13. Auxiliary Breakpoint Commands
--------------------------------------------------------------------------------------
| | | |
| Cmd | Syntax | Description |
| | | |
--------------------------------------------------------------------------------------
| | | |
| "any string" | | The string command |
| | | displays any string |
| | "any string" | that is enclosed in |
| | | quotation marks. |
| | | |
--------------------------------------------------------------------------------------
| | | |
| i | | The i (if) command |
| | { i } expr command-list [ command-list] | lets you |
| | { if} | conditionally execute |
| | | commands in a command |
| | | list. If the |
| | | expression evaluates |
| | | to a non-zero value, |
| | | the first group of |
| | | commands is executed. |
| | | If the expression |
| | | evaluates to zero, |
| | | the second command |
| | | list, if it exists, |
| | | is executed. |
| | | |
--------------------------------------------------------------------------------------
| | | |
| Q | | The Q(Quiet) command |
| | { Q } | suppresses the |
| | { Quiet} | "breakpoint at |
| | | address..." debugger |
| | | messages that are |
| | | normally displayed |
| | | when a breakpoint is |
| | | encountered. The Q |
| | | (Quiet) command must |
| | | be the first command |
| | | in a command list; |
| | | otherwise, it is |
| | | ignored. |
| | | |
--------------------------------------------------------------------------------------