home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / RXD.ZIP / rxd.hlp (.txt) < prev    next >
OS/2 Help File  |  1993-01-29  |  15KB  |  502 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Breakpoints ΓòÉΓòÉΓòÉ
  3.  
  4. Breakpoints can be set on lines in the Rexx macro to cause RxD to stop running 
  5. the macro at that line when the Go action is selected.  Lines with breakpoints 
  6. can be displayed in a different color than the other lines displayed in the 
  7. source window. 
  8.  
  9. Note that ANY line may have a breakpoint on it, even if it is not possible for 
  10. rexx to 'run' that line (a line of comments, for instance (see limitations for 
  11. more information).  Lines that do not contain executable code will NOT be 
  12. stopped at (of course). 
  13.  
  14. Note that a breakpoint is hit AFTER the line with the breakpoint has been 
  15. executed.  See limitations for more information. 
  16.  
  17. Breakpoints may be set (or unset) in one of three ways: 
  18.  
  19. o Double clicking mouse button 1 in the left margin of a line. 
  20.  
  21. o Pressing Alt+F9 with the cursor on the line to set the breakpoint. 
  22.  
  23. o Selecting the Set/unset a breakpoint menu item with the cursor on the line to 
  24.   set the breakpoint. 
  25.  
  26. Each action either sets a breakpoint on a line, or if there is already a 
  27. breakpoint on the line, removes the breakpoint. 
  28.  
  29.  
  30. ΓòÉΓòÉΓòÉ 2. Limitations of RXD ΓòÉΓòÉΓòÉ
  31.  
  32. RxD does NOT parse Rexx macros.  It relies on the system trace exit to 
  33. determine what lines are executing.  Because of this, it is not possible for 
  34. RxD to determine what is really on a line.  For instance, it allows any line to 
  35. have a breakpoint set on it, even if it is not an executable line. 
  36.  
  37. Even more disturbing (!) is that RxD always displays things that have already 
  38. happened, not things that WILL happen.  For instance, when single stepping 
  39. through a program, RxD will highlight the line that JUST executed, not the line 
  40. that WILL be executed.  This is the way the Rexx trace exit works.  There's 
  41. nothing I can do about it. 
  42.  
  43. RxD cannot read lines from the console with the linein() function. Since the 
  44. console is normally closed by Presentation Manager when a PM application 
  45. starts, it will appear to the macro that the console is at end of file.  Note 
  46. that 'pull' and 'parse pull' statements are caught by RxD, and will cause a 
  47. line entry dialog to be displayed.  Also note that if standard input is 
  48. redirected to RxD, this input WILL be picked up by the macro with the linein() 
  49. function. 
  50.  
  51. If the REXX macro being debugged calls another REXX macro which executes a 
  52. trace statement, RxD will go haywire.  What happens is that line number 
  53. information is returned from the called macro, and that line number information 
  54. is used to display the original macro.  Execute a GO to return to the original 
  55. macro. 
  56.  
  57. OS/2 commands normally handled by CMD.EXE internally and that also change the 
  58. state of CMD.EXE will not work properly under RxD.  This include the "SET" and 
  59. "CD" commands, as well as specifying a drive letter and colon to change drives. 
  60. There are alternatives to these commands: 
  61.  
  62. o use the directory() function instead of "CHDIR" or "c:" 
  63.  
  64. o use the value() function to set OS/2 environment variables 
  65.  
  66.  
  67. ΓòÉΓòÉΓòÉ 3. Watching variables ΓòÉΓòÉΓòÉ
  68.  
  69. Variables may be watched in the Watch window.  In this window, rexx variable 
  70. names are displayed, and their current values.  The variable and value are 
  71. separated by a tab character (which will cause variables whose names are about 
  72. the same length to have their values lined up). 
  73.  
  74. The hex 00's, carriage returns, line feeds, and tab characters are all 
  75. translated to hex 01 (smiley face) within the value. 
  76.  
  77. Watch variables may be added in one of the following ways.  Note that all of 
  78. these methods do different things depending on whether any text is selected in 
  79. the Source window.  If text is selected, it is assumed to be a variable name, 
  80. and will be added to the Watch window immediately.  If no text is selected, a 
  81. dialog will be displayed to enter the name of the variable to be watched. 
  82. Double clicking mouse button 1 on a variable in the source window will select 
  83. the variable. 
  84.  
  85. o Selecting the Add Watch! menu button 
  86.  
  87. o Pressing Ctrl-a 
  88.  
  89. o Selecting the Add a watch variable menu item 
  90.  
  91.  
  92. ΓòÉΓòÉΓòÉ 4. Source window ΓòÉΓòÉΓòÉ
  93.  
  94. The RxD source window displays the Rexx macro currently running. 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 4.1. Actions ΓòÉΓòÉΓòÉ
  98.  
  99. This menu contains actions that can be performed in this window. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 4.1.1. Set/unset a breakpoint ΓòÉΓòÉΓòÉ
  103.  
  104. This menu item is used to set or unset a breakpoint on the line the cursor is 
  105. on.  Breakpoints may also be set by double clicking mouse button 1 in the left 
  106. margin of the line desired. 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 4.1.2. Add a watch variable ΓòÉΓòÉΓòÉ
  110.  
  111. This menu item adds a variable to the watch window.  If a there is selected 
  112. text in the source window (from either selecting text with the keyboard or 
  113. mouse, or by double clicking mouse button 1 on a variable), the selected text 
  114. will be used as the variable to watch.  If there is no selected text, you will 
  115. be prompted for the variable name in a dialog. 
  116.  
  117.  
  118. ΓòÉΓòÉΓòÉ 4.1.3. Jump to current ΓòÉΓòÉΓòÉ
  119.  
  120. This menu item scrolls the source window to the line just execcuted.  Useful if 
  121. you are browsing through the text in the source window and want to get back to 
  122. the current context. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 4.2. Run ΓòÉΓòÉΓòÉ
  126.  
  127. This menu contains actions pertaining to the execution of the macro. 
  128.  
  129.  
  130. ΓòÉΓòÉΓòÉ 4.2.1. Step ΓòÉΓòÉΓòÉ
  131.  
  132. This menu item causes the next statement to be executed, and the macro to be 
  133. paused until you step or Run 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 4.2.2. Go ΓòÉΓòÉΓòÉ
  137.  
  138. This menu item causes the macro to run until it completes (exits), or a 
  139. breakpoint is hit. 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ 4.2.3. Restart ΓòÉΓòÉΓòÉ
  143.  
  144. This menu item causes the macro to exit, and then restart from the beginning. 
  145.  
  146.  
  147. ΓòÉΓòÉΓòÉ 4.2.4. Reload source ΓòÉΓòÉΓòÉ
  148.  
  149. This menu item causes the macro to exit, then restart from the beginning.  The 
  150. source for the macro will also be reloaded from disk. 
  151.  
  152.  
  153. ΓòÉΓòÉΓòÉ 4.3. Settings ΓòÉΓòÉΓòÉ
  154.  
  155. This menu contains actions pertaining to customizable settings for the window. 
  156.  
  157.  
  158. ΓòÉΓòÉΓòÉ 4.3.1. Color ΓòÉΓòÉΓòÉ
  159.  
  160. This menu item displays a dialog which allows you to select the colors used for 
  161. various items in the window. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 4.3.2. Font ΓòÉΓòÉΓòÉ
  165.  
  166. This menu item displays a dialog which allows you to select the font to be used 
  167. for the text in the window. 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ 4.3.3. Save window size and position ΓòÉΓòÉΓòÉ
  171.  
  172. This menu item causes the current size and position of the window to be saved. 
  173. The next time RxD is run and this window is displayed, it will be placed in the 
  174. same position and have the same size. 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 4.4. Windows ΓòÉΓòÉΓòÉ
  178.  
  179. This menu contains a list of other windows which may be displayed. 
  180.  
  181.  
  182. ΓòÉΓòÉΓòÉ 4.4.1. Watch ΓòÉΓòÉΓòÉ
  183.  
  184. This menu item causes the watch window to be displayed. 
  185.  
  186.  
  187. ΓòÉΓòÉΓòÉ 4.4.2. Console ΓòÉΓòÉΓòÉ
  188.  
  189. This menu item causes the console window to be displayed. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ 4.4.3. Keys help ΓòÉΓòÉΓòÉ
  193.  
  194. The following keys are available in the source window: 
  195.  
  196. F5        See the Go menu item. 
  197.  
  198. F6        See the Jump to current menu item. 
  199.  
  200. F8        See the Step menu item. 
  201.  
  202. F9        See the Set/unset a breakpoint menu item. 
  203.  
  204. ctrl+w    See the Watch menu item. 
  205.  
  206. ctrl+c    See the Console menu item. 
  207.  
  208. ctrl+a    See the Add a watch variable menu item. 
  209.  
  210. Other keys respond the same as keys in multi-line edit windows. 
  211.  
  212.  
  213. ΓòÉΓòÉΓòÉ 4.4.4. Product information ΓòÉΓòÉΓòÉ
  214.  
  215. This menu item shows product information. 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 5. Watch window ΓòÉΓòÉΓòÉ
  219.  
  220. The watch window displays variables being watched by RxD. Variables and their 
  221. values are listed in this window.  They are on the same line and separated by a 
  222. tab. 
  223.  
  224. After a step operation, or when a breakpoint is reached, the values of the 
  225. variables in the watch window are updated. 
  226.  
  227. Variables may be deleted from the watch window with the Delete variable menu 
  228. item.  Variables may be added to the watch window with the Add variable menu 
  229. item. 
  230.  
  231. RxD translates some characters in values to hex '01' to prevent problems with 
  232. the display.  The characters translated are hex '00', carriage return (hex 
  233. '0D'), line feed (hex '0A') and tab (hex '09'). 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 5.1. Actions ΓòÉΓòÉΓòÉ
  237.  
  238. The Actions menu list various actions that can be performed in this window. 
  239.  
  240.  
  241. ΓòÉΓòÉΓòÉ 5.1.1. Add a variable to the watch window ΓòÉΓòÉΓòÉ
  242.  
  243. This menu item displays a dialog to allow a variable to be added to the watch 
  244. window. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 5.1.2. Delete a variable from the watch window ΓòÉΓòÉΓòÉ
  248.  
  249. This menu item deletes the variable pointed to by the cursor from the watch 
  250. window. 
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 5.1.3. Delete all variables from the watch window ΓòÉΓòÉΓòÉ
  254.  
  255. This menu item deletes all the variables from the watch window. 
  256.  
  257.  
  258. ΓòÉΓòÉΓòÉ 5.2. Settings ΓòÉΓòÉΓòÉ
  259.  
  260. This menu contains actions pertaining to customizable settings for the window. 
  261.  
  262.  
  263. ΓòÉΓòÉΓòÉ 5.2.1. Color ΓòÉΓòÉΓòÉ
  264.  
  265. This menu item displays a dialog which allows you to select the colors used for 
  266. various items in the window. 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 5.2.2. Font ΓòÉΓòÉΓòÉ
  270.  
  271. This menu item displays a dialog which allows you to select the font to be used 
  272. for the text in the window. 
  273.  
  274.  
  275. ΓòÉΓòÉΓòÉ 5.2.3. Save window size and position ΓòÉΓòÉΓòÉ
  276.  
  277. This menu item causes the current size and position of the window to be saved. 
  278. The next time RxD is run and this window is displayed, it will be placed in the 
  279. same position and have the same size. 
  280.  
  281.  
  282. ΓòÉΓòÉΓòÉ 5.3. Windows ΓòÉΓòÉΓòÉ
  283.  
  284. This menu contains a list of other windows which may be displayed. 
  285.  
  286.  
  287. ΓòÉΓòÉΓòÉ 5.3.1. Source ΓòÉΓòÉΓòÉ
  288.  
  289. This menu item causes the source window to be displayed. 
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 5.3.2. Console ΓòÉΓòÉΓòÉ
  293.  
  294. This menu item causes the console window to be displayed. 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 5.3.3. Keys help ΓòÉΓòÉΓòÉ
  298.  
  299. The following keys are available in the source window: 
  300.  
  301. ctrl+a    See the Add a Watch Variable menu item. 
  302.  
  303. ctrl+d    See the Delete a Watch Variable menu item. 
  304.  
  305. ctrl+s    See the Source menu item. 
  306.  
  307. ctrl+c    See the Console menu item. 
  308.  
  309. Other keys respond the same as keys in multi-line edit windows. 
  310.  
  311.  
  312. ΓòÉΓòÉΓòÉ 5.3.4. Product information ΓòÉΓòÉΓòÉ
  313.  
  314. This menu item shows product information. 
  315.  
  316.  
  317. ΓòÉΓòÉΓòÉ 6. Console window ΓòÉΓòÉΓòÉ
  318.  
  319. The console window contains input and output from the Rexx macro.  Each type of 
  320. input and output can be captured or not, and hidden or not. 
  321.  
  322. When capture is on for a type input or output, that data is added to the 
  323. console window.  When capture is off, that data is NOT added to the console 
  324. window.  Capture is on by default for all types of input and output, except 
  325. trace output.  Capture trace output can significantly degrade the performance 
  326. of RxD. 
  327.  
  328. When a type of input or output is hidden, it is temporarily hidden from view. 
  329. When un-hidden (by toggling the menu item so it is no longer checked), the data 
  330. is displayed again. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 6.1. Actions ΓòÉΓòÉΓòÉ
  334.  
  335. The Actions menu list various actions that can be performed in this window. 
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 6.1.1. Clear ΓòÉΓòÉΓòÉ
  339.  
  340. This menu item clears the contents of the console window 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 6.2. Capture ΓòÉΓòÉΓòÉ
  344.  
  345. This menu lists the input and output types that may be captured. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 6.2.1. Capture say output ΓòÉΓòÉΓòÉ
  349.  
  350. Captures (or not) output from the say statement. 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 6.2.2. Capture standard output ΓòÉΓòÉΓòÉ
  354.  
  355. Captures (or not) standard output. 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ 6.2.3. Capture standard error ΓòÉΓòÉΓòÉ
  359.  
  360. Captures (or not) standard error. 
  361.  
  362.  
  363. ΓòÉΓòÉΓòÉ 6.2.4. Capture trace output ΓòÉΓòÉΓòÉ
  364.  
  365. Captures (or not) diagnostic trace output.  Off by default since it will 
  366. degrade RxD performance if left on. 
  367.  
  368.  
  369. ΓòÉΓòÉΓòÉ 6.2.5. Capture pull input ΓòÉΓòÉΓòÉ
  370.  
  371. Captures (or not) data retrieved from the pull or parse pull statement. 
  372.  
  373.  
  374. ΓòÉΓòÉΓòÉ 6.3. Hide ΓòÉΓòÉΓòÉ
  375.  
  376. This menu lists the input and output types that may be hidden. 
  377.  
  378.  
  379. ΓòÉΓòÉΓòÉ 6.3.1. Hide say output ΓòÉΓòÉΓòÉ
  380.  
  381. Hides (or shows) output from the say statement. 
  382.  
  383.  
  384. ΓòÉΓòÉΓòÉ 6.3.2. Hide standard output ΓòÉΓòÉΓòÉ
  385.  
  386. Hides (or shows) standard output. 
  387.  
  388.  
  389. ΓòÉΓòÉΓòÉ 6.3.3. Hide standard error ΓòÉΓòÉΓòÉ
  390.  
  391. Hides (or shows) standard error. 
  392.  
  393.  
  394. ΓòÉΓòÉΓòÉ 6.3.4. Hide trace output ΓòÉΓòÉΓòÉ
  395.  
  396. Hides (or shows) diagnostic trace output. 
  397.  
  398.  
  399. ΓòÉΓòÉΓòÉ 6.3.5. Hide pull input ΓòÉΓòÉΓòÉ
  400.  
  401. Hides (or shows) lines retrieved from the pull or parse pull statement. 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ 6.4. Settings ΓòÉΓòÉΓòÉ
  405.  
  406. This menu contains actions pertaining to customizable settings for the window. 
  407.  
  408.  
  409. ΓòÉΓòÉΓòÉ 6.4.1. Color ΓòÉΓòÉΓòÉ
  410.  
  411. This menu item displays a dialog which allows you to select the colors used for 
  412. various items in the window. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 6.4.2. Font ΓòÉΓòÉΓòÉ
  416.  
  417. This menu item displays a dialog which allows you to select the font to be used 
  418. for the text in the window. 
  419.  
  420.  
  421. ΓòÉΓòÉΓòÉ 6.4.3. Save window size and position ΓòÉΓòÉΓòÉ
  422.  
  423. This menu item causes the current size and position of the window to be saved. 
  424. The next time RxD is run and this window is displayed, it will be placed in the 
  425. same position and have the same size. 
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ 6.5. Windows ΓòÉΓòÉΓòÉ
  429.  
  430. This menu contains a list of other windows which may be displayed. 
  431.  
  432.  
  433. ΓòÉΓòÉΓòÉ 6.5.1. Source ΓòÉΓòÉΓòÉ
  434.  
  435. This menu item causes the source window to be displayed. 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 6.5.2. Watch ΓòÉΓòÉΓòÉ
  439.  
  440. This menu item causes the watch window to be displayed. 
  441.  
  442.  
  443. ΓòÉΓòÉΓòÉ 6.5.3. Keys help ΓòÉΓòÉΓòÉ
  444.  
  445. The following keys are available in the source window: 
  446.  
  447. ctrl+s    See the Source menu item. 
  448.  
  449. ctrl+w    See the Watch menu item. 
  450.  
  451. Other keys respond the same as keys in multi-line edit windows. 
  452.  
  453.  
  454. ΓòÉΓòÉΓòÉ 6.5.4. Product information ΓòÉΓòÉΓòÉ
  455.  
  456. This menu item shows product information. 
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ 7. Console input dialog ΓòÉΓòÉΓòÉ
  460.  
  461. This dialog is prompting you for a line of input.  Enter the line and press 
  462. Enter to continue. Press Esc or Enter with an empty line to Cancel. 
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ 7.1. Console input entry field ΓòÉΓòÉΓòÉ
  466.  
  467. This dialog is prompting you for a line of input.  Enter the line and press 
  468. Enter to continue. Press Esc or Enter with an empty line to Cancel. 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 8. Add variable dialog ΓòÉΓòÉΓòÉ
  472.  
  473. This dialog is prompting you for a variable name to be watched.  Enter the 
  474. variable name and press Enter to continue. Press Esc or Enter with an empty 
  475. line to Cancel. 
  476.  
  477.  
  478. ΓòÉΓòÉΓòÉ 8.1. Add variable entry field ΓòÉΓòÉΓòÉ
  479.  
  480. This dialog is prompting you for a variable name to be watched.  Enter the 
  481. variable name and press Enter to continue. Press Esc or Enter with an empty 
  482. line to Cancel. 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 9. Color dialog ΓòÉΓòÉΓòÉ
  486.  
  487. This dialog allows you to choose a color to be associated with some text 
  488. displayed by RxD.  Selecting a text type will display the current color for 
  489. that text.  Changing the color by selecting with cursor or mouse will change it 
  490. in the application.  Selecting Cancel will restore the previous color choice. 
  491. Selecting Ok will save the current color for the next invocation of RxD. 
  492.  
  493.  
  494. ΓòÉΓòÉΓòÉ 9.1. Output type  list ΓòÉΓòÉΓòÉ
  495.  
  496. This list displays the types of text that may be colored in this window. 
  497.  
  498.  
  499. ΓòÉΓòÉΓòÉ 9.2. Color values ΓòÉΓòÉΓòÉ
  500.  
  501. This value set displays the possible colors that can be associated with a type 
  502. of text.