home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Professional
/
OS2PRO194.ISO
/
os2
/
prgramer
/
rexx
/
rdebug
/
rdbhelp.hlp
< prev
next >
Wrap
Text File
|
1993-03-25
|
51KB
|
1,260 lines
_
_
_ rDEBUG Help
_
_ Help not available yet on this item.
_
_
_
_
HHA_About rDEBUG
HHA_ rDEBUG
HHA_ Version 2.0
HHA_
HHA_ Copyright (C) 1992 All right reserved
HHA_ J Gil Gagnon & Associates Inc
HHA_ 25-814 Glenn Hawthorne Boulevard
HHA_ Mississauga, Ontario L5R 3E6
HHA_ 416-568-3105
HC_Table of Contents
HC_
HC_ Orientation Keys
HC_ Using Help Shortcut Keys Summary
HC_ Using Menus and Commands Editing Keys
HC_ Using a Dialog Box View and Search Keys
HC_ Syntax Conventions Run and Debug Keys
HC_ Help Keys
HC_ Using rDEBUG
HC_ rDEBUG Commandline Quick Reference
HC_ rDEBUG Tips ASCII Character Codes
HC_ Glossary Keyboard Scan Codes
HC_ Version Differences Run-Time Error Codes
HC_ Beyond rDEBUG
HC_
HC_ Using Rexx Using the Editor
HC_ REXX Editor Tutorial
HC_
RT_rDEBUG Tips
RT_ 1. Use HOME key to get to commandline.
RT_ 2. how to read the session log:
RT_ - a line with a leading asterisk signifies a a response
RT_ or error message; the number following it refers to the
RT_ number of the source line to which it corresponds.
RT_ The first such line is a copy of the source line,
RT_ The second is the result of a translation of the above line
RT_ after all special characters and 'call' have been removed
RT_ (this prevents functions and procedures from being reexecuted).
RT_ - a line without an asterisk is a rDEBUG command you
RT_ entered or invoked from a menu selection.
RT_ - Note, not all commands are displayed permanently in the
RT_ log, instead, see the message(s) in yellow at the top of
RT_ the screen. They are placed there rather than in the log
RT_ because the bottom window is not the d-file.
RT_ 3. how to read d-file.
RT_ - the first line contains several special clauses for
RT_ rDEBUG initialization. It also contains your first line.
RT_ - other lines, are in two parts: a prefix control command,
RT_ normally 'Call debug 1...2:' (the 2: is the label
RT_ for the current line) and your original instruction line.
RT_ 4. to run external commands with the Editor commandline, prefix
RT_ DOS to them.
RT_ 5. to redo last instruction (trace's '='); use go x (where
RT_ x=line number of instruction line to repeat)
RT_ 6. to get last command entered press ctrl-up, however, just
RT_ ignore the 'NOMSG MSG' prefix.
RT_ 7. If rDEBUG should fail and your source has not been saved,
RT_ you still may do so by invoking RDBEND in the commandline
RT_ of the d-file.
RT_ 8. on new programs, carry out the following preliminary steps:
RT_ - run Indent (pretty printer) - (ALT-t,i)
RT_ - run match delimiters - (ALT-t,m)
RT_ - run cross reference - (ALT-t,x)
RT_ - run syntax (recognizer) - (ALT-t,y)
RT_ 9. use editted portions of the session logs as a means of
RT_ reporting errors. Also make notes to yourself on further
RT_ testing that may be required and avenues for research.
RT_ 10. define all variables before referencing them.
RT_ 11. you may turn off display of initial screens by changing
RT_ line 2 "dbscreens=1" to 0 in file rdbINIT.kex.
RT_
RT_ Related topics
RT_ d-file
RT_ prefix control command
ET_Editor tutorial
ET_
ET_ While a knowledge of Editor is not required to run rDEBUG it will
ET_ help to know some of the following useful Editor commands, You
ET_ must enter at least the capitalized letters of each command.
ET_ Caution, at the present time, you may not enter multiple
ET_ commands because the 'linend' character is not supported.
ET_
ET_ <HOME> - returns you to the commandline (where ====> is) after
ET_ working in file area. You must be in the commandline to
ET_ enter any of the following commands:
ET_ /string - causes the Editor to make the next line containing
ET_ string the current line.
ET_ :no - causes the Editor to make line 'no' the current line
ET_ which is in the center of the d-file screen and the bottom
ET_ line of the session.log and is highlighted.
ET_ ALL [target] - causes only lines containing target to display,
ET_ To restore normal display use 'ALL' with no target.
ET_ Change /string1/string2/ [target [n [m]]] - causes search
ET_ of all occurrences of string1 and replaces then with
ET_ string2 from current line to nth line and for m
ET_ occurrences.
ET_ DIR {filespec...] - is similar to OS/2 DIR command but displays
ET_ output in a file, where you can select a file with ALT-X
ET_ DOS [command]: use it as a prefix to execute an external
ET_ command
ET_ DUPlicate [n] - copy the next n lines
ET_ FFile [fileid]: unconditionally save and quit current file
ET_ optionally giving it the name fileid.
ET_ [Locate] target - to make the next line containing target the
ET_ current line, e.g. /abc/
ET_ QQuit - unconditionally quit current file
ET_ SSave [fileid] - to save the current file and optionally
ET_ giving it the name fileid.
ET_ Xedit [fileid] - use to begin editting another file.
ET_ special shortcut keys - because rDEBUG uses ALT as a prefix, you
ET_ may use CTRL to access most KEDIT ALT combinations, except
ET_ copy block (ALT-C) which would become CTRL-C which is used by
ET_ signal on HALT.
ET_
ET_ Related topics
ET_ Editor
ET_ prefix control command
GL_ GLOSSARY
GL_
GL_breakpoint
GL_ a line in your program where execution is halted because:
GL_ 1. an exit statement has been encountered.
GL_ 2. upon leaving the source program, a breakpoint is
GL_ automatically given so that the program can
GL_ be re-executed if you so desire.
GL_ 3. you have set a breakpoint
GL_ 4. the nth line has been executed.
GL_ 5. a variable, you designate, changes value or a specified
GL_ condition has been met.
GL_ 6. you press CTRL-BREAK.
GL_
GL_commandline
GL_ an area following the arrow at the bottom of each window
GL_ where you may optionally enter text-based commands to
GL_ control rDEBUG and the Editor.
GL_
GL_d-file
GL_ a special macro file that contains a copy of your source
GL_ program or macro; has calls to rDEBUG routines appended to
GL_ most lines and has the debugging routines added to the end
GL_ of the file. Note, the d-file displayed does not contain
GL_ the debugging routines. However, the d-file stored in the
GL_ current directory and the file that is being executed in
GL_ memory, do have them.
GL_
GL_Editor
GL_ a text-based editor (KEDIT on the PC and XEDIT on VM/CMS)
GL_ that rDEBUG uses to access REXX.
GL_
GL_host system
GL_ is the operating system under which rDEBUG will run, either
GL_ OS/2, DOS or VM/CMS.
GL_
GL_prefix control commands
GL_ are calls to the debugging routines contained in the d-file
GL_
GL_profile
GL_ a file, unique to each program or macro that you are
GL_ debugging, that contains the current values for configuration
GL_ switches or options and the location of each prefix control
GL_ command within the d-file.
GL_
GL_source
GL_ your program or macro to be debugged which is also contained in
GL_ the d-file.
GL_
GL_stepping
GL_ the process of telling rDEBUG how to trace each line of your
GL_ program. F8 directs to execute and trace one line, F10 does
GL_ the same except all calls to subroutines are done in one step.
GL_
GL_watchpoint
GL_ an event that causes a break in the execution of your program
GL_ There are two such events:
GL_ 1. whenever a named variable changes value and
GL_ 2. when a specified condition evaluates to true, e.g. (n>10).
HHI_Index online help
HHI_
HHI_ To get help on a rDEBUG keyword in the list below:
HHI_ 1. Use the direction keys to move the cursor to the keyword.
HHI_ 2. Press F1 to display the help text in
HHI_ the Help window.
HHI_ ADD WATCH ERROR
HHI_ BREAK EXCLUDE
HHI_ CASE EXIT
HHI_ CONTINUE FILES
HHI_ COUNT FULL
HHI_ DEBUG GO
HHI_ DISCARD GOTO CURSOR
HHI_
HHI_ INDENT PROCEDURE STEP
HHI_ LOG PROFILER
HHI_ MATCH DELIMITER RESTART
HHI_ MENU/WINDOW SAVE
HHI_ NEW SAVEAS
HHI_ NEXT SET NEXT STATEMENT
HHI_ OPEN SHOW
HHI_ OUTPUT SCREEN SHOW WATCH
HHI_ PRINT
HHI_
HHI_ SKIP TOGGLE WATCHES
HHI_ START Topic
HHI_ STEP TRACE
HHI_ STRUCTURE WAIT
HHI_ SWITCH SCREEN WATCH
HHI_ SYNTAX XREF
HHI_ TALLY ZOOM SCREEN
HHI_ TOGGLE ALL BREAKPOINTS About rDEBUG
HHI_ TOGGLE BREAKPOINT
HHI_
HHI_ REPEAT LAST FIND
HHI*_CHANGE
HHI*_DISPLAY
HHI*_FIND
HHI*_ *SPLIT
HHI*_ *SYNTAX CHECKING
HHI_
HU_Using help
HU_ ■ To get help on a REXX keyword, place the cursor on it and press F1
HU_ or click the right mouse button.
HU_
HU_ ■ To get help on a rDEBUG menu, command, or dialog box, place the cursor
HU_ on the menu item or <Help> button and press F1.
HU_
HU_ ■ To view rDEBUG Help topics, press Alt+H, then press the capital
HU_ letter to choose a command.
HU_
HU_ ■ To move the cursor into the Help window, press Shift+F6.
HU_
HU_ To scroll the help information, press PgDn or PgUp.
SG_Using rDEBUG Survival Guide
SG_
SG_ ■ To activate the rDEBUG menu bar, press Alt.
SG_ ■ To activate menus and commands, press the capital letter.
SG_ ■ To move between menus and commands, use the direction keys.
SG_ ■ To get help on a selected keyword, command, or dialog box, press F1.
SG_ ■ To exit Help, press Esc.
SG_
SG_ Browsing the Help system:
SG_
SG_ ■ To select one of the following topics, press the Tab key or the first
SG_ letter of the topic. Then press the Enter key to see:
SG_
SG_ Index The Index for rDEBUG Help
SG_ KEDIT The Index for KEDIT Help
SG_ Rexx The Index for REXX Help
SG_ Contents The Table of Contents for rDEBUG Help topics
SG_ Using Help Information on using rDEBUG Help
SG_
SG_ Tip: These topics are also available from the Help menu.
XP*_Help Path Command
XP*_
XP*_ Use to change the directories rDEBUG searches to find
XP*_ the rDEBUG Help file, rDEBUG.HLP.
XP*_
HDA_Toggle All Breakpoints Command
HDA_
HDA_ Use to temporarily remove all breakpoints from your program.
HDA_ To restore them use Clear all breakpoints Command again.
HDA_
HDA_ Use Toggle Breakpoint (or press F9) to turn individual
HDA_ breakpoints off.
HDA_
HDA_ Related topics
HDA_ BREAK Breakpoint
HDA_ DEBUG TOGGLE BREAKPOINT
HDA_ EXCLUDE
HDA_ SKIP
HDA_
HDN_Set Next Statement Command
HDN_
HDN_ Use to change the program execution sequence so the next
HDN_ statement executed is the one the cursor is on.
HDN_
HDN_ Related topics
HDN_ NEXT
HDN_ RESTART
HDN_ GO TO CURSOR
HDN_ SKIP
HDN_
HDP_Procedure Step Command
HDP_
HDP_ Use Procedure Step (or press F10) to run a single statement
HDP_ in your program and to run a procedure call and the
HDP_ procedure it calls as a single statement.
HDP_
HDP_ Procedure Step, like the Step command, allows you to move
HDP_ through the execution of a program one step at a time, but
HDP_ it saves you from stepping through procedures that you
HDP_ know work correctly.
HDP_
HDP_ Related topics
HDP_ START
HDP_ RESTART
HDP_ GO
HDP_ GO TO CURSOR
HDP_ CONTINUE
HDP_ stepping
HDP_
HDB_Toggle Breakpoint Command
HDB_
HDB_ Use Toggle Breakpoint (or press F9) to turn breakpoints
HDB_ on and off. Breakpoints are markers placed on statements
HDB_ in your program. If you run your program and it encounters
HDB_ a breakpoint, the program stops on that statement. rDEBUG
HDB_ highlights the breakpoint line.
HDB_
HDB_ To turn a breakpoint on and off:
HDB_ 1. Move the cursor to the line you want the breakpoint
HDB_ on, or to a highlighted breakpoint line.
HDB_ 2. Choose Toggle Breakpoint (or press F9).
HDB_
HDB_ Use a breakpoint to pause your program at a point where
HDB_ you suspect problems, then:
HDB_ ■ Display the values of variables with the say command.
HDB_ ■ Single step your program from the breakpoint forward.
HDB_
HDB_ Related topics
HDB_ Breakpoint
HDB_ TOGGLE ALL BREAKPOINT
HDS_Step Command
HDS_
HDS_ Use Step (or press F8) to run a single statement in your
HDS_ program.
HDS_
HDS_ See also Procedure Step to execute whole procedures in one
HDS_ step.
HDS_
HDS_ Related topics
HDS_ START
HDS_ RESTART
HDS_ GO
HDS_ GO TO CURSOR
HDS_ CONTINUE
HDT_Trace On/Off Command
HDT_
HDT_ Use to highlight each statement in your program as it
HDT_ executes. This lets you observe the general flow of your
HDT_ program. Press Ctrl+Break to suspend program execution.
HDT_
HDT_ Related topics
HDT_ LOG
HEC*_Change Command
HEC*_ / string1 / string2 /
HEC*_ Use to replace one text string with another.
HEC*_
HEC*_ You can:
HEC*_ ■ Use a case-insensitive search
HEC*_ ■ Check each replacement before the change is made.
HEC*_ ■ Make all replacements without checking them.
HEC*_
HEF*_*Find Command
HEF*_
HEC*_ / string1[/]
HEF*_ Use to search for a text string. You can request a
HEF*_ case-sensitive match.
HEF*_
HEF*_ To change a string, use the Change command.
HEF*_
HER_Repeat Last Find Command
HER*_
HER*_ Use Repeat Last Find (or press F3) to repeat the search
HER*_ performed by the most recent Find.
HER*_
HES*_Split Command
HES*_
HES*_ Use to divide the View window horizontally and work on two
HES*_ parts of a program at the same time.
HES*_
HES*_ Use F6 and Shift+F6 to move between the windows:
HES*_ ■ F6 moves the cursor down through the windows.
HES*_ ■ Shift+F6 moves the cursor up.
HES*_
HES*_ To close a second View window, place your cursor in the
HES*_ window that you want to keep active, and choose Split again.
HES*_
HFN_New Command
HFN_
HFN_ Use to create a new program. A dialog box will appear if
HFN_ you already have an existing program open. Then:
HFN_ ■ Choose <Yes> to save the existing program.
HFN_ ■ Choose <No> to close the program without saving it.
HFN_ ■ Choose <Cancel> to cancel the New command and return
HFN_ to the existing program.
HFN_
HFN_ Tip: Use the Open command to load an existing program.
HFN_
HFO_Open Command
HFO_
HFO_ Use to load an existing program so you can run it
HFO_ or make changes to it.
HFO_
HFO_ Use the New command to create a new program.
HFO_
HFP_Print Command
HFP_
HFP_ Use to print the current session.log or if any parameters
HFP_ are also supplied executes the Editor PRINT command.
HFP_
HFP_ rDEBUG prints to the printer connected to the LPT1 device
HFP_ on your computer. See line 2 of rDEBUG.KEX to use another port.
HFP_
HFS_Save Command
HFS_
HFS_ Use to save the current version of your program.
HFS_
HFA_Save As Command
HFA_
HFA_ Use to save your program as a file. To preserve the
HFA_ previous version of your program, rename it in the
HFA_ File Name text box.
HFA_
HFE_Exit Command
HFE_
HFE_ Use to leave the rDEBUG environment.
HFE_
HFE_ If your program file has changed since you last saved it,
HFE_ rDEBUG displays a dialog box.
HFE_ ■ Choose <Yes> to save your program, including changes.
HFE_ ■ Choose <No> to discard your changes.
HFE_ ■ Choose <Cancel> to cancel the Exit command and
HFE_ continue debugging your program.
HFE_
H1E_Exit Command
H1E_
H1E_ Use to leave the rDEBUG environment without saving the
H1E_ existing program if there is one.
H1E_
H1N_New Command
H1N_
H1N_ Use to create a new program without saving an existing
H1N_ program if there is one.
H1N_
H1N_ Tip: Use the Open command to load an existing program.
H1N_
H1O_Open Command
H1O_
H1O_ Use to load an existing program so you can run it
H1O_ or make changes to it.
H1O_
H1O_ Use the New command to create a new program.
H1O_
H1P_Print Command
H1P_
H1P_ Use to print all of a program.
H1P_
H1P_ rDEBUG prints to the printer connected to the LPT1 device
H1P_ on your computer.
H1P_
H1C_Continue Command
H1C_
H1C_ Use to leave this file and continue with rDEBUG.
H1C_
H1S_Save Command
H1S_
H1S_ Use to save the current version of your program.
H1S_
H1A_Save As Command
H1A_
H1A_ Use to save your program as a file. To preserve the
H1A_ previous version of your program, rename it in the
H1A_ File Name text box that will subsequently appear.
H1A_
H2E_Exit Command
H2E_
H2E_ Use to leave the rDEBUG environment without saving an existing
H2E_ program if there is one.
H2E_
H2N_New Command
H2N_
H2N_ Use to start a new session log rather the continuing with
H2N_ old one.
H2N_
H2P_Print Command
H2P_
H2P_ Use to print the session log shown.
H2P_
H2P_ rDEBUG prints to the printer connected to the LPT1 device
H2P_ on your computer.
H2P_
H2C_Continue Command
H2C_
H2C_ Use to leave this file and continue with rDEBUG.
H2C_
H2S_Save Command
H2S_
H2S_ Use to save the session log which you may have modified.
H2S_
H2S_ Note, saving this file also indicates that you want to
H2S_ use this session log to recreate the last session.
H2S_
H2A_Save As Command
H2A_
H2A_ Use to save the session log under a new name.
H2A_
H2R_Rerun Command
H2R_ Use to re-execute the last session to the point where
H2R_ you previously left off, providing all the required files
H2R_ still exist.
H3E_Exit Command
H3E_
H3E_ Use to leave the rDEBUG environment without saving an existing
H3E_ program if there is one.
H3E_
H3N_New Command
H3N_
H3N_ Use to get the default profile.
H3N_
H3N_ Related topics
H3N_ Profile
H3P_Print Command
H3P_
H3P_ Use to print the current profile shown.
H3P_
H3P_ rDEBUG prints to the printer connected to the LPT1 device
H3P_ on your computer.
H3P_
H3P_ Related topics
H3P_ Profile
H3C_Continue Command
H3C_
H3C_ Use to leave this file and continue with rDEBUG.
H3C_
H3S_Save Command
H3S_
H3S_ Use to save the profile which you may have modified.
H3S_
H3S_ Related topics
H3S_ Profile
H3A_Save As Command
H3A_
H3A_ Use to save the profile under a new name.
H3A_
H3A_ Related topics
H3A_ Profile
H4E_Exit Command
H4E_
H4E_ Use to leave the rDEBUG environment without saving an existing
H4E_ program if there is one.
H4E_
H4C_Continue Command
H4C_
H4C_ Use to leave this file and continue with rDEBUG.
H4C_
H4S_Save Command
H4S_
H4S_ Use to save the program which you may have modified.
H4S_
HHC_Contents Command
HHC_
HHC_ Use to display the Help table of contents. The Help table
HHC_ of contents provides a topical guide to the information in
HHC_ rDEBUG Help.
HHC_
HHC_ To get help on any item in the table of contents:
HHC_ 1. Choose the Contents command from the Help menu.
HHC_ 2. Press the letter key corresponding to the first letter
HHC_ of the item. Repeat until the cursor is on the topic
HHC_ you want help on.
HHC_ 3. Press F1.
HHC_
HHT_Topic Command
HHT_
HHT_ Use to display information on a topic determined by the
HHT_ current location of the cursor. The topic the cursor is
HHT_ on appears as part of the command.
HHT_
HHT_ You can also display topic Help by pressing F1.
HHT_
HOD*_Display Command
HOD*_
HOD*_ Use to control:
HOD*_ ■ Screen colors.
HOD*_ ■ Scroll bars in windows.
HOD*_ ■ The number of spaces the Tab key advances the cursor.
HOD*_
HOD*_ Display settings are saved and remain in effect the next
HOD*_ time you start rDEBUG.
HOD*_
HRC*_Continue Command
HRC*_
HRC_ Use Continue (or press F5) to resume running a program
HRC_ after it has stopped. Continue does not clear data you
HRC_ entered while the program was running and begins the
HRC_ program from the last statement executed, rather than
HRC_ from the beginning.
HRC_
HRC_ Continue is often used to resume program execution after
HRC_ a breakpoint.
HRC_
HRG_Go to Cursor Command
HRG_
HRG_ Use to execute your program from the start to the location
HRG_ where the cursor lies.
HRG_
HRG_ Related topics
HRG_ PROCEDURE STEP
HRG_ STEP
HRG_ START
HRG_ RESTART
HRG_ GO
HRG_ CONTINUE
HRR_Restart Command
HRR_
HRR_ Use to prepare a program to start over from the beginning.
HRR_ RESTART causes rDEBUG to SAVE all the changes you may have
HRR_ made to the copy of your program in the d-file and uses the
HRR_ new source.
HRR_
HRR_ Related topics
HRR_ PROCEDURE STEP
HRR_ STEP
HRR_ START
HRR_ GO
HRR_ CONTINUE
HRS_Start Command
HRS_
HRS_ Use Start (or press Shift+F5) to start running a program
HRS_ beginning with the first executable statement in the main
HRS_ module.
HRS_
HRS_ If you stop a program while it is running, Start does not
HRS_ clear any data you entered and starts the program from its
HRS_ beginning.
HRS_
HRS_ Related topics
HRS_ PROCEDURE STEP
HRS_ STEP
HRS_ RESTART
HRS_ GO
HRS_ CONTINUE
HTC_Case Command
HTC_
HTC_ Use Case to style the case of all REXX code in your source
HTC_ file, e.g. ROUTINEA: If abc='ALL' Then Call routineb
HTC_
HTC_ Related topics
HTC_ INDENT
HTF_Files Command
HTF_
HTF_ Use to show the status information on all files active or
HTF_ open files by you and rDEBUG.
HTF_
HTI_Indent Command
HTI_
HTI_ Use to indent in a structured fashion the REXX code in
HTI_ your source file.
HTI_
HTI_ Related topics
HTI_ CASE
HTI_ STRUCTURE
HTP_Profiler Command
HTP_
HTP_ Use to display the execution counts for most lines in the
HTP_ source program (this feature may be used to check if all
HTP_ code has been exercised);
HTP_
HTM_Match Delimiter Command
HTM_
HTM_ Use to verify that your source contains the proper pairing
HTM_ of delimiters like: single and double quotes, comment markers
HTM_ and parenthesis.
HTM_
HTM_
HTS_Structure Command
HTS_
HTS_ Use to display only the REXX control-flow keywords in the
HTS_ source program.
HTS_
HTS_ Related topics
HTS_ INDENT
HTY_Syntax Command
HTY_
HTY_ Use to check the syntax of all REXX commands, keywords and
HTY_ function calls in the source program.
HTY_
HTY_ Related topics
HTY_ CROSS REFERENCE
HTX_Cross Reference Command
HTX_
HTX_ Use to show a cross reference map of all variables and
HTX_ labels in the source program.
HTX_
HTY_ Related topics
HTY_ SYNTAX
HUA_About Command
HUA_
HUA_ Use to display the version number and copyright information
HUA_ for rDEBUG.
HUA_
HUH_Using Help Command
HUH_
HUH_
HUH_ Use to display the Using Help topic. Using Help describes
HUH_ how to use the mouse or keyboard to get help on an item
HUH_ displayed on the rDEBUG screen.
HUH_
HVO_Output Screen Command
HVO_
HVO_ Use Output Screen (or press F4) to view the program
HVO_ output screen or the d-file. The output
HVO_ screen displays the results of a program run in the
HVO_ rDEBUG environment.
HVO_
HCB_Break Command
HCB_ <no/no-no <..no/no-no>>
HCB_
HCB_ use to set a breakpoint. This is the default for line
HCB_ 1 and every exit statement. If no operand, current line is
HCB_ set to BREAK.
HCB_
HCB_ Related topics
HCB_ DEBUG
HCB_ EXCLUDE
HCB_ SKIP
HCB_ TOGGLE BREAKPOINT
HCD_DEBUG Command
HCD_ <no/no-no <..no/no-no>>
HCD_
HCD_ required for every line to be traced. This is the default.
HCD_ If no operand, current line is set to DEBUG.
HCD_
HCD_ Related topics
HCD_ BREAK
HCD_ EXCLUDE
HCD_ SKIP
HCD_ TOGGLE BREAKPOINT
HCE_EXCLUDE Command
HCE_ <no/no-no <..no/no-no>>
HCE_
HCE_ use to limit tracing each individual command as it
HCE_ executes yet does not reset TRACE switch setting. This
HCE_ will speed up execution of loops etc. If no operand,
HCE_ current line is set to EXCLUde.
HCE_
HCE_ Related topics
HCE_ BREAK
HCE_ DEBUG
HCE_ SKIP
HCE_ TOGGLE BREAKPOINT
HCS_SKIP Command
HCS_ <no/no-no <..no/no-no>>
HCS_
HCS_ use to skip code in the source program. See GO command
HCS_ for restrictions. If no operand, current line is set to
HCS_ SKIP.
HCS_
HDA_ Related topics
HDA_ BREAK
HDA_ DEBUG
HDA_ EXCLUDE
HDA_ TOGGLE BREAKPOINT
HOE_Error Switch Command
HOE_ use to toggle the switch that controls trapping of interrupts
HOE_ caused by non-zero return codes from host system commands.
HOE_ Note, this switch only takes effect after 'go 1' or 'restart'
HOF_Full Switch Command
HOF_ use to toggle the inclusion of certain code or features
HOF_ in the debugging files. This may help, especially in the
HOF_ DOS environment, when file size is too great.
HOL_Log Switch Command
HOL_ use to toggle the logging of all session log output except
HOL_ for event trapping output.
HOA_Tally Switch Command
HOA_ use to toggle the collection and display of usage statistics
HOA_ for the source code profiler. See profiler command in Tools.
HOT_Trace Switch Command
HOT_ use to globally toggle the tracing of program flow without
HOT_ having to set or reset all rDEBUG prefix commands.
HOW_Watch Switch Command
HOW_ use to globally toggle the checking for 'watch'es that will
HOW_ cause a breakpoint to occur when they change or meet a
HOW_ specified condition.
HOC_Count and
HOC_ use to cause an automatic breakpoint after the number of
HOC_ lines specified. Default is 50.
HOI_Wait Command
HOI_ use to cause rDEBUG trace to occur after a delay of the
HOI_ specified number of seconds. Default is 0.
HOI_
HVZ_Zoom Screen Command
HVZ_
HVZ_ Use to enlarge the current screen or to return to two screen
HVZ_ mode.
HVZ_
HVS_Switch Screen Command
HVS_
HVS_ Use to transfer focus to other window on the screen.
HVS_
HVM_Menu/Window Command
HVM_
HVM_ Use to bring up current menu or allow data entry in a window
HVM_ when a menu is already on the screen.
HVM_
HWA_Add Watch Command
HWA_
HWA_ Use to add a variable or a condition to the watch list.
HWA_ A conditional watch must be coded within parenthesis:
HWA_ ((a=b)&((c=d)|(e-f))) is equivalent to if a=b & (c=d|e=f).
HWA_ Note, conditional watches should not contain spaces within
HWA_ the parenthesis.
HWA_
HWD_DISCARD Command
HWD_ <var <..var>>
HWD_
HWD_ use to remove WATCH variable(s) or condition(s) from the WATCH
HWD_ table and thus prevent further breakpoints from occurring when
HWD_ they change. To temporarily stop checking of all WATCH
HWD_ variables, use command WATCH 0.
HWE_Edit Watch Command
HWE_
HWE_ Use to display the current values of the watch variables
HWE_ and conditionals.
HWE_
HXS*_Syntax Checking Command
HXS*_
HXS*_ Use to turn Syntax Checking on and off. When Syntax
HXS*_ Checking is on, rDEBUG does the following as you enter
HXS*_ each line of code:
HXS*_ 1. Checks the line for syntax errors.
HXS*_ 2. Formats the line.
HXS*_ 3. Translates the line to executable form if the syntax
HXS*_ is correct.
HXS*_
HWT_Toggle Watches Command
HWT_
HWT_ Use to toggle the checking for variables that will cause a
HWT_ breakpoint to occur when they change or meet a specified condition
HWT_ in the watch list.
HWT_
CM_Using Menus and Commands
CM_
CM_ Use the menu bar at the top of the screen to select menus and commands.
CM_
CM_ Menu action key...
CM_
CM_ Display a menu. Press ALT and the letter key for the menu you
CM_ want to display from uppercased letter in the
CM_ menu bar.
CM_
CM_ Choose a command. Press the letter key that matches the uppercased
CM_ letter on the command.
CM_
CM_ Cancel a command. Press Esc.
CM_
CM_ Tip: For help choose any item in the menu by placing cursor on
CM_ the item and pressing F1.
CD_Using a Dialog Box
CD_
CD_ rDEBUG displays dialog boxes when you choose commands that have options.
CD_
CD_ Dialog box action Key...
CD_
CD_ Select a text box Press Tab until the cursor is in the text box.
CD_
CD_ Choose an option. Move to an option with the TAB or CTRL+TAB+ keys
CD_ and press ENTER.
CD_
CS_Syntax Conventions
CS_ general syntax:
CS_ KEYWORD <no/no-no <..no/no-no>/<KEYWORD /<var<var...>>
CS_ KEYWORD Items in capital letters are rDEBUG keywords
CS_ (commands, or prefix-commands or subcommands.
CS_ Keywords are a required part of the statement
CS_ syntax, unless they are enclosed in brackets.
CS_ Note, abbreviations of at least two characters
CS_ may be used for any keyword
CS_ no refers to program line number
CS_ no-no refers to a range of numbers such as 3-9):
CS_ var for variables to be checked for changes;
CK_Shortcut Keys Summary
CK_
CK_ Selecting Deleting
CK_ Blocks (opposite corners) CTRL+B Cut current line CTRL+D
CK_ Lines CTRL+L Cut to end of line CTRL+END
CK_ Inserting Delete character DEL
CK_ Switch to insert/overstrike Ins Copying
CK_ Add blank Line after CTRL-A After current line CTRL+C
CK_ After current line CTRL+C Debugging
CK_ View output screen F4
CK_ Finding Continue debugging F5
CK_ Repeat find F3 Execute to cursor F7
CK_ Toggle breakpoint F9
CK_ Getting Help Single step F8
CK_ On rDEBUG Help F1 Procedure step F10
CK_ On keywords or topics F1 Window/data F2
CK_
CE_Editing Keys
CE_
CE_ Cursor-Movement Keys
CE_
CE_ Character left Left Arrow
CE_ Character right Right Arrow
CE_ Line up Up Arrow
CE_ Line down Down Arrow
CE_ Commandline Home
CE_ End of current line END
CE_ Beginning of current line END
CE_ Beginning of next line/end data entry Enter
CE_ Move to next window F6
CE_ Add line CTRL-A or CTRL-INS
CE_ Scroll right/left F12
CE_ Block operations
CE_ Copy block (block persists) CTRL+K
CE_ Delete block CTRL+G
CE_ Fill block CTRL+F
CE_ Lowercase block SHFT+F6
CE_ Mark box CTRL+B
CE_ Move block CTRL+M
CE_ Overlaybox CTRL+O
CE_ Reset block CTRL+U
CE_ Shift left 1 block SHFT+F7
CE_ Shift right 1 block SHFT+F8
CE_ Uppercase block SHFT+F5
CE_ Other keys
CE_ Backspace BKSP
CE_ Bottom CTRL+PGDN
CE_ Insert/Overstrike INS
CE_ Join lines CTRL+J
CE_ Last page PGUP
CE_ Next page PGDN
CE_ Recover last line CTRL+R
CE_ Retrieve last command CTRL+CURU
CE_ Retrieve next command CTRL+CURD
CE_ Split lines CTRL+S
CE_ Top CTRL+PGUP
CE_
CV_View and Search Keys
CV_
CV_ Switch between the output screen and the d-file window F4
CV_
CV_ Make the next window the active window F6
CV_
CV_ Zoom/Unzoom current window ALT+V, Z
CV_
CV_ Repeat find for same text F3
CV*_Search for text
CV*_Search for and replace text
CV_
CV_
CH_Help Keys
CH_
CH_ View Help for the item where the cursor is located F1
CH_
CH_ Exit Help Esc
CH_
CH_ View Using Help ALT+H, U
CH_
CH_ Display the Help menu ALT+H
CH_
CH_ Move cursor to next Help topic Tab
CH_ Move cursor to previous Help topic SHFT+Tab
CH_ Move cursor to next topic with starting character character
CH_
CH*_View the next topic in the Help file CTRL+F1
CH*_View the previous topic in the Help file SHFT+CTRL+F1
CH_
CH_
ARD_Run and Debug Keys
ARD_
ARD_ Abort rDEBUG CTRL+F12 Start SHFT+F5
ARD_ Add Watch SHFT+F3 Step program F8
ARD_ Clear menu/entry ESC Step procedure F10
ARD_ Go/continue F5 Toggle breakpoint F9
ARD_ Run to cursor F7
ARD_
CR_rDEBUG Command Line
CR_ These options can be typed on the OS/2 or KEDIT commandline following
CR_ the rDEBUG command:
CR_
CR_ rDEBUG cmd/macro_name <source program_parameters>
CR_
CR_ cmd/macro_name filename only of program to be debuggedp
CR_
CR_ source program_parmeters parameters if any
CR_REXX Commands.
CR_ These commands can be typed on the rDEBUG commandline:
CX_ ADDRESS EXIT NOP PUSH
CX_ ARG IF NUMERIC QUEUE
CX_ CALL INTERPRET OPTIONS RETURN
CX_ DO ITERATE PARSE SAY
CX_ DROP LEAVE PULL SIGNAL
C*_rDEBUG Environment Limits
C*_
C*_ This section lists the limits for the following items in the rDEBUG
C*_ environment:
C*_
C*_ Name, String, and Number Limits
C*_ Array Limits
C*_ Procedure and File Limits
C*_
C*_ See Also Beyond rDEBUG
C*_
ACB_Beyond rDEBUG
ACB_
ACB_ rDEBUG is an easy-to-use environment for debugging REXX programs.
ACB_ The following table lists some solutions if you need to go beyond rDEBUG.
ACB_
ACB_ If you need You can
ACB_
ACB_ Fast program execution Use a REXX compiler (such as Quercus's /*D*/
ACB_ Personal REXX) to translate your /*D*/
ACB_ REXX code into p-code. REXX /O file /*D*/
ACB_ /*D*/
ACB_ To build programs that Use a rDEBUG development environment that /*D*/
ACB_ require over K of memory supports creating large programs. /*D*/
ACB_ /*D*/
ACB_ If you want to learn more about programming with REXX
ACB_ consult the following books or other books for information:
ACB_
ACB_ ■ "Procedures Language 2/ REXX User's Guide" by IBM (1991).
ACB_ ■ "Procedures Language 2/ REXX Reference" by IBM (1991).
ACB_ ■ "Personal REXX User's Guide version 3.0" by Quercus Systems (1991).
ACB_ ■ "The REXX Language, A Practical Approach to Programming"
ACB_ by M.F. Cowlishaw (1985).
ACB_
CG_rDEBUG Error Codes
CG_
CG_ Code Message (rDEBUG)
CG_
CG_ 001 You didn't specify an existing program. Choose OPEN.
CG_ 003 Make changes & enter 'FILE' or 'QQ' to continue
CG_ 004 Invalid item in profile:...
CG_ 005 Invalid entry in profile:...
CG_ 007 Missing quotes, comments at points: .1 to .x
CG_ 008 PROCEDURE found in source
remove clause or place procedure in an external file
CG_ 009 File missing:...
CG_ 016 If you wish To rerun last session, modify & select RERUN.
CG_ 017 Make any change(s) you wish To your PROFILE.
Press F2 to remove menu and enter any data, then F2 to see menu
CG_ 020 Breakpoint on count...
CG_ 030 Change in:...
CG_ 041 Error in rDEBUG Nucleus, enter SAVE, rDEBUG may abort
CG_ 042 Error in rDEBUG Nucleus, will abort
CG_ 043 Error in rDEBUG, try another request
CG_ 044 Error in rDEBUG or your program, try again
CG_ 045 Error in your program, please correct. Resumes at...
CG_ 102 Unsupported key:...
CG_ 104 Invalid key:...
CG_ 110 Breakpoint:...
CG_ 111 Invalid selection:...
CG_ 112 Welcome...
CG_ 115 This command is only effective in:...
CG_ 190 To continue, Please FILE or QUIT all...
CG_ 220 Exiting rDEBUG
CG_ 222 ABORT cancelled
CG_ 305 Not > 0 and < size of program...
CG_ 310 To label doesn't exist:...
CG_ 311 Not possible to 'SIGNAL' out of a restricted DO/SELECT
CG_ Suggest you adjust looping control variable.
CG_ 320 Use , RESTART or SAVE to exit. You may not
CG_ 330 To load another session please use EXIT or RESTART
CG_ 333 Invalid characters:...
CG_ 334 Operand too short:...
CG_ 335 WATCH set for:...
CG_ 337
CG_ 338 Invalid syntax for conditional
CG_ 340 Must be numeric and positive:...
CG_ 345 Switch
CG_ 350 Switch
CG_ 360 May be set '1' (ON) or '0' (OFF), setting of
CG_ 364 WATCH is:...
CG_ 411 Breakpoints are:...
CG_ 520 Line(s) not valid:...
CG_ 610 Not available
CG_ 710 Cursor not on a word
CG_ 711 Cursor not in file area.
CG_ 750 Event trap in external module.
CG_ 800 Your program terminated, you may continue at line 1
CG_ 80E Error in system call:...
CG_ 80F Failure in system call:...
CG_ 80H Program interrupted by user
CG_ 80R Device not ready
CG_ 80S REXX syntax error
CG_ 80V Novalue found:...
CG_ 840 Error message and contents of line:...
CG_ 842 Call stack:...
CG_ 851 Will attempt to continue at line:...
CG_ 852 Trap in restricted DO/SELECT range- Enter GO to set ERROR off & RESTART program
CG_ 860 File has been changed, enter 'Y' to UNLOAD.
CG_ 920 Missing or unmatched end
CG_ 982 SAVE was successful on:...
CG_ 980 Has file been changed?, enter 'Y' to SAVE.
CG_ 998 Unsupported when FULLSW=0!
CG_ 999 Not available yet! Register to get FULL version
CG_
CG_ Code Message (REXX)
CG_
CG_ 6 Unmatched "/*" or quote - run tools match (rmatch)
CG_ 10 Unexpected or unmatched END - run tools indent (rpp)
CG_ 14 Incomplete DO/SELECT/IF - run tools indent (rpp)
CG_
CG_ Code Message (KEDIT)
CG_ 21 Invalid command:... label -
CG_ 36 Unmatched "(" in expression - run tools match (rmatch)
CG_ 106 Unbalanced parentheses - run tools match (rmatch)
CG_ 108 Unexpected THEN or ELSE - run tools indent (rpp)
CG_ 109 Unmatched "/*" or quote - run tools match (rmatch)
CG_
CU_Using Help
CU_ Help window, press Esc.
CU_
CU_ In the Help window, you can display information on:...
CU_
CU_ ■ Help topics (identified by highlighted arrowheads )
CU_
CU_ ■ rDEBUG, REXX or KEDIT keywords
CU_
CU_ To move the cursor to a Help topic, press Tab or the first letter of the
CU_ topic. To display the topic or keyword information, place the cursor
CU_ anywhere on the topic or keyword and press F1.
CU_
AVD_Version Differences
AVD_
AVD_ Version 1.0 is VM/CMS (requires further testing)
AVD_ WAIT Command
AVD_ Version 2.0 is OS/2
AVD_ Incorporates several external macros into d-file
AVD_ new dialog boxes
AVD_ Version 3.0 is DOS (not available yet)
AVD_ dual monitors
AVD_
CU_Using Help
CU_ Help window, press Esc.
CU_
CU_ In the Help window, you can display information on:
CU_
CU_ ■ Help topics (identified by highlighted arrowheads )
CU_
CU_ ■ rDEBUG, REXX or KEDIT keywords
CU_
CU_ To move the cursor to a Help topic, press Tab or the first letter of the
BRG_GO Command
BRG_ <no>
BRG_
BRG_ use to continue processing of source program or, if line
BRG_ number is present, to generate a branch to that line
BRG_ number. Hitting ENTER is equivalent to GO. Note,
BRG_ branching is not allowed within DO or SELECT to END ranges
BRG_ because a signal command terminates such constructs. Such
BRG_ ranges are indicated by a level number (digit to the left
BRG_ of ';' in the prefix side of the screen) greater than zero.
BRG_
BRN_NEXT Command
BRN_
BRN_ use to position the editor to the line where processing is
BRN_ to resume.
BRN_
BRS_SHOW Command
BRS_
BRS_ use with F1 key to display value for a variable at the cursor.
BTP_PROFILER Command
BTP_ use to display the execution counts for most lines in the
BTP_ source program (this feature may be used to check if all
BTP_ code has been exercised).
BTF_FILES Command
BTF_ use to show the status information on all files in the
BTF_ current editting session.
BTI_INDENTATION Command
BTI_ use to indent the REXX code of the source program on disk
BTI_ in a structured fashion.
BTS_STRUCTURE Command
BTS_ use to show only the REXX lines in the source program that
BTS_ contain REXX control key words like IF and SELECT.
BTW_SWITCHES Command
BTW_ use to display the values of all switches and all
BTW_ prefix control variables.
BTY_SYNTAX Command
BTY_ use to check the source program on disk for proper syntax of
BTY_ all REXX commands, keywords and function calls.
BTW_WATCH Command
BTW_ use to display all WATCH variables and their current values.
BTX_XREF Command
BTX_ use to generate a cross reference map of all variables and
BTX_ labels in the source program on the disk.
HWS_Show Watch Command
HWS_ Use to display the current value of a variable.
CCA_ASCII Character Codes
CCA_
CCA_ Regular ASCII Chart (character codes 0 - 127)
CCA_ 000 (nul) 016 (dle) 032 sp 048 0 064 @ 080 P 096 ` 112 p
CCA_ 001 (soh) 017 (dc1) 033 ! 049 1 065 A 081 Q 097 a 113 q
CCA_ 002 (stx) 018 (dc2) 034 " 050 2 066 B 082 R 098 b 114 r
CCA_ 003 (etx) 019 (dc3) 035 # 051 3 067 C 083 S 099 c 115 s
CCA_ 004 (eot) 020 (dc4) 036 $ 052 4 068 D 084 T 100 d 116 t
CCA_ 005 (enq) 021 (nak) 037 % 053 5 069 E 085 U 101 e 117 u
CCA_ 006 (ack) 022 (syn) 038 & 054 6 070 F 086 V 102 f 118 v
CCA_ 007 (bel) 023 (etb) 039 ' 055 7 071 G 087 W 103 g 119 w
CCA_ 008 (bs) 024 (can) 040 ( 056 8 072 H 088 X 104 h 120 x
CCA_ 009 (tab) 025 (em) 041 ) 057 9 073 I 089 Y 105 i 121 y
CCA_ 010 (lf) 026 (eof) 042 * 058 : 074 J 090 Z 106 j 122 z
CCA_ 011 (vt) 027 (esc) 043 + 059 ; 075 K 091 [ 107 k 123 {
CCA_ 012 (np) 028 (fs) 044 , 060 < 076 L 092 \ 108 l 124 |
CCA_ 013 (cr) 029 (gs) 045 - 061 = 077 M 093 ] 109 m 125 }
CCA_ 014 (so) 030 (rs) 046 . 062 > 078 N 094 ^ 110 n 126
CCA_ 015 (si) 031 (us) 047 / 063 ? 079 O 095 _ 111 o 127
CCA_
CCA_ASCII Character Codes
CCA_ Contents Intended ASCII Chart (character codes 128 - 255)
CCA_ 158 ₧ 172 ¼ 186 ║ 200 ╚ 214 ╓ 228 Σ 242 ≥
CCA_ 129 ü 144 É 159 ƒ 173 ¡ 187 ╗ 201 ╔ 215 ╫ 229 σ 243 ≤
CCA_ 130 é 145 æ 160 á 174 « 188 ╝ 202 ╩ 216 ╪ 230 µ 244 ⌠
CCA_ 131 â 146 Æ 161 í 175 » 189 ╜ 203 ╦ 217 231 τ 245 ⌡
CCA_ 132 ä 147 ô 162 ó 176 190 ╛ 204 ╠ 218 232 Φ 246 ÷
CCA_ 133 à 148 ö 163 ú 177 ▒ 191 205 219 █ 233 Θ 247 ≈
CCA_ 134 å 149 ò 164 ñ 178 ▓ 192 206 ╬ 220 ▄ 234 Ω 248 °
CCA_ 135 ç 150 û 165 Ñ 179 193 ┴ 207 ╧ 221 ▌ 235 δ 249 ∙
CCA_ 136 ê 151 ù 166 ª 180 194 ┬ 208 ╨ 222 ▐ 236 ∞ 250 ·
CCA_ 137 ë 152 ÿ 167 º 181 ╡ 195 209 ╤ 223 ▀ 237 φ 251 √
CCA_ 138 è 153 Ö 168 ¿ 182 ╢ 196 210 ╥ 224 α 238 ε 252 ⁿ
CCA_ 139 ï 154 Ü 169 ⌐ 183 ╖ 197 ┼ 211 ╙ 225 ß 239 ∩ 253 ²
CCA_ 140 î 155 ¢ 170 ¬ 184 ╕ 198 ╞ 212 ╘ 226 Γ 240 ≡ 254 ■
CCA_ 141 ì 156 £ 171 ½ 185 ╣ 199 ╟ 213 ╒ 227 π 241 ± 255
CCA_ 142 Ä 157 ¥
CCA_
CCG_Keyboard Scan Codes
CCG_
CCG_ Key Code ║ Key Code ║ Key Code
CCG_ ║ ║
CCG_ Esc 1 ║ A 30 ║ Caps Lock 58
CCG_ ! or 1 2 ║ S 31 ║ F1 59
CCG_ @ or 2 3 ║ D 32 ║ F2 60
CCG_ # or 3 4 ║ F 33 ║ F3 61
CCG_ $ or 4 5 ║ G 34 ║ F4 62
CCG_ % or 5 6 ║ H 35 ║ F5 63
CCG_ ^ or 6 7 ║ J 36 ║ F6 64
CCG_ & or 7 8 ║ K 37 ║ F7 65
CCG_ * or 8 9 ║ L 38 ║ F8 66
CCG_ ( or 9 10 ║ : or ; 39 ║ F9 67
CCG_ ) or 0 11 ║ " or ' 40 ║ F10 68
CCG_ _ or - 12 ║ or ` 41 ║ F11 133
CCG_ + or = 13 ║ Left Shift 42 ║ F12 134
CCG_ Bksp 14 ║ | or \ 43 ║ NumLock 69
CCG_ Tab 15 ║ Z 44 ║ Scroll Lock 70
CCG_ Q 16 ║ X 45 ║ Home or 7 71
CCG_Keyboard Scan Codes
CCG_ ║ C 46 ║ Up or 8 72
CCG_ ║ V 47 ║ PgUp or 9 73
CCG_ R 19 ║ B 48 ║ Gray - 74
CCG_ T 20 ║ N 49 ║ Left or 4 75
CCG_ Y 21 ║ M 50 ║ Center or 5 76
CCG_ U 22 ║ < or , 51 ║ Right or 6 77
CCG_ I 23 ║ > or . 52 ║ Gray + 78
CCG_ O 24 ║ ? or / 53 ║ End or 1 79
CCG_ P 25 ║ Right Shift 54 ║ Down or 2 80
CCG_ { or [ 26 ║ Prt Sc or * 55 ║ PgDn or 3 81
CCG_ } or ] 27 ║ ALT 56 ║ Ins or 0 82
CCG_ Enter 28 ║ Spacebar 57 ║ Del or . 83
CCG_ CTRL 29 ║
CCG_