OS/2 Professional

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 | 49.8 KB | 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_