home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv4.zip / VACPP / IBMCPP / HELP / DDE4HELP.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-05-24  |  212KB  |  8,195 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Notices ΓòÉΓòÉΓòÉ
  3.  
  4. References in this online information to IBM products, programs, or services do 
  5. not imply that IBM intends to make these available in all countries in which 
  6. IBM operates. Any reference to an IBM licensed program in this publication is 
  7. not intended to state or imply that only IBM's licensed program may be used. 
  8. Any functionally equivalent product, program or service that does not infringe 
  9. any of IBM's intellectual property rights may be used instead of the IBM 
  10. product, program, or service. Evaluation and verification of operation in 
  11. conjunction with other products, except those expressly designated by IBM, is 
  12. the user's responsibility. 
  13.  
  14. IBM may have patents or pending patent applications covering subject matter in 
  15. this document. The furnishing of this document does not give you any license to 
  16. these patents.  You can send license inquiries, in writing, to the IBM Director 
  17. of Commercial Relations, IBM Corporation, Purchase, NY 10577. 
  18.  
  19. This publication could contain technical inaccuracies or typographical errors. 
  20.  
  21.  
  22. ΓòÉΓòÉΓòÉ 1.1. Trademarks and Service Marks ΓòÉΓòÉΓòÉ
  23.  
  24. The following terms, denoted by an asterisk (*) in this online documentation, 
  25. are trademarks of the IBM Corporation in the United States and/or other 
  26. countries: 
  27.  
  28. o IBM 
  29. o Presentation Manager 
  30. o Operating System/2 
  31. o OS/2 
  32. o WorkFrame/2 
  33.  
  34.  
  35. ΓòÉΓòÉΓòÉ 2. New and Enhanced Features ΓòÉΓòÉΓòÉ
  36.  
  37. The following describes the new and enhanced features that have been added to 
  38. the debugger since the previous release: 
  39.  
  40. New Features 
  41.  
  42. Deferred breakpoints 
  43.           Allows you to set a breakpoint in a DLL that is not currently loaded. 
  44.           If your application consists of DLLs that are dynamically loaded, use 
  45.           this feature to set breakpoints in DLLs which have not been loaded 
  46.           yet. These deferred breakpoints become active once the DLL is loaded. 
  47.  
  48.           See the Set Line Window or the Set Function Window for more details. 
  49.  
  50. Child process debugging 
  51.           Supports debugging of processes started by a parent program. 
  52.  
  53.           See Program Startup Window for more details. 
  54.  
  55. Exception filtering 
  56.           Allows you to select the exceptions that you want the debugger to 
  57.           recognize.  An exception occurs when your application is unable to 
  58.           interpret specific requests. 
  59.  
  60.           See Exception Filtering Window for more details. 
  61.  
  62. Check heap when stopping 
  63.           Helps to isolate memory management problems by checking for memory 
  64.           overwriting each time your program stops executing. 
  65.  
  66.           See Check Heap When Stopping Choice for more details. 
  67.  
  68. Hide debugger on Run 
  69.           Hides the debugger windows while your application is running. 
  70.  
  71.           See Hide Debugger on Run Choice for more details. 
  72.  
  73. Color support 
  74.           Allows you to change the color of the various window elements such as 
  75.           executable lines, non-executable lines, and the breakpoint prefix 
  76.           area. 
  77.  
  78.           See Colors Window for more details. 
  79.  
  80. SOM support 
  81.           Allows you to debug SOM objects created with the compiler using 
  82.           Direct-to-SOM support or created with the SOM compiler.  Support 
  83.           includes monitoring SOM classes in the monitor windows. 
  84.  
  85. Scroll to line number 
  86.           Allows you to scroll to a particular line number in the source code. 
  87.           This feature also provides the ability to set breakpoints. 
  88.  
  89.           See Scroll to Line Number Window for more details. 
  90.  
  91. Autosave window positions and sizes 
  92.           Saves the window positions and sizes when the windows are moved or 
  93.           re-sized.  Alternatively, you may save the window positions and sizes 
  94.           by positioning the debugger windows on the desktop and selecting the 
  95.           Save window positions and sizes choice. 
  96.  
  97.           See Autosave  Window Positions and Sizes Choice for more details. 
  98.  
  99. Integration 
  100.           Provides quick and easy access to other tools such as an editor or 
  101.           the browser.  This feature is available when the debugger is started 
  102.           from within the WorkFrame environment. 
  103.  
  104. Select include files 
  105.           Allows you to select the include files you want to view. Include 
  106.           files are files that are included in your source file by a compiler 
  107.           directive and are considered program source files. 
  108.  
  109.           See Select Include File Window for more details. 
  110.  
  111. Windows menu 
  112.           Displays a list of all the active debugger windows. 
  113.  
  114. Hover help for title bar buttons 
  115.           Displays the name of the title bar button when you place the mouse 
  116.           pointer on a button. If you drag the mouse pointer across the 
  117.           buttons, the name in the title bar area changes to reflect the button 
  118.           you are on. 
  119.  
  120. Enhanced Features 
  121.  
  122. The following describes the enhanced features that have been added to the 
  123. debugger since the previous release. 
  124.  
  125. Call stack window 
  126.           Provides the option of displaying the remaining stack size, the stack 
  127.           frame size, the return address, the ESP value and the EBP value. 
  128.  
  129.           See Call Stack Window for more details. 
  130.  
  131. Breakpoint list window 
  132.           Displays as a window allowing you to continuously monitor the 
  133.           breakpoint list. You can also display the source code where the 
  134.           breakpoint is set. 
  135.  
  136.           See Breakpoint List Window for more details. 
  137.  
  138. Storage window 
  139.           Allows you to monitor expressions in a storage window.  For example, 
  140.           if you are monitoring a pointer, as the pointer changes, the storage 
  141.           window changes to show the new location referenced by the pointer. 
  142.  
  143.           See Storage Window for more details. 
  144.  
  145. Change address breakpoint 
  146.           Allows you to set a change address breakpoint by typing in an 
  147.           expression. 
  148.  
  149.           See Set Change Address Window for more details. 
  150.  
  151. Enable program profiling 
  152.           Allows you to enable or disable the use of program profiles which 
  153.           restores a program's breakpoints, source windows and monitors to the 
  154.           same state as when last debugged. 
  155.  
  156.           See Program Profiles Choice for more details. 
  157.  
  158.  
  159. ΓòÉΓòÉΓòÉ 3. Compiling and Linking Your Program ΓòÉΓòÉΓòÉ
  160.  
  161. To use the debugger, compile and link your program with the following options: 
  162.  
  163. Compiler Options 
  164.  
  165. /Ti+ 
  166.           Compiles your program to produce an object file that includes line 
  167.           number information and a symbol table, in addition to the source 
  168.           code. 
  169.  
  170. /Oi- 
  171.           Compiles your program with inlining off.  This is the default. 
  172.  
  173. /Tm+ 
  174.           This option is required if you want to use the debugger heap check 
  175.           feature. 
  176.  
  177. Linker Options 
  178.  
  179. /DEbug 
  180.           Links your program to produce an executable file that includes line 
  181.           number information and a symbol table, in addition to the executable 
  182.           code. 
  183.  
  184. For more information about compiling and linking your program, refer to the IBM 
  185. VisualAge C++ Tools Programming Guide. 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 4. Program Startup Window ΓòÉΓòÉΓòÉ
  189.  
  190. Use the Program Startup window to specify the program you want to start for 
  191. this debugging session. 
  192.  
  193.  1. Select a program for debugging using one of the following methods: 
  194.  
  195.    o Type the name of the program you want to start in the Program entry field. 
  196.    o Open the Program list by selecting the list button  then selecting a 
  197.      program name. 
  198.    o Select the File list push button and select a program from the Select 
  199.      Program window. 
  200.  
  201.  2. Type any parameters you want to pass to your program in the Parameters 
  202.     entry field. Separate multiple parameters with a space. 
  203.  
  204.  3. Select one of the push buttons to continue. 
  205.  
  206. Program Entry Field 
  207.  
  208. Type the name of the program you want to start for your debugging session. You 
  209. do not need to include the file name extension when you type the program name. 
  210. However, the extension does default to exe. 
  211.  
  212. You can also select the list button to display a drop-down combination box. 
  213. The drop-down combination box contains a list of up to five previously debugged 
  214. programs. 
  215.  
  216. File List Push Button 
  217.  
  218. If you select the File list push button, the Select Program window displays. 
  219. From this window, select the program you want to debug. The Program Startup 
  220. window displays again with the program name displayed in the Program entry 
  221. field. 
  222.  
  223. Parameters Entry Field 
  224.  
  225. If the program accepts parameters, type the parameters that you want to pass to 
  226. the program you are starting. 
  227.  
  228. Debug child process(es) Check Box 
  229.  
  230. Enable the Debug child process(es) check box to debug processes that are 
  231. started under the parent program. When you enable this check box, the Child 
  232. name(s) entry field becomes active. 
  233.  
  234. Child name(s) Entry Field 
  235.  
  236. In the Child name(s) entry field, type the name of the child process you want 
  237. to debug. 
  238.  
  239. You can also select the list button to display a drop-down combination box. 
  240. The drop-down combination box contains a list of up to five previously debugged 
  241. child processes. 
  242.  
  243. Child List Push Button 
  244.  
  245. You can also select the Child list push button. If you select Child list, the 
  246. Select Child Process window displays. From this window, select the child 
  247. process or processes you want to debug. The Program Startup window displays 
  248. again with the child names displayed in the Child name(s) entry field. 
  249.  
  250. After your program starts running and the selected child process is started by 
  251. OS/2, the debugger begins debugging the child process. 
  252.  
  253. Debug program initialization Check Box 
  254.  
  255. Enable the Debug program initialization check box to start the debugger in the 
  256. system initialization routine so that you can debug initialization code. This 
  257. allows you to halt the execution of the application before any initialization 
  258. routines have been executed. This allows you to debug any DLL initialization 
  259. routines. 
  260.  
  261. Use program profile Check Box 
  262.  
  263. Select the Use program profile check box to start the debugging session using a 
  264. program profile. 
  265.  
  266. Related Information 
  267.  
  268. o Command Line Parameters. 
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ <hidden> Command Line Parameters ΓòÉΓòÉΓòÉ
  272.  
  273. To start the debugger from the OS/2 command prompt, enter the command icsdebug 
  274. and the following parameters, in the order they are listed: 
  275.  
  276.  1. Any debugger parameters that you want to use. 
  277.  2. Name of the program you want to debug. 
  278.  3. Any input parameters that you want to pass to the program. 
  279.  
  280. For example, type the following: 
  281.  
  282.    icsdebug /x myprog xyz
  283.  
  284. where /x represents a debugger. parameter, myprog represents your program name, 
  285. and xyz represents the program parameter you want to pass to the program. 
  286.  
  287. The debugger parameters are: 
  288.  
  289. /p+ 
  290.           Use program profile information. 
  291.  
  292. /p- 
  293.           Do not use program profile information. 
  294.  
  295. /i 
  296.           Start the debugger in the system initialization routine so that you 
  297.           can debug initialization code. 
  298.  
  299. /c"child1.exe [child2.exe.. childn.exe]" 
  300.           List the child processes that you want to debug. 
  301.  
  302. To debug REXX DLLs, type the following: 
  303.  
  304.    icsdebug cmd.exe /K <your rexx.cmd>
  305.  
  306. When ICSDEBUG.EXE displays the code for CMD.EXE, do the following: 
  307.  
  308.  1. Set a deferred breakpoint to stop when the DLL is loaded. 
  309.  2. Run the program. 
  310.  3. When the breakpoint is encountered, open the desired component in the DLL 
  311.     and set breakpoints. 
  312.  
  313. To debug WorkPlace Shell objects, replace the RUNWORKPLACE line in your 
  314. config.sys with the following line: 
  315.  
  316.    SET RUNWORKPLACE=C:/OS2/CMD.EXE
  317.  
  318. then type the following at an OS/2 prompt: 
  319.  
  320.    icsdebug c:/os2/pmshell
  321.  
  322.  1. Set a deferred breakpoint for the DLL containing the WPS program. 
  323.  2. Run the program. 
  324.  3. When the breakpoint is encountered, open the desired component in the DLL 
  325.     and set breakpoints. 
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 5. Control Window ΓòÉΓòÉΓòÉ
  329.  
  330. Control Window 
  331.  
  332. The Control window is the control window of the debugger and displays during 
  333. the entire debugging session.  This window is divided into two panes. One pane 
  334. contains the threads and the other contains the components for the program you 
  335. are debugging. 
  336.  
  337. Threads Pane 
  338.  
  339. The Threads pane contains the threads and the state of the threads started by 
  340. your program. To display the state of a thread, select the plus icon to the 
  341. left of the thread. The following states are possible for the threads listed in 
  342. the Threads box: 
  343.  
  344. o Enabled and runnable 
  345. o Disabled and runnable 
  346. o Critical and runnable 
  347. o Suspended and runnable 
  348. o Enabled and blocked 
  349. o Disabled and blocked 
  350. o Critical and blocked 
  351. o Suspended and blocked. 
  352.  
  353. You may enable or disable the highlighted thread in the Threads list by 
  354. toggling the Thread enabled choice from the Run menu. When a check mark symbol 
  355. displays, threads are enabled and the debugger allows the highlighted thread to 
  356. execute. When the check mark symbol does not display, threads are disabled and 
  357. do not executed. 
  358.  
  359. You can also double-click on the word Enabled in the Thread pane to change the 
  360. thread status to Disabled or vice-versa. 
  361.  
  362. Components Pane 
  363.  
  364. The Components pane shows the executable files that are associated with the 
  365. program you are debugging. 
  366.  
  367. To display a list of object files contained within an executable file, select 
  368. the plus icon to the left of the executable file name. To open a source window 
  369. of an object file, double-click on the object file name. 
  370.  
  371. To display a list of functions for a specific object file, select the plus icon 
  372. to the left of the object file name. To open a source window to a specific 
  373. function, double-click on the function name. 
  374.  
  375. You can display any component by double-clicking on the component name that 
  376. displays in the Components box, or by highlighting the component name and 
  377. selecting a view from the View menu. 
  378.  
  379. You specify which components display in the Components list by selecting 
  380. Options  Window Settings  Only components with debug data. When this choice 
  381. is enabled, only components compiled and linked with debugging data are listed. 
  382. Otherwise, all components are listed. 
  383.  
  384. You can also access any debugger window that is already open and hidden or 
  385. minimized by selecting the menu choice that displays that window from the 
  386. Windows menu. 
  387.  
  388. Menu Bar Summary 
  389.  
  390. File 
  391.           Start or end the debugging session and control the source windows. 
  392.  
  393. Breakpoints 
  394.           Set and manipulate breakpoints in your program. 
  395.  
  396. Monitors 
  397.           Select other debugger windows. 
  398.  
  399. Run 
  400.           Execute the program, halt execution, or enable and disable threads. 
  401.  
  402. Options 
  403.           Access various utility windows where you can set debugger options. 
  404.           These debugger options control the various debugger windows. 
  405.  
  406. Windows 
  407.           Display the active debugger windows. 
  408.  
  409. Help 
  410.           Display online help that compliments the information you get when you 
  411.           press F1 or select the Help push button. 
  412.  
  413. Shortcut Keys 
  414.  
  415. The following shortcut keys are available from the Control window: 
  416.  
  417. Where is execution point        Ctrl+P 
  418. Close debugger                  F3 
  419. List (Breakpoints)              Ctrl+X 
  420. Call stack                      Ctrl+K 
  421. Registers                       Ctrl+E 
  422. Storage                         Ctrl+G 
  423. Local variables                 Ctrl+V 
  424. Run                             R 
  425. Halt                            SysRq 
  426.  
  427. Related Information 
  428.  
  429. o Program Startup Window 
  430. o Source Windows 
  431. o Registers Window 
  432. o Call Stack Window 
  433. o Local Variables Window 
  434. o Monitor Expression Window 
  435. o Private Monitor Window 
  436. o Popup Expression Window 
  437. o Storage Window 
  438. o Breakpoint List Window 
  439. o Window Analysis Window 
  440. o Monitor Properties 
  441. o Message Queue Window. 
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ 5.1. File Menu ΓòÉΓòÉΓòÉ
  445.  
  446. Select choices from the File menu of the Control window to start a program, 
  447. find the current line, replace your current program file with a program file 
  448. from another location or with a different name, restart the current debugging 
  449. session, restart a previous debugging session for this program, and end the 
  450. debugging session. 
  451.  
  452. Menu Summary 
  453.  
  454. Open new source 
  455.           Display a new source file. 
  456.  
  457. Locate function 
  458.           Open a source window to a particular function. 
  459.  
  460. Where is execution point 
  461.           Open a source window containing the next line to be executed. 
  462.  
  463. Program startup 
  464.           Start the program you want to debug after ending the current program. 
  465.  
  466. Close debugger 
  467.           End the debugging session. 
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ 5.1.1. Open New Source Choice ΓòÉΓòÉΓòÉ
  471.  
  472. Select the Open new source choice to open a new source file. When you select 
  473. Open new source, the Open New Source window displays. 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ 5.1.2. Locate Function Choice ΓòÉΓòÉΓòÉ
  477.  
  478. Select the Locate function choice to open a source window to a particular 
  479. function. When you select Locate function, the Locate Function window displays. 
  480.  
  481.  
  482. ΓòÉΓòÉΓòÉ 5.1.3. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  483.  
  484. Select the Where is execution point choice to locate the next line to be 
  485. executed in the thread. 
  486.  
  487.  
  488. ΓòÉΓòÉΓòÉ 5.1.4. Program Startup Choice ΓòÉΓòÉΓòÉ
  489.  
  490. Select the Program startup choice to start a program for debugging. Program 
  491. startup allows you to debug another program, while Program restart allows you 
  492. to restart the current debugging session on the existing program. 
  493.  
  494. When you select Program startup, the Program Startup window displays. 
  495.  
  496.  
  497. ΓòÉΓòÉΓòÉ 5.1.5. Program Restart Choice ΓòÉΓòÉΓòÉ
  498.  
  499. Select the Program restart choice to start debugging your program again. 
  500. Program restart allows you to restart the current debugging session on the 
  501. existing program, while Program startup allows you to debug another program. 
  502.  
  503.  
  504. ΓòÉΓòÉΓòÉ 5.1.6. Close Debugger Choice ΓòÉΓòÉΓòÉ
  505.  
  506. Select the Close debugger choice to close your current debugging session.  When 
  507. you select Close debugger, the Close Debugger message box prompts you to 
  508. confirm that you want to end the debugging session. 
  509.  
  510.  
  511. ΓòÉΓòÉΓòÉ 5.2. Breakpoints Menu ΓòÉΓòÉΓòÉ
  512.  
  513. Select choices from the Breakpoints menu to set breakpoints and stop the 
  514. execution of your program at any point. You can set as many breakpoints as you 
  515. want. 
  516.  
  517. Breakpoints can be set from the Control window or from the source window. When 
  518. you set a breakpoint in the source window of your program, it is reflected in 
  519. the other views. 
  520.  
  521. There are five types of breakpoints that you can set. You can customize the 
  522. breakpoints using the various breakpoint windows. 
  523.  
  524. Menu Summary 
  525.  
  526. Set line 
  527.           Set a line breakpoint to stop the execution of your program at a 
  528.           specific line number. 
  529.  
  530. Set function 
  531.           Set a function breakpoint to stop the execution of your program after 
  532.           calling a specific function. 
  533.  
  534. Set address 
  535.           Set an address breakpoint to stop the execution of your program at a 
  536.           specific address. 
  537.  
  538. Set change address 
  539.           Set a change address breakpoint to stop the execution of your program 
  540.           when contents of memory at a given address changes. 
  541.  
  542. Set load occurrence 
  543.           Set a load occurrence breakpoint to stop the execution of your 
  544.           program after loading a DLL. 
  545.  
  546. List 
  547.           List the breakpoints that have been set. 
  548.  
  549. Delete all 
  550.           Delete all breakpoints. 
  551.  
  552. You can also set simple line breakpoints. Double-click on the following to 
  553. learn how to set or clear simple line breakpoints: 
  554.  
  555. o Setting simple line breakpoints 
  556. o Clearing simple line breakpoints. 
  557.  
  558.  
  559. ΓòÉΓòÉΓòÉ 5.2.1. Set Line Choice ΓòÉΓòÉΓòÉ
  560.  
  561. Select the Set line choice to stop the execution of your program at the line 
  562. number you select. When you select Set line, the Set Line window displays. 
  563.  
  564. You can also set simple line breakpoints. Double-click on one of the following 
  565. for the procedures you use to set or clear simple line breakpoints: 
  566.  
  567. o Setting simple line breakpoints 
  568. o Deleting simple line breakpoints. 
  569.  
  570.  
  571. ΓòÉΓòÉΓòÉ 5.2.2. Set Function Choice ΓòÉΓòÉΓòÉ
  572.  
  573. Select the Set function choice to stop the execution of your program after the 
  574. function that you specify is called. When you select Set function, the Set 
  575. Function window displays. 
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ <hidden> Set Function Window ΓòÉΓòÉΓòÉ
  579.  
  580. Use the Set Function window to set a function breakpoint.  Program execution 
  581. stops when the first instruction of the function is encountered where the 
  582. breakpoint has been set. 
  583.  
  584. Function Entry Field 
  585.  
  586. Type the name of the function in the Function entry field. If a function is 
  587. overloaded, then a window displays with a list of all the overloaded function 
  588. names. Select one of the functions from the list. 
  589.  
  590. For example, to set a function breakpoint for the function my_func, type the 
  591. following in the Function entry field. 
  592.  
  593.      my_func
  594.  
  595. Note:  You cannot set a function breakpoint to a function name that was defined 
  596.        using the define preprocessor directive. 
  597.  
  598. Other Entry Fields 
  599.  
  600. For a description of types of data you can type in the other entry fields, 
  601. double-click on one of the following topics: 
  602.  
  603. o Executable 
  604. o Source 
  605. o Expression 
  606. o Thread 
  607. o From 
  608. o To 
  609. o Every. 
  610.  
  611. All executables Check Box 
  612.  
  613. Enable this check box if you want to search all the executable files for the 
  614. function. 
  615.  
  616. Note:  To search for a function in a particular executable file, disable this 
  617. check box and type in the name of the executable file in the Executable entry 
  618. field and the name of the source file in the Source entry field. 
  619.  
  620. Debug data only Check Box 
  621.  
  622. Enable this check box if you want to search only the object files that contain 
  623. debugging data. 
  624.  
  625. Case sensitive Check Box 
  626.  
  627. Enable this check box if you want to search for the string exactly as typed. 
  628. Disable this check box if you want to search for both uppercase and lowercase 
  629. characters. 
  630.  
  631. Defer breakpoint Check Box 
  632.  
  633. Enable this check box if you want to set a breakpoint in a DLL that is not 
  634. currently loaded. If your application consists of DLLs that are dynamically 
  635. loaded, use this choice to set breakpoints in DLLs which have not been loaded 
  636. yet. 
  637.  
  638. Note:  If your application consists of an EXE or preloaded DLLs, do not enable 
  639. this choice. To debug preloaded DLLs, you must enable the Debug initialization 
  640. code check box in the Program Startup window. 
  641.  
  642. If you set a deferred breakpoint in a function and that function is overloaded, 
  643. the debugger sets the breakpoint in all of the overloaded functions when the 
  644. DLL is loaded. 
  645.  
  646. When a DLL is loaded and a deferred breakpoint has been set in the DLL, the 
  647. state of the breakpoint changes from deferred to active. When a DLL is freed, 
  648. any breakpoints that were set in the DLL change from the active state to 
  649. deferred state. Refer to the Breakpoints List window for the current state of 
  650. the breakpoints that have been set. 
  651.  
  652. If you enter an invalid source file or invalid function, the debugger will not 
  653. recognize the name as invalid and will be unable to activate the breakpoint 
  654. when the DLL is loaded. The invalid breakpoint will remain in the deferred 
  655. state even after the DLL is loaded and program execution will not stop when the 
  656. breakpoint is encountered. 
  657.  
  658. Push Buttons 
  659.  
  660. Select the appropriate push button to continue. 
  661.  
  662.  
  663. ΓòÉΓòÉΓòÉ 5.2.3. Set Address Choice ΓòÉΓòÉΓòÉ
  664.  
  665. Select the Set address choice to stop the execution of your program at the 
  666. selected address. When you select Set address, the Set Address window displays. 
  667.  
  668.  
  669. ΓòÉΓòÉΓòÉ <hidden> Set Address Window ΓòÉΓòÉΓòÉ
  670.  
  671. Use the Set Address window to set an address breakpoint. Program execution 
  672. stops when the address is encountered where the breakpoint has been set. 
  673.  
  674. Address Entry Field 
  675.  
  676. Type the name of the address in the Address entry field. 
  677.  
  678. Note:  The address can be either segmented or flat format. 
  679.  
  680. For example, to set an address breakpoint for the address 0x000A1FCC, you would 
  681. type the following in the Address entry field. 
  682.  
  683.      0x000A1FCC
  684.  
  685. The 0x is optional. 
  686.  
  687. or 
  688.  
  689.      A1FCC
  690.  
  691. Other Entry Fields 
  692.  
  693. For a description of types of data you can type in the other entry fields, 
  694. double-click on any of the following topics: 
  695.  
  696. o Thread 
  697. o Every 
  698. o From 
  699. o To 
  700. o Expression 
  701.  
  702. Push Buttons 
  703.  
  704. Select the appropriate push button to continue. 
  705.  
  706.  
  707. ΓòÉΓòÉΓòÉ 5.2.4. Set Change Address Choice ΓòÉΓòÉΓòÉ
  708.  
  709. Select the Set change address choice to stop the execution of your program 
  710. after the contents of memory at a given address changes.  When you select Set 
  711. change address, the Set Change Address window displays. 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ <hidden> Set Change Address Window ΓòÉΓòÉΓòÉ
  715.  
  716. Use the Set Change Address window to set a change address breakpoint.  Program 
  717. execution stops when the contents of memory at a given address changes where 
  718. the breakpoint has been set. 
  719.  
  720. Note:  The debugger supports up to 4 enabled change address breakpoints. 
  721. However, you may set as many disabled change address breakpoints as you want. 
  722.  
  723. Warning: If you set a change address breakpoint that is on the call stack, you 
  724. should remove the breakpoint prior to leaving the routine associated with the 
  725. breakpoint.  Otherwise, when you return from the routine, the routine's stack 
  726. frame will be removed from the stack leaving the breakpoint intact.  Any other 
  727. routine that gets loaded on the stack will then contain the breakpoint. 
  728.  
  729. Address or expression Entry Field 
  730.  
  731. Type a hexadecimal address or an expression that can be evaluated to a 
  732. hexadecimal address. 
  733.  
  734. Note:  If you type ABC in the Address or expression entry field, and there is a 
  735. variable named ABC, it uses the value of the variable instead of the hex value 
  736. ABC. Also, you can type &a in the Address or expression entry field to set the 
  737. breakpoint on the address of a variable a. 
  738.  
  739. For example, type the following in the Address or expression entry field to set 
  740. a change address breakpoint for the address A1FCC. 
  741.  
  742.      A1FCC
  743.  
  744. Type the following in the Address or expression entry field to set a change 
  745. address breakpoint for the expression &variable. 
  746.  
  747.      &variable
  748.  
  749. Other Entry Fields 
  750.  
  751. For a description of types of data you can type in the other window entry 
  752. fields, double-click on one of the following topics: 
  753.  
  754. o Thread 
  755. o From 
  756. o To 
  757. o Every 
  758.  
  759. Bytes to monitor Radio Buttons 
  760.  
  761. Select one of the radio buttons to specify the range of bytes. The range of 
  762. bytes can be one of numbers: 1, 2, or 4. The 2-byte range must be aligned on a 
  763. word boundary and the 4-byte range must be aligned on a double-word boundary. 
  764.  
  765. Push Buttons 
  766.  
  767. Select the appropriate push button to continue. 
  768.  
  769. Related Information 
  770.  
  771. o Expression Language Guidelines. 
  772.  
  773.  
  774. ΓòÉΓòÉΓòÉ 5.2.5. Set Load Occurrence Choice ΓòÉΓòÉΓòÉ
  775.  
  776. Select the Set load occurrence choice to stop the execution of your program 
  777. when the DLL that you specify is loaded. When you select Set load occurrence, 
  778. the Set Load Occurrence window displays. 
  779.  
  780.  
  781. ΓòÉΓòÉΓòÉ <hidden> Expression Language Guidelines ΓòÉΓòÉΓòÉ
  782.  
  783. The following are the rules for evaluating data within these fields. 
  784.  
  785. 0x0100000   Treated as hex number (per language rules of C) 
  786.  
  787. 0100000     Treated as hex number (C language would treat as octal) 
  788.  
  789. 100000      Treated as hex number (C language would treat as decimal) 
  790.  
  791. 0027:0100   Treated as segmented hex address 
  792.             (C language would treat as octal segmented address) 
  793.  
  794. 0100:1002   Treated as segmented hex address 
  795.             (C language would treat as octal/hex segmented address) 
  796.  
  797. 0x287e8     Treated as hex number (per language rules of C) 
  798.  
  799. 287e8       Treated as hex number 
  800.             (C would treat as floating point 287 * 10^8) 
  801.  
  802. abad        Treated as hex number, unless user has a variable defined with this 
  803.             name in the current scope.  If that variable can be represented as 
  804.             a hexadecimal value, the value of the variable will be used. 
  805.             Otherwise, the hex value of 0xabad will be used.  You can force 
  806.             this to be treated as hex value by using the prefix 0x.  For 
  807.             example, 0xABAD. 
  808.  
  809. All other strings will be evaluated strictly by the language rules that apply 
  810. to the part that is currently in scope. 
  811.  
  812. EBP + 10  Treated as value of EBP register plus decimal 10. 
  813.  
  814. 10 + 5    Treated as decimal 15. 
  815.  
  816. 10 + 6F   Cannot be evaluated. 
  817.  
  818. Values for expressions that cannot have a hexadecimal representation will not 
  819. be supported.  The following error message will be displayed for cases of 
  820. invalid expression. 
  821.  
  822.    Invalid address
  823.  
  824.  
  825. ΓòÉΓòÉΓòÉ <hidden> Set Load Occurrence Window ΓòÉΓòÉΓòÉ
  826.  
  827. Use the Set Load Occurrence window to set a load occurrence breakpoint. Program 
  828. execution stops when the DLL is encountered where the breakpoint has been set. 
  829.  
  830. DLL file name Entry Field 
  831.  
  832. Type the name of a DLL in the DLL file name entry field. Execution stops when 
  833. the DLL is loaded. 
  834.  
  835. For example, to set a load occurrence breakpoint when the DLL MY.DLL is loaded, 
  836. type the following in the DLL file name entry field: 
  837.  
  838.      MY
  839.  
  840. or 
  841.  
  842.      MY.DLL
  843.  
  844. Other Entry Fields 
  845.  
  846. For a description of types of data you can type in the other entry fields, 
  847. double-click on one of the following topics: 
  848.  
  849. o Thread 
  850. o From 
  851. o To 
  852. o Every 
  853.  
  854. Push Buttons 
  855.  
  856. Select the appropriate push button to continue. 
  857.  
  858.  
  859. ΓòÉΓòÉΓòÉ <hidden> File Entry Field ΓòÉΓòÉΓòÉ
  860.  
  861. If the source you selected has include files with executable statements, then 
  862. the File list displays all the file names that contain executable lines. 
  863.  
  864.  1. Open the File list by selecting the arrow with your mouse. 
  865.  
  866.  2. Highlight the file where you want to set the breakpoint. 
  867.  
  868.     OR 
  869.  
  870.  3. Type the name of the file in the entry field. 
  871.  
  872.  
  873. ΓòÉΓòÉΓòÉ <hidden> Function Entry Field ΓòÉΓòÉΓòÉ
  874.  
  875. Type in the name of the function where you want to set the breakpoint or select 
  876. a function from the Function list: 
  877.  
  878.  1. Open the Function list by selecting the arrow with your mouse. 
  879.  
  880.  2. Highlight the function you want to set the breakpoint. 
  881.  
  882.     OR 
  883.  
  884.  3. Type the name of the function in the entry field. 
  885.  
  886.  
  887. ΓòÉΓòÉΓòÉ <hidden> Expression Entry Field ΓòÉΓòÉΓòÉ
  888.  
  889. If you are setting an address, function, or line breakpoint, you can also type 
  890. in an expression.  The execution of the program stops only if this condition 
  891. tests true. For example, you could type the following: 
  892.  
  893.    (i==1) || (j==k) && (k!=5)
  894.  
  895. Note:  Variables in a conditional expression associated with a Function 
  896. breakpoint are limited to any static or global variables that are known to the 
  897. called function when the function is called. Local variables and automatic 
  898. variables cannot be used. 
  899.  
  900. The maximum length of the condition is 256 characters. 
  901.  
  902.  
  903. ΓòÉΓòÉΓòÉ <hidden> Thread List ΓòÉΓòÉΓòÉ
  904.  
  905. To select a thread ID from the Thread list: 
  906.  
  907.  1. Open the Thread list by selecting the arrow with your mouse. 
  908.  
  909.  2. Highlight the thread where you want to set the breakpoint. 
  910.  
  911. Select Every, the default, to set a breakpoint in all of the active threads in 
  912. your program. The Every choice is thread independent. Select one of the 
  913. individual threads to set a breakpoint in one thread only.  Threads are added 
  914. to the Thread list as new threads are activated. 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ <hidden> Every Entry Field ΓòÉΓòÉΓòÉ
  918.  
  919. This field is used for location breakpoints and load occurrence breakpoints. 
  920. Type in a whole integer number to indicate how often the breakpoint should be 
  921. activated within the From and To range. 
  922.  
  923.  
  924. ΓòÉΓòÉΓòÉ <hidden> From Entry Field ΓòÉΓòÉΓòÉ
  925.  
  926. This field is used for location breakpoints and load occurrence breakpoints. 
  927. Type in a whole integer number to start activating the breakpoint the nth time 
  928. the location is encountered. 
  929.  
  930.  
  931. ΓòÉΓòÉΓòÉ <hidden> To Entry Field ΓòÉΓòÉΓòÉ
  932.  
  933. This field is used for location breakpoints and load occurrence breakpoints. 
  934. Type in a whole integer number to stop activating the breakpoint after the nth 
  935. time the location is encountered. 
  936.  
  937.  
  938. ΓòÉΓòÉΓòÉ 5.2.6. List Choice ΓòÉΓòÉΓòÉ
  939.  
  940. Select the List choice to list the breakpoints that you have set.  When you 
  941. select List, the Breakpoint List window displays. 
  942.  
  943.  
  944. ΓòÉΓòÉΓòÉ 5.2.7. Delete All Choice ΓòÉΓòÉΓòÉ
  945.  
  946. Select the Delete all choice to delete all the breakpoints that you have set. 
  947.  
  948. When you select Delete all, an information box displays for verification that 
  949. you want to delete all the breakpoints. 
  950.  
  951.  
  952. ΓòÉΓòÉΓòÉ 5.3. Monitors Menu ΓòÉΓòÉΓòÉ
  953.  
  954. Select choices from the Monitors menu to display other debugger windows. 
  955.  
  956. Menu Summary 
  957.  
  958. Call stack 
  959.           Displays the Call Stack window to allow you to monitor the call stack 
  960.           for a particular thread. 
  961.  
  962. Registers 
  963.           Displays the Registers window to allow you to monitor registers and 
  964.           flags for a particular component or thread. 
  965.  
  966. Storage 
  967.           Displays the Storage window to allow you to monitor the storage in 
  968.           your program. 
  969.  
  970. Local variables 
  971.           Displays the local variables for the program's current function. 
  972.  
  973. Window analysis 
  974.           Displays the windows of the program in a three dimensional view. 
  975.  
  976. Message queue 
  977.           Displays the Presentation Manager messages associated with 
  978.           Presentation Manager applications. 
  979.  
  980.  
  981. ΓòÉΓòÉΓòÉ 5.4. Run Menu ΓòÉΓòÉΓòÉ
  982.  
  983. Select choices from the Run menu to execute your program, halt execution, or 
  984. enable or disable threads. 
  985.  
  986. When you select a choice from the Run menu, the mouse pointer changes to a 
  987. clock icon to indicate that the application is running and might require input 
  988. to continue to the next breakpoint or end of the program. 
  989.  
  990. Menu Summary 
  991.  
  992. Run 
  993.           Execute the program from the current line until a breakpoint is 
  994.           encountered or the program ends. 
  995.  
  996. Halt 
  997.           Interrupt the program you are debugging. 
  998.  
  999. Program restart 
  1000.           Restart the current debugging session. 
  1001.  
  1002. Hide debugger on Run 
  1003.           Hides the debugger windows while your application is running. 
  1004.  
  1005. Check heap when stopping 
  1006.           Check all memory blocks allocated or freed by the compiler debug 
  1007.           memory management functions to make sure that overwriting has not 
  1008.           occurred outside the bounds of allocated blocks and free memory 
  1009.           blocks have not been overwritten. 
  1010.  
  1011. Thread enabled 
  1012.           Enable or disable threads. 
  1013.  
  1014.  
  1015. ΓòÉΓòÉΓòÉ 5.4.1. Thread Enabled Choice ΓòÉΓòÉΓòÉ
  1016.  
  1017. Select the Thread enabled choice so that the thread that is highlighted in the 
  1018. Threads box is executed when the program runs. 
  1019.  
  1020. When threads are enabled, a check mark symbol displays beside the Thread 
  1021. enabled choice.  When threads are not enabled, a check mark symbol is not 
  1022. displayed and the highlighted thread is not executed when the program runs. 
  1023.  
  1024.  
  1025. ΓòÉΓòÉΓòÉ 5.4.2. Run Choice ΓòÉΓòÉΓòÉ
  1026.  
  1027. Select the Run choice to execute the program, including all enabled threads, 
  1028. from the current line until a breakpoint is encountered or the program ends. 
  1029.  
  1030.  
  1031. ΓòÉΓòÉΓòÉ 5.4.3. Halt Choice ΓòÉΓòÉΓòÉ
  1032.  
  1033. Select the Halt choice to interrupt the program that you are debugging. You can 
  1034. also access this choice by pressing SysRq (Alt+PrintScreen). 
  1035.  
  1036.  
  1037. ΓòÉΓòÉΓòÉ 5.4.4. Hide Debugger on Run Choice ΓòÉΓòÉΓòÉ
  1038.  
  1039. Select the Hide debugger on Run choice to hide the debugger windows when your 
  1040. program is running. The hidden windows are restored when your program stops. 
  1041. For example, when a breakpoint is encountered. 
  1042.  
  1043.  
  1044. ΓòÉΓòÉΓòÉ 5.4.5. Check Heap When Stopping Choice ΓòÉΓòÉΓòÉ
  1045.  
  1046. Select the Check heap when stopping choice to check all memory blocks allocated 
  1047. or freed by the compiler debug memory management functions.  This makes sure 
  1048. that overwriting has not occurred outside the bounds of allocated blocks and 
  1049. free memory blocks have not been overwritten. 
  1050.  
  1051. When Check heap when stopping choice is enabled, each time the program stops, 
  1052. the heap is checked.  For example, stopping at a breakpoint or at the end of a 
  1053. step command would cause the heap check to be performed. If a heap error is 
  1054. detected, a message box displays with error information. 
  1055.  
  1056. Notes 
  1057.  
  1058. o For the Check heap when stopping choice to work, you have to compile your 
  1059.   application using the Tm+ compiler option. 
  1060. o If you enable the Check heap when stopping choice and you run your 
  1061.   application to termination, the heap check is not made. To check the heap 
  1062.   just before termination, set a breakpoint on the last line of your 
  1063.   application. 
  1064. o If you are debugging a multiple thread program and a thread stops while 
  1065.   running in compiler memory management code which is holding a memory 
  1066.   semaphore, the heap check will not be performed. 
  1067. o If the stopping thread is running in 16-bit code, the heap check will not be 
  1068.   performed. 
  1069.  
  1070.  
  1071. ΓòÉΓòÉΓòÉ 5.5. Windows Menu ΓòÉΓòÉΓòÉ
  1072.  
  1073. Select the Windows menu to display a list of all the open debugger windows. By 
  1074. selecting a window from the Windows menu, it is brought into focus and made the 
  1075. active window. Also, if the window is minimized, it is restored. 
  1076.  
  1077.  
  1078. ΓòÉΓòÉΓòÉ 5.5.1. Windows Choices ΓòÉΓòÉΓòÉ
  1079.  
  1080. Select this choice to make the window active. By selecting this choice, the 
  1081. window is brought into focus and made the active window. Also, if the window is 
  1082. minimized, it is restored. 
  1083.  
  1084.  
  1085. ΓòÉΓòÉΓòÉ 5.5.2. Local Variables Choice ΓòÉΓòÉΓòÉ
  1086.  
  1087. Select the Local variables choice to display the local variables (static, 
  1088. automatic, and parameters) for the current function.  The local variables 
  1089. display in the Local Variables window. 
  1090.  
  1091.  
  1092. ΓòÉΓòÉΓòÉ 5.5.3. Registers Choice ΓòÉΓòÉΓòÉ
  1093.  
  1094. Select the Registers choice to display the processor and math coprocessor 
  1095. registers. 
  1096.  
  1097. When you select Registers, the Registers window displays. 
  1098.  
  1099.  
  1100. ΓòÉΓòÉΓòÉ 5.5.4. Call Stack Choice ΓòÉΓòÉΓòÉ
  1101.  
  1102. Select the Call stack choice to list the active functions or procedures for the 
  1103. thread that is highlighted in the Threads pane of the Control window. 
  1104.  
  1105. When you select Call stack, the Call Stack window displays. 
  1106.  
  1107.  
  1108. ΓòÉΓòÉΓòÉ 5.5.5. Storage Choice ΓòÉΓòÉΓòÉ
  1109.  
  1110. Select the Storage choice to display the contents of storage used by your 
  1111. program. 
  1112.  
  1113. When you select Storage, the Storage window displays. 
  1114.  
  1115.  
  1116. ΓòÉΓòÉΓòÉ 5.5.6. Monitor Expression Choice ΓòÉΓòÉΓòÉ
  1117.  
  1118. Select the Monitor expression choice to display the Monitor Expression window. 
  1119.  
  1120. Use the Monitor Expression window to collect variables or expressions that you 
  1121. want to monitor. 
  1122.  
  1123.  
  1124. ΓòÉΓòÉΓòÉ 5.5.7. Window Analysis Choice ΓòÉΓòÉΓòÉ
  1125.  
  1126. Select the Window analysis choice to display the Window Analysis window which 
  1127. helps you understand Presentation Manager application windows. It presents both 
  1128. graphical and textual information of debugged windows and lets you observe the 
  1129. relationships between windows. 
  1130.  
  1131. Note:  To display the Window Analysis window, you must stop your program. 
  1132.  
  1133.  
  1134. ΓòÉΓòÉΓòÉ 5.5.8. Message Queue Choice ΓòÉΓòÉΓòÉ
  1135.  
  1136. Select the Message queue choice to display the Message Queue Monitor window 
  1137. which displays Presentation Manager messages. 
  1138.  
  1139.  
  1140. ΓòÉΓòÉΓòÉ 5.5.9. Breakpoints Choice ΓòÉΓòÉΓòÉ
  1141.  
  1142. Select the Breakpoints choice to list the breakpoints that you have set. When 
  1143. you select Breakpoints, the Breakpoints window displays. 
  1144.  
  1145.  
  1146. ΓòÉΓòÉΓòÉ 5.6. Options Menu ΓòÉΓòÉΓòÉ
  1147.  
  1148. Select choices from the Options menu of the Control window to control how and 
  1149. what the debugger windows display. 
  1150.  
  1151. Menu Summary 
  1152.  
  1153. Window settings 
  1154.           Control how the items in the Control window display. 
  1155.  
  1156. Debugger settings 
  1157.           Display windows to control the debugger windows. 
  1158.  
  1159.  
  1160. ΓòÉΓòÉΓòÉ 5.6.1. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ
  1161.  
  1162. Select choices from the Window settings choice to modify the characteristics of 
  1163. the Control window. 
  1164.  
  1165. Menu Summary 
  1166.  
  1167. Only components with debug data 
  1168.           Display components that contain debugging data. 
  1169.  
  1170. Sort threads 
  1171.           Sort the threads in numerical order. 
  1172.  
  1173. Sort components 
  1174.           Sort the components in alphabetical order. 
  1175.  
  1176. Titles on 
  1177.           Enable or disable the titles from being displayed in the window. 
  1178.  
  1179. Fonts 
  1180.           Select the font you want to use for the text displayed in the active 
  1181.           window. 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 5.6.1.1. Only Components with Debug Data Choice ΓòÉΓòÉΓòÉ
  1185.  
  1186. You can specify which components display in the Components box. 
  1187.  
  1188. If this choice is enabled, a check mark symbol displays beside the Only 
  1189. components with debug data menu choice and only components containing debugging 
  1190. information are listed. If it is not, all components are listed. 
  1191.  
  1192.  
  1193. ΓòÉΓòÉΓòÉ 5.6.1.2. Sort Threads Choice ΓòÉΓòÉΓòÉ
  1194.  
  1195. You can specify to sort the threads in numerical order from the Threads box. 
  1196.  
  1197. If this choice is enabled, a check mark symbol displays beside the sort threads 
  1198. choice and threads are sorted numerically. 
  1199.  
  1200.  
  1201. ΓòÉΓòÉΓòÉ 5.6.1.3. Sort Components Choice ΓòÉΓòÉΓòÉ
  1202.  
  1203. You can specify to sort the components in alphabetical order from the 
  1204. Components box. 
  1205.  
  1206. If this choice is enabled, a check mark symbol displays beside the Sort 
  1207. components choice and components are sorted alphabetically. 
  1208.  
  1209.  
  1210. ΓòÉΓòÉΓòÉ 5.6.1.4. Titles On Choice ΓòÉΓòÉΓòÉ
  1211.  
  1212. You can specify to display the titles or to turn the titles off in the Control 
  1213. window. The titles are Threads and Components. 
  1214.  
  1215. If this choice is enabled, a check mark symbol displays beside the Titles on 
  1216. choice and titles display. 
  1217.  
  1218.  
  1219. ΓòÉΓòÉΓòÉ 5.6.1.5. Fonts Choice ΓòÉΓòÉΓòÉ
  1220.  
  1221. Select the Fonts choice to choose the font you want to use for the text that 
  1222. displays in the Control window. 
  1223.  
  1224. When you select Fonts, a Fonts window displays. 
  1225.  
  1226.  
  1227. ΓòÉΓòÉΓòÉ 5.6.2. Debugger Settings Cascading Choice ΓòÉΓòÉΓòÉ
  1228.  
  1229. Select choices from the Debugger settings cascading choice to set various 
  1230. debugger options that control how the debugger windows display. These settings 
  1231. affect the behavior of the debugger and remain in effect for the duration of 
  1232. the debugging session. 
  1233.  
  1234. Menu Summary 
  1235.  
  1236. Source window properties 
  1237.           Select the view that is to be displayed when the debugger starts and 
  1238.           how to process the views. 
  1239.  
  1240. Monitor properties 
  1241.           Select the settings for the variable monitor windows. 
  1242.  
  1243. PM debugging mode 
  1244.           Set parameters that control how the debugger handles messages passed 
  1245.           within the debugger and between other Presentation Manager 
  1246.           applications. 
  1247.  
  1248. Default data representation 
  1249.           Select how you want your data displayed in the monitor windows. 
  1250.  
  1251. Program profiles 
  1252.           Enable or disable the use of program profiles, delete, or change the 
  1253.           location where the program profiles are stored. 
  1254.  
  1255. Exception filtering 
  1256.           Select exceptions that you want the debugger to recognize. 
  1257.  
  1258. Save window positions and sizes 
  1259.           Save the position and sizes of all debugger windows. 
  1260.  
  1261. Autosave window positions and sizes 
  1262.           When you enable this choice, the window positions and sizes are 
  1263.           automatically saved when you move or resize a window. When you close 
  1264.           the debugging session and start another session the positions and 
  1265.           sizes that you selected are displayed in the new session. 
  1266.           Alternatively, you may save the window positions and sizes by 
  1267.           positioning the debugger windows on the desktop and selecting the 
  1268.           Save window positions and sizes choice. 
  1269.  
  1270.  
  1271. ΓòÉΓòÉΓòÉ 5.6.2.1. Source Window Properties Choice ΓòÉΓòÉΓòÉ
  1272.  
  1273. Select the Source window properties choice to set the default characteristics 
  1274. of the Source windows. 
  1275.  
  1276. When you select Source window properties, the Source Window Properties window 
  1277. displays. 
  1278.  
  1279.  
  1280. ΓòÉΓòÉΓòÉ 5.6.2.2. Monitor Properties Choice ΓòÉΓòÉΓòÉ
  1281.  
  1282. Select the Monitor Properties choice to select the settings for monitoring 
  1283. variables or expressions. 
  1284.  
  1285. When you select Monitor properties, the Monitor Properties window displays. 
  1286.  
  1287.  
  1288. ΓòÉΓòÉΓòÉ 5.6.2.3. PM Debugging Mode Choice ΓòÉΓòÉΓòÉ
  1289.  
  1290. The PM Debugging Mode choice allows to set the debugging mode to asynchronous 
  1291. or synchronous, and control the interaction between the program windows and PM, 
  1292. while the application has stopped executing. 
  1293.  
  1294. When you select PM debugging mode, the PM Debugging Mode window displays. 
  1295.  
  1296.  
  1297. ΓòÉΓòÉΓòÉ 5.6.2.4. Default Data Representation Cascading Choice ΓòÉΓòÉΓòÉ
  1298.  
  1299. When you select Default data representation, a cascaded menu displays with 
  1300. language choices.  This lets you change the default representation for a data 
  1301. type in the language that you select. 
  1302.  
  1303.  
  1304. ΓòÉΓòÉΓòÉ 5.6.2.5. Language Choices ΓòÉΓòÉΓòÉ
  1305.  
  1306. Select a language to change the default representation of the selected data 
  1307. type. For example, you can change the default representation for an integer in 
  1308. the C language from decimal to hexadecimal. 
  1309.  
  1310. When you select System, the Default Representation window displays. 
  1311.  
  1312.  
  1313. ΓòÉΓòÉΓòÉ 5.6.2.6. System Choice ΓòÉΓòÉΓòÉ
  1314.  
  1315. Select the System choice to change the default representation of the math 
  1316. coprocessor registers. This choice is language independent. 
  1317.  
  1318. When you select the System choice, the Default Representation window displays. 
  1319.  
  1320.  
  1321. ΓòÉΓòÉΓòÉ 5.6.2.7. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  1322.  
  1323. Select the Save window positions and sizes choice to save the position and size 
  1324. of each type of debugger window currently open. Type refers to the different 
  1325. windows such as Registers, Storage, and so on. 
  1326.  
  1327. When you select this choice, the window positions are saved and any new windows 
  1328. will display in the saved positions. 
  1329.  
  1330.  
  1331. ΓòÉΓòÉΓòÉ 5.6.3. Autosave Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  1332.  
  1333. Select the Autosave window positions and sizes choice to enable automatic 
  1334. saving of window positions and sizes for each type of debugger window currently 
  1335. open. Type refers to the different windows such as Registers, Storage, and so 
  1336. on. 
  1337.  
  1338. When you enable this choice, the window positions and sizes are automatically 
  1339. saved when you move or resize a window. When you close the debugging session 
  1340. and start another session the positions and sizes that you selected are 
  1341. displayed in the new session. 
  1342.  
  1343. Alternatively, you may save the window positions and sizes by positioning the 
  1344. debugger windows on the desktop and selecting the Save window positions and 
  1345. sizes choice. 
  1346.  
  1347.  
  1348. ΓòÉΓòÉΓòÉ 5.6.4. Exception Filtering Choice ΓòÉΓòÉΓòÉ
  1349.  
  1350. Use the Exception filtering choice to select the exceptions that you want the 
  1351. debugger to recognize. 
  1352.  
  1353. When you select Exception filtering, the Exception Filtering window displays. 
  1354.  
  1355.  
  1356. ΓòÉΓòÉΓòÉ 5.6.5. Program Profiles Choice ΓòÉΓòÉΓòÉ
  1357.  
  1358. Select the Program profiles cascading choice to specify if you want to enable 
  1359. program profiling, delete program profiles, or change the location where the 
  1360. program profiles are stored. 
  1361.  
  1362. Menu Summary 
  1363.  
  1364. Enable program profiling 
  1365.           Enable or disable the use of program profiles. 
  1366.  
  1367. Delete 
  1368.           Delete program profiles that have been saved for a program that you 
  1369.           have previously debugged. 
  1370.  
  1371. Change location 
  1372.           Change the directory where all the program profiles are stored. 
  1373.  
  1374.  
  1375. ΓòÉΓòÉΓòÉ 5.6.5.1. Enable Program Profiling Choice ΓòÉΓòÉΓòÉ
  1376.  
  1377. Select the Enable program profiling choice to enable or disable the use of 
  1378. program profiles.  When debugging a program more than once, this will restore 
  1379. the breakpoints, source windows and monitors to the same state as when last 
  1380. debugged. 
  1381.  
  1382. When it is enabled, a check mark symbol displays. If it is disabled, a check 
  1383. mark symbol is not displayed. 
  1384.  
  1385.  
  1386. ΓòÉΓòÉΓòÉ 5.6.5.2. Delete Choice ΓòÉΓòÉΓòÉ
  1387.  
  1388. Select the Delete choice to delete the program profiles which for programs that 
  1389. have been previously debugged. 
  1390.  
  1391. When you select Delete, the Delete window displays. 
  1392.  
  1393.  
  1394. ΓòÉΓòÉΓòÉ 5.6.5.3. Change Location Choice ΓòÉΓòÉΓòÉ
  1395.  
  1396. Select the Change location choice to specify the directory where you want the 
  1397. program profiles stored. 
  1398.  
  1399. The default location for the program profiles is as follows: 
  1400.  
  1401.    C:\OS2\
  1402.  
  1403. Where C: is your OS/2 boot drive. 
  1404.  
  1405. When you select Change location, the Change Location window displays. 
  1406.  
  1407.  
  1408. ΓòÉΓòÉΓòÉ 5.7. Help Menu ΓòÉΓòÉΓòÉ
  1409.  
  1410. Select choices from the Help menu to complement the online help information 
  1411. that you can get for the debugger when you press F1 or select the Help push 
  1412. button. 
  1413.  
  1414.  Menu Summary 
  1415.  
  1416. Help index 
  1417.           An alphabetical index of all available debugger help topics. 
  1418.  
  1419. General help 
  1420.           Help information for the active window. 
  1421.  
  1422. Using help 
  1423.           How to use the help facility. 
  1424.  
  1425. How do I 
  1426.           Display the debugger task help. 
  1427.  
  1428. Product information 
  1429.           Display product information. 
  1430.  
  1431.  
  1432. ΓòÉΓòÉΓòÉ 5.7.1. Help Index Choice ΓòÉΓòÉΓòÉ
  1433.  
  1434. Select the Index choice display an alphabetical list of index topics for the 
  1435. debugger. Use the Find choice provided with the online help facility to locate 
  1436. topics in the index. 
  1437.  
  1438.  
  1439. ΓòÉΓòÉΓòÉ 5.7.2. General Help Choice ΓòÉΓòÉΓòÉ
  1440.  
  1441. Select the General help choice to display online help for the active debugger 
  1442. window. The online help panel displayed is the same panel that displays when 
  1443. you place your cursor inside the window and press F1. 
  1444.  
  1445.  
  1446. ΓòÉΓòÉΓòÉ 5.7.3. Using Help Choice ΓòÉΓòÉΓòÉ
  1447.  
  1448. Select the Using help choice to display online help information about the 
  1449. OS/2help facility. 
  1450.  
  1451.  
  1452. ΓòÉΓòÉΓòÉ 5.7.4. How Do I Choice ΓòÉΓòÉΓòÉ
  1453.  
  1454. Select the How do I choice to display the online task help. This lists tasks 
  1455. that you may want to do and instructions on how to complete these tasks. 
  1456.  
  1457.  
  1458. ΓòÉΓòÉΓòÉ 5.7.5. Product Information Choice ΓòÉΓòÉΓòÉ
  1459.  
  1460. Select the Product information choice to display the product information. 
  1461.  
  1462.  
  1463. ΓòÉΓòÉΓòÉ <hidden> Shortcut Keys ΓòÉΓòÉΓòÉ
  1464.  
  1465. The following shortcut keys are available from the Control window. 
  1466.  
  1467. Where is execution point 
  1468.           Ctrl+P 
  1469.  
  1470. Close debugger 
  1471.           F3 
  1472.  
  1473. List 
  1474.           Ctrl+X 
  1475.  
  1476. Call stack 
  1477.           Ctrl+K 
  1478.  
  1479. Registers 
  1480.           Ctrl+E 
  1481.  
  1482. Storage 
  1483.           Ctrl+G 
  1484.  
  1485. Local variables 
  1486.           Ctrl+V 
  1487.  
  1488. Run 
  1489.           R 
  1490.  
  1491. Halt 
  1492.           SysRq 
  1493.  
  1494. The following shortcut keys are available from any source window 
  1495. (Source/Disassembly/Mixed): 
  1496.  
  1497. Where is execution point 
  1498.           Ctrl+P 
  1499.  
  1500. Close debugger 
  1501.           F3 
  1502.  
  1503. Find 
  1504.           Ctrl+F 
  1505.  
  1506. Find next 
  1507.           Ctrl+N 
  1508.  
  1509. List 
  1510.           Ctrl+X 
  1511.  
  1512. Monitor expression 
  1513.           Ctrl+M 
  1514.  
  1515. Call stack 
  1516.           Ctrl+K 
  1517.  
  1518. Registers 
  1519.           Ctrl+E 
  1520.  
  1521. Storage 
  1522.           Ctrl+G 
  1523.  
  1524. Local variables 
  1525.           Ctrl+V 
  1526.  
  1527. Step over 
  1528.           O 
  1529.  
  1530. Step into 
  1531.           I 
  1532.  
  1533. Step debug 
  1534.           D 
  1535.  
  1536. Step return 
  1537.           T 
  1538.  
  1539. Run 
  1540.           R 
  1541.  
  1542. Run to location 
  1543.           L 
  1544.  
  1545. Jump to location 
  1546.           N 
  1547.  
  1548. Halt 
  1549.           SysRq 
  1550.  
  1551. Note:  If you press F3 from any primary window, the debugger will close. 
  1552.  
  1553.  
  1554. ΓòÉΓòÉΓòÉ 6. Source Windows ΓòÉΓòÉΓòÉ
  1555.  
  1556. Source Windows 
  1557.  
  1558. The Source window displays the source code for the program you are debugging. 
  1559. When you start the debugger, the Source window displays if the source file is 
  1560. available. If the source file is not available, the Source Filename window 
  1561. displays. Although, only one source window initially displays, you can display 
  1562. additional source windows at any time. 
  1563.  
  1564. Executable statements display in blue. You can set breakpoints or execute your 
  1565. program only on executable lines. Non-executable lines, such as comments, 
  1566. display in black. The prefix area of each source line displays a line number. 
  1567. If your source file contains include files, the Source window displays in a 
  1568. notebook format where the tabs represent the include files. 
  1569.  
  1570. Title Bar 
  1571.  
  1572. The title bar contains the name of the source file, the thread where the source 
  1573. file runs, and buttons that provide easy access to frequently used features. 
  1574.  
  1575. Title Bar Buttons 
  1576.  
  1577. The title bar buttons display in the title bar of the source window. 
  1578. Double-click on any of the following for a description of that button. 
  1579.  
  1580. Note:  If you place your mouse pointer on a button in the title bar, the name 
  1581. of that button displays in the window title area. As you drag the mouse pointer 
  1582. across the buttons, the name in the window title area changes to reflect the 
  1583. button you are on. 
  1584.  
  1585. The buttons listed in the title bar can also be accessed from the menu items of 
  1586. the source windows.  For example, the step buttons can be found under the Run 
  1587. menu. 
  1588.  
  1589. Views 
  1590.  
  1591. You can display your source in three different views. 
  1592.  
  1593. The Source view  displays the source code for the program you are debugging as 
  1594. it was written. 
  1595.  
  1596. The Disassembly view displays the source code as assembler instructions without 
  1597. the symbolic information. The prefix area of each line displays the address of 
  1598. the assembler instruction. 
  1599.  
  1600. The Mixed view displays the source code for the component and the assembler 
  1601. instructions that are generated for each source line without the symbolic 
  1602. information. 
  1603.  
  1604. You can change from one view to another using one of the following two methods: 
  1605.  
  1606. o Select the View menu from a source window and then select the view you want 
  1607.   displayed. 
  1608. o Select the View button located in the title bar.  This allows you to cycle 
  1609.   through the source windows. The order depends on the view priority. 
  1610.  
  1611. Note:  You can change the view priority of the source windows using the Source 
  1612. Window Properties window. 
  1613.  
  1614. Basic Tasks 
  1615.  
  1616. The following are tasks that can be performed from the Source window: 
  1617.  
  1618. Setting line breakpoints Double-click on the prefix area of any line to set a 
  1619.           simple line breakpoint. For more information about breakpoints, see 
  1620.           Breakpoints. 
  1621.  
  1622. Single stepping your program Press mouse button two to single step your 
  1623.           program. This performs a Step over command. 
  1624.  
  1625. Scrolling to a paticular line number Allows you to scroll to a particular line 
  1626.           number in the source code. This feature also provides the ability to 
  1627.           set breakpoints. Select View  Scroll to line number from a source 
  1628.           window. 
  1629.  
  1630. Selecting include files Allows you to select the include files you want to 
  1631.           view. Include files are files that are included in your source file 
  1632.           by a compiler directive and are considered program source files. 
  1633.           Select View  Select include file from a source window. 
  1634.  
  1635. Monitoring and modifying variables Double-click on any variable name in your 
  1636.           program to display that variable in a monitor window. Drag the mouse 
  1637.           over an expression, and then double-click on the highlighted 
  1638.           expression, to display the expression in a monitor window. 
  1639.  
  1640.           The four windows for monitoring variables and expressions are Monitor 
  1641.           expression, Private monitor, Popup expression, and Local Variables. 
  1642.  
  1643.           Note:  You can change the settings for monitoring variables and 
  1644.           expressions using the Monitor Properties window. 
  1645.  
  1646. Using integration When you start the debugger from within the WorkFrame/2 
  1647.           environment, additional tool support is provided.  A new menu item is 
  1648.           added to the Source window called Project.  This menu allows you to 
  1649.           access other tools such as the editor, the browser, or the compiler. 
  1650.           This feature also provides context sensitive help. This help becomes 
  1651.           available when you select a string, using the mouse pointer, and 
  1652.           press and hold down Ctrl+H. If you place the mouse pointer on a space 
  1653.           in the Source window and double-click, an editor opens to the 
  1654.           corresponding source line that you selected. 
  1655.  
  1656. Menu Bar Summary 
  1657.  
  1658. File 
  1659.           Open a new source file, locate a function, find the current execution 
  1660.           point, start a new debugging session or close the debugger. 
  1661.  
  1662. View 
  1663.           Search for strings in your source file, select a different view of 
  1664.           your program, scroll to a particular line, or change the current 
  1665.           window to a notebook format. 
  1666.  
  1667. Breakpoints 
  1668.           Set and manipulate breakpoints in your program. 
  1669.  
  1670. Monitors 
  1671.           Display the other debugging windows. 
  1672.  
  1673. Run 
  1674.           Run your program in several ways. 
  1675.  
  1676. Options 
  1677.           Change the parameters that control how your program displays and 
  1678.           runs. 
  1679.  
  1680. Windows 
  1681.           Display the active debugger windows. 
  1682.  
  1683. Project 
  1684.           Select other tools such as the editor, compiler, or browser. 
  1685.  
  1686. Help 
  1687.           Display online help that compliments the information you get when you 
  1688.           press F1 or select the Help push button. 
  1689.  
  1690. Shortcut Keys 
  1691.  
  1692. The following shortcut keys are available from the source views 
  1693. (Source/Disassembly/Mixed): 
  1694.  
  1695. Where is execution point        Ctrl+P 
  1696. Close debugger                  F3 
  1697. Find                            Ctrl+F 
  1698. Find next                       Ctrl+N 
  1699. List                            Ctrl+X 
  1700. Monitor expression              Ctrl+M 
  1701. Call stack                      Ctrl+K 
  1702. Registers                       Ctrl+E 
  1703. Storage                         Ctrl+G 
  1704. Local variables                 Ctrl+V 
  1705. Step over                       O 
  1706. Step into                       I 
  1707. Step debug                      D 
  1708. Step return                     T 
  1709. Run                             R 
  1710. Run to location                 L 
  1711. Jump to location                N 
  1712. Halt                            SysRq 
  1713.  
  1714. Related Information 
  1715.  
  1716. o Program Startup Window 
  1717. o Control Window 
  1718. o Registers Window 
  1719. o Call Stack Window 
  1720. o Local Variables Window 
  1721. o Monitor Expression Window 
  1722. o Private Monitor Window 
  1723. o Popup Expression Window 
  1724. o Storage Window 
  1725. o Breakpoint List Window 
  1726. o Window Analysis Window 
  1727. o Monitor Properties 
  1728. o Message Queue Window 
  1729. o Search Path for Source Files. 
  1730.  
  1731.  
  1732. ΓòÉΓòÉΓòÉ <hidden> Step Over Button ΓòÉΓòÉΓòÉ
  1733.  
  1734. Executes the current, highlighted line in the program, but does not enter any 
  1735. called function. You can also access the Step over function by placing the 
  1736. mouse pointer in a source window and clicking mouse button two to execute one 
  1737. line. 
  1738.  
  1739. All enabled threads continue execution. 
  1740.  
  1741. Note:  The debugger stops in a called function if it encounters a breakpoint. 
  1742.  
  1743.  
  1744. ΓòÉΓòÉΓòÉ <hidden> Step Into Button ΓòÉΓòÉΓòÉ
  1745.  
  1746. Executes the current, highlighted line in the program and enters any called 
  1747. program or function. 
  1748.  
  1749. Note:  If you have multiple calls on the same source line and perform a step 
  1750. into for which there is no source code available, the Disassembly view 
  1751. displays.  To return to the Source window, you have to do a step return.  To 
  1752. avoid this, perform step debug so that the debugger will step over any calls 
  1753. for which debugging data is not available, such as library and system 
  1754. functions, and steps into any function for which debugging information is 
  1755. available. 
  1756.  
  1757.  
  1758. ΓòÉΓòÉΓòÉ <hidden> Step Debug Button ΓòÉΓòÉΓòÉ
  1759.  
  1760. Executes the current, highlighted line in the program. The debugger steps over 
  1761. any function for which debugging information is not available (for example, 
  1762. library and system routines), and steps into any function for which debugging 
  1763. information is available. 
  1764.  
  1765.  
  1766. ΓòÉΓòÉΓòÉ <hidden> Step Return Button ΓòÉΓòÉΓòÉ
  1767.  
  1768. Automatically executes the lines of code up to, and including, the return 
  1769. statement of the current function. 
  1770.  
  1771.  
  1772. ΓòÉΓòÉΓòÉ <hidden> Run Button ΓòÉΓòÉΓòÉ
  1773.  
  1774. Runs the program, executing all enabled threads. Control returns to the 
  1775. debugger when: 
  1776.  
  1777. o the program ends 
  1778. o execution stops at an enabled breakpoint. 
  1779.  
  1780. When the debugger is running, the run button changes to 
  1781.  
  1782. You can click on this button to halt the program execution. You can also 
  1783. interrupt the program you are debugging by selecting the Halt choice from the 
  1784. Run menu or by pressing SysRq (Alt+PrintScreen). 
  1785.  
  1786.  
  1787. ΓòÉΓòÉΓòÉ <hidden> Control Button ΓòÉΓòÉΓòÉ
  1788.  
  1789. Displays the Control window. 
  1790.  
  1791.  
  1792. ΓòÉΓòÉΓòÉ <hidden> Call Stack Button ΓòÉΓòÉΓòÉ
  1793.  
  1794. Displays the Call Stack window. 
  1795.  
  1796.  
  1797. ΓòÉΓòÉΓòÉ <hidden> Registers Button ΓòÉΓòÉΓòÉ
  1798.  
  1799. Displays the Registers window. 
  1800.  
  1801.  
  1802. ΓòÉΓòÉΓòÉ <hidden> Monitor Expression Button ΓòÉΓòÉΓòÉ
  1803.  
  1804. Displays the Monitor Expression window. 
  1805.  
  1806.  
  1807. ΓòÉΓòÉΓòÉ <hidden> Storage Button ΓòÉΓòÉΓòÉ
  1808.  
  1809. Displays a new Storage window. 
  1810.  
  1811.  
  1812. ΓòÉΓòÉΓòÉ <hidden> Breakpoints Button ΓòÉΓòÉΓòÉ
  1813.  
  1814. Displays the Breakpoints window. 
  1815.  
  1816.  
  1817. ΓòÉΓòÉΓòÉ <hidden> View Button ΓòÉΓòÉΓòÉ
  1818.  
  1819. Cycles through the available views.  For example, you can change from the 
  1820. Source view to the Disassembly view and then to the Mixed view. 
  1821.  
  1822.  
  1823. ΓòÉΓòÉΓòÉ 6.1. File Menu ΓòÉΓòÉΓòÉ
  1824.  
  1825. Select choices from the File menu of the source windows to start programs, find 
  1826. the current line, replace your current program file with a program file from 
  1827. another location or with a different name, restart the current debugging 
  1828. session, restart a previous debugging session for this program, and end the 
  1829. debugging session. 
  1830.  
  1831. Menu Summary 
  1832.  
  1833. Open new source 
  1834.           Display a new source file. 
  1835.  
  1836. Locate function 
  1837.           Open a source window to a particular function. 
  1838.  
  1839. Where is execution point 
  1840.           Open a source window containing the next line to be executed. 
  1841.  
  1842. Program startup 
  1843.           Start the program you want to debug after ending the current program. 
  1844.  
  1845. Close debugger 
  1846.           Close the debugging session. 
  1847.  
  1848.  
  1849. ΓòÉΓòÉΓòÉ 6.1.1. Source Choice ΓòÉΓòÉΓòÉ
  1850.  
  1851. Select the Source choice to display the source code for your program. 
  1852.  
  1853. The initial Source window displays the source code for the object that contains 
  1854. the main function to the program being debugged. If it is available, the Source 
  1855. window displays with the Control window when the debugging session starts. 
  1856. Otherwise, the Disassembly window displays. 
  1857.  
  1858. Note:  You can change the order of the source window that are opened by using 
  1859.        the Source Window Properties window. 
  1860.  
  1861.  
  1862. ΓòÉΓòÉΓòÉ 6.1.2. Disassembly Choice ΓòÉΓòÉΓòÉ
  1863.  
  1864. Select the Disassembly choice to display the assembler instructions for your 
  1865. program, without symbolic information. 
  1866.  
  1867. The menu choices available in the Disassembly window are the same as for the 
  1868. Source window except for choices listed under the View menu. 
  1869.  
  1870. Note:  You can change the order of the source window that are opened by using 
  1871.        the Source Window Properties window. 
  1872.  
  1873.  
  1874. ΓòÉΓòÉΓòÉ 6.1.3. Mixed Choice ΓòÉΓòÉΓòÉ
  1875.  
  1876. Select the Mixed choice to display each line of source code followed by the 
  1877. assembler instructions that the particular source line generates. 
  1878.  
  1879. The Mixed window displays your program as follows: 
  1880.  
  1881. o Each line of source code is prefixed by a line number, as in the Source 
  1882.   window. 
  1883. o Each disassembled line is prefixed by an address, as in the Disassembly view. 
  1884. o Source comment lines also display. 
  1885. o The lines of source code are treated as comments within the lines of 
  1886.   disassembly code. You can only set breakpoints or run your program on lines 
  1887.   of disassembly code. 
  1888.  
  1889. Notes: 
  1890.  
  1891.  1. The Mixed window cannot be opened if the source code is not available. 
  1892.  
  1893.  2. You can change the order of the source windows that are opened by using the 
  1894.     Source Window Properties window. 
  1895.  
  1896.  
  1897. ΓòÉΓòÉΓòÉ 6.2. View Menu ΓòÉΓòÉΓòÉ
  1898.  
  1899. Select choices from the View menu to search for strings in the text and select 
  1900. a different view of your program or change the current window to a notebook 
  1901. format. 
  1902.  
  1903. Menu Summary 
  1904.  
  1905. Find 
  1906.           Search for text strings in the active window. 
  1907.  
  1908. Find next 
  1909.           Find the next occurrence of a string. 
  1910.  
  1911. Scroll to line number 
  1912.           Scroll to a particular line or set a breakpoint on a specified line. 
  1913.  
  1914. Notebook 
  1915.           Display the the source windows in a notebook format. 
  1916.  
  1917. Select include file 
  1918.           Select to view the include files. 
  1919.  
  1920. Change text file 
  1921.           Select the file name to use as the source in the current view. 
  1922.  
  1923. Source 
  1924.           Displays the Source window. 
  1925.  
  1926. Disassembly 
  1927.           Displays the Disassembly window. 
  1928.  
  1929. Mixed 
  1930.           Displays the Mixed window. 
  1931.  
  1932.  
  1933. ΓòÉΓòÉΓòÉ 6.2.1. Find Choice ΓòÉΓòÉΓòÉ
  1934.  
  1935. Select the Find choice to search for a text string in the active window. 
  1936.  
  1937. When you select Find, the Find window displays, prompting you for the text 
  1938. string you want to find. 
  1939.  
  1940.  
  1941. ΓòÉΓòÉΓòÉ 6.2.1.1. Find Window ΓòÉΓòÉΓòÉ
  1942.  
  1943. To use the Find window to search for a text string: 
  1944.  
  1945.  1. Type the text string you want to search for in the Enter text: entry field. 
  1946.  
  1947.  2. Select the appropriate push button to continue. 
  1948.  
  1949. Enter text: Entry Field 
  1950.           Type the text string you want to search for in this entry field. 
  1951. You can search for simple text strings that do not use wildcards (*). 
  1952.  
  1953. The search string can have: 
  1954.  
  1955. o Alphabetic and numeric characters 
  1956. o A maximum of 256 characters 
  1957. o Uppercase and lowercase characters. 
  1958.  
  1959. Case sensitive Check Box 
  1960.           Enable this check box if you want to search for the string exactly as 
  1961.           typed. Disable this check box to search for uppercase and lowercase 
  1962.           characters. 
  1963.  
  1964.  
  1965. ΓòÉΓòÉΓòÉ 6.2.2. Find Next Choice ΓòÉΓòÉΓòÉ
  1966.  
  1967. Select the Find next choice to search for the next occurrence of a text string. 
  1968. If you are searching in the same program component, the default is the text 
  1969. string you typed the last time you completed the Find window for this 
  1970. component. 
  1971.  
  1972.  
  1973. ΓòÉΓòÉΓòÉ 6.2.3. Scroll to Line Number Choice ΓòÉΓòÉΓòÉ
  1974.  
  1975. Select the Scroll to line number choice from the source windows to go to a 
  1976. particular line in your program or set a line breakpoint. 
  1977.  
  1978. When you select Scroll to line Number, the Scroll to Line Number window 
  1979. displays. 
  1980.  
  1981.  
  1982. ΓòÉΓòÉΓòÉ 6.2.3.1. Scroll to Line Number Window ΓòÉΓòÉΓòÉ
  1983.  
  1984. Use the Scroll to Line Number window to go to a specific line in your program 
  1985. or set a line breakpoint. 
  1986.  
  1987. Note:  If the Source window is active, just type a number and the Scroll to 
  1988. Line Number window automatically displays. 
  1989.  
  1990. To use the Scroll to Line Number window to scroll to a specific line: 
  1991.  
  1992.  1. Type the line number you want to scroll to in the Enter line number: entry 
  1993.     field. 
  1994.  
  1995.  2. Select the OK push button to scroll to that line. 
  1996.  
  1997. To use the Scroll to Line Number window to set a breakpoint: 
  1998.  
  1999.  1. Type the line number you want to set the breakpoint on in the Enter line 
  2000.     number: entry field. 
  2001.  
  2002.  2. Select the Set Breakpoint push button to set the breakpoint on the 
  2003.     specified line number. 
  2004.  
  2005.  
  2006. ΓòÉΓòÉΓòÉ 6.2.4. Notebook Choice ΓòÉΓòÉΓòÉ
  2007.  
  2008. Enable the Notebook choice to display the source windows in notebook format. 
  2009.  
  2010. Note:  If you have include files in your program, the Notebook choice enables 
  2011. by default. 
  2012.  
  2013. You can enable or disable the Notebook choice by selecting it. When it is 
  2014. enabled, a check mark symbol displays. If it is disabled, a check mark symbol 
  2015. is not displayed. 
  2016.  
  2017. The Source and Mixed views can be displayed in a notebook. The Disassembly view 
  2018. cannot be displayed in a notebook. 
  2019.  
  2020.  
  2021. ΓòÉΓòÉΓòÉ 6.2.5. Change Text File Choice ΓòÉΓòÉΓòÉ
  2022.  
  2023. Select the Change text file choice to specify the file name to use as the 
  2024. source in the current view. 
  2025.  
  2026. This is useful if the debugger found the incorrect source file for your 
  2027. program, so that you can specify the use of a different source file from a 
  2028. different directory. 
  2029.  
  2030. For information about how the debugger searches for source files, refer to 
  2031. understanding the search path. 
  2032.  
  2033. When you select Change text file, the Change text file window displays. 
  2034.  
  2035.  
  2036. ΓòÉΓòÉΓòÉ 6.2.5.1. Change Text File Window ΓòÉΓòÉΓòÉ
  2037.  
  2038. Use the Change Text File window to replace the path name or file name of the 
  2039. program you are debugging with a new path name or file name. 
  2040.  
  2041. This specifies a new file name to use as the source in the current source 
  2042. window. 
  2043.  
  2044. This is useful if the debugger found the incorrect source file for your 
  2045. program, so that you can specify the use of a different source file from a 
  2046. different directory. 
  2047.  
  2048. To replace the file name: 
  2049.  
  2050.  1. Type the new path name or file name in the File name entry field. 
  2051.  
  2052.  2. Select the appropriate push button to continue. 
  2053.  
  2054. File name Entry Field 
  2055.           Type the path name and file name of the program you want to replace 
  2056.           with the program you are currently debugging. 
  2057.  
  2058. Related Information 
  2059.  
  2060. o Understanding The Search Path 
  2061.  
  2062.  
  2063. ΓòÉΓòÉΓòÉ 6.2.6. Source Choice ΓòÉΓòÉΓòÉ
  2064.  
  2065. Select the Source choice to display the source code for your program. 
  2066.  
  2067. The initial Source window displays the source code for the object that contains 
  2068. the main function to the program being debugged. If it is available, the Source 
  2069. window displays with the Control window when the debugging session starts. 
  2070. Otherwise, the Disassembly window displays. 
  2071.  
  2072. Note:  You can change the order of the source windows that are opened by using 
  2073.        the Source Window Properties window. 
  2074.  
  2075.  
  2076. ΓòÉΓòÉΓòÉ 6.2.7. Disassembly Choice ΓòÉΓòÉΓòÉ
  2077.  
  2078. Select the Disassembly choice to display the assembler instructions for your 
  2079. program, without symbolic information. The menu choices available in the 
  2080. Disassembly window are the same as for the Source window except that the 
  2081. Variable menu and the Change text file choice in the File menu are not 
  2082. available. 
  2083.  
  2084. Note:  You can change the order of the source window that are opened by using 
  2085.        the Source Window Properties window. 
  2086.  
  2087.  
  2088. ΓòÉΓòÉΓòÉ 6.2.8. Mixed Choice ΓòÉΓòÉΓòÉ
  2089.  
  2090. Select the Mixed choice to display each line of source code followed by the 
  2091. assembler instructions that the particular source line generates. 
  2092.  
  2093. The Mixed window displays your program, as follows: 
  2094.  
  2095. o Each lines of source code is prefixed by its line number, as in the Source 
  2096.   window. 
  2097. o Each disassembled line is prefixed by an address, as in the Disassembly view. 
  2098. o Source comment lines also display. 
  2099. o The lines of source code are treated as comments within the lines of 
  2100.   disassembly code. You can only set breakpoints or run your program on lines 
  2101.   of disassembly code. 
  2102. o The Mixed window cannot be opened if the source code is not available. 
  2103.  
  2104. Note:  You can change the order of the source windows that are opened by using 
  2105. the Source Window Properties window. 
  2106.  
  2107.  
  2108. ΓòÉΓòÉΓòÉ 6.2.9. Locate Function Choice ΓòÉΓòÉΓòÉ
  2109.  
  2110. Select the Locate function choice to open a source window to a particular 
  2111. function. When you select Locate function, the Locate Function window displays. 
  2112.  
  2113.  
  2114. ΓòÉΓòÉΓòÉ 6.2.9.1. Locate Function Window ΓòÉΓòÉΓòÉ
  2115.  
  2116. Use the Locate Function window to open a source window to a particular 
  2117. function. 
  2118.  
  2119. To use the Locate Function window: 
  2120.  
  2121.  1. Type the name of the function you want to search for in the Function entry 
  2122.     field. 
  2123.  
  2124.  2. Select the appropriate push button to continue. 
  2125.  
  2126. All executables Check Box 
  2127.           Enable this check box to search all the executable files for the 
  2128.           function. 
  2129.  
  2130.           The debugger searches each object file for global functions that 
  2131.           match the function name specified. If an object file contains the 
  2132.           global function that was specified, then it will also search for any 
  2133.           static function with the same name. 
  2134.  
  2135.           Note:  To search for a function in a specific executable file, 
  2136.           disable this check box and type the name of the executable file in 
  2137.           the Executable entry field and type the name of the source file in 
  2138.           the Source entry field. 
  2139.  
  2140. Debug data only Check Box 
  2141.           Enable this check box if you want to search only the object files 
  2142.           that contain debugging information. 
  2143.  
  2144. Case sensitive Check Box 
  2145.           Enable this check box if you want to search for the string exactly as 
  2146.           typed. Disable this check box if you want to search for both 
  2147.           uppercase and lowercase characters. 
  2148.  
  2149. If the function that you specify is not found, the following message displays: 
  2150.  
  2151.    No matching function found
  2152.  
  2153. This means it may be a static function or the function you specified does not 
  2154. exist. 
  2155.  
  2156.  
  2157. ΓòÉΓòÉΓòÉ 6.2.10. Open New Source Choice ΓòÉΓòÉΓòÉ
  2158.  
  2159. Select the Open new source choice to open a new source file. When you select 
  2160. Open new source, the Open New Source window displays. 
  2161.  
  2162.  
  2163. ΓòÉΓòÉΓòÉ 6.2.10.1. Open New Source Window ΓòÉΓòÉΓòÉ
  2164.  
  2165. Use the Open New Source window to open a new source file. 
  2166.  
  2167. To use the Open New Source window: 
  2168.  
  2169.  1. Type the name of the object file you want to open the source for in the 
  2170.     Source entry field. For example, to look for the source used to compile 
  2171.     A123.OBJ, type the following: 
  2172.  
  2173.             A123.CPP
  2174.  
  2175.     If you are unsure of the file name, select the File List push button to 
  2176.     view a list of the files that you can select. 
  2177.  
  2178.  2. Type the name of the executable file in the Executable entry field.  The 
  2179.     source files for the executable file display in the Source entry field. 
  2180.  
  2181.     Note:  You have to disable the All executables check box option to search 
  2182.     only one executable file. 
  2183.  
  2184.  3. Select the appropriate push button to continue. 
  2185.  
  2186. All executables Check Box 
  2187.           Enable this option if you want to search all the executable files. 
  2188.           Disable this option to search only one executable file. 
  2189.  
  2190. Debug data only Check Box 
  2191.           Enable this option if you want to search only the source files that 
  2192.           contain debugging information. 
  2193.  
  2194.  
  2195. ΓòÉΓòÉΓòÉ 6.2.11. Select Include File Choice ΓòÉΓòÉΓòÉ
  2196.  
  2197. Use the Select include file choice to select the include file you want to view. 
  2198.  
  2199.  
  2200. ΓòÉΓòÉΓòÉ 6.2.11.1. Select Include File Window ΓòÉΓòÉΓòÉ
  2201.  
  2202. Use the Select Include File window to select the include file you want to view. 
  2203.  
  2204. To use the Select Include File window: 
  2205.  
  2206.  1. Select the include file.  The include file name is highlighted. 
  2207.  
  2208.  2. Select the OK push button.  The selected include file view displays. 
  2209.  
  2210.  
  2211. ΓòÉΓòÉΓòÉ 6.2.12. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  2212.  
  2213. Select the Where is execution point choice to locate the next line in the 
  2214. thread to be executed. 
  2215.  
  2216.  
  2217. ΓòÉΓòÉΓòÉ 6.2.13. Program Startup Choice ΓòÉΓòÉΓòÉ
  2218.  
  2219. Select the Program startup choice to start a program for debugging. Program 
  2220. startup allows you to debug another program, while Program restart allows you 
  2221. to restart the current debugging session on the existing program. 
  2222.  
  2223. When you select Program startup, the Program Startup window displays. 
  2224.  
  2225.  
  2226. ΓòÉΓòÉΓòÉ 6.2.14. Program Restart Choice ΓòÉΓòÉΓòÉ
  2227.  
  2228. Select the Program restart choice to start debugging your program again. 
  2229. Program restart allows you to restart the current debugging session on the 
  2230. existing program, while Program startup allows you to debug another program. 
  2231.  
  2232.  
  2233. ΓòÉΓòÉΓòÉ 6.2.15. Close Debugger Choice ΓòÉΓòÉΓòÉ
  2234.  
  2235. Select the Close debugger choice to close your current debugging session. 
  2236.  
  2237. When you select the Close debugger choice, a message box prompts you to confirm 
  2238. that you want to end the debugging session. 
  2239.  
  2240.  
  2241. ΓòÉΓòÉΓòÉ 6.3. Breakpoints Menu ΓòÉΓòÉΓòÉ
  2242.  
  2243. Select choices from the Breakpoints menu to set breakpoints and to stop the 
  2244. execution of your program at any point. You can set as many breakpoints as you 
  2245. want. 
  2246.  
  2247. Breakpoints can be set from the Control window or from a source window. When 
  2248. you set a breakpoint in one view of your program, it is reflected in the other 
  2249. appropriate views. 
  2250.  
  2251. There are five breakpoints that you can set. You can customize the breakpoints 
  2252. using the various breakpoint windows. 
  2253.  
  2254. Menu Summary 
  2255.  
  2256. Set line 
  2257.           Set a line breakpoint to stop the execution of your program at a 
  2258.           specific line number. 
  2259.  
  2260. Set function 
  2261.           Set a function breakpoint to stop the execution of your program after 
  2262.           calling a specific function. 
  2263.  
  2264. Set address 
  2265.           Set an address breakpoint to stop the execution of your program at a 
  2266.           specific address. 
  2267.  
  2268. Set change address 
  2269.           Set a change address breakpoint to stop the execution of your program 
  2270.           when contents of memory at a given address changes. 
  2271.  
  2272. Set load occurrence 
  2273.           Set a load occurrence breakpoint to stop the execution of your 
  2274.           program after loading a DLL. 
  2275.  
  2276. List 
  2277.           List the set breakpoints. 
  2278.  
  2279. Delete all 
  2280.           Delete all the set breakpoints. 
  2281.  
  2282. You can also set simple line breakpoints. Double-click on one of the following 
  2283. for the procedures you use to set or clear simple line breakpoints: 
  2284.  
  2285. o Setting simple line breakpoints 
  2286. o Deleting simple line breakpoints. 
  2287.  
  2288.  
  2289. ΓòÉΓòÉΓòÉ 6.3.1. Set Line Choice ΓòÉΓòÉΓòÉ
  2290.  
  2291. Select the Set line choice to stop the execution of your program at the line 
  2292. number you select. When you select Set line, the Set Line window displays. 
  2293.  
  2294. You can also set simple line breakpoints. Double-click on one of the following 
  2295. for the procedures you use to set or clear simple line breakpoints: 
  2296.  
  2297. o Setting simple line breakpoints 
  2298. o Deleting simple line breakpoints. 
  2299.  
  2300.  
  2301. ΓòÉΓòÉΓòÉ 6.3.2. Set Function Choice ΓòÉΓòÉΓòÉ
  2302.  
  2303. Select the Set function choice to stop the execution of your program after the 
  2304. function that you specify is called. When you select Set function, the Set 
  2305. Function window displays. 
  2306.  
  2307.  
  2308. ΓòÉΓòÉΓòÉ 6.3.3. Set Address Choice ΓòÉΓòÉΓòÉ
  2309.  
  2310. Select the Set address choice to stop the execution of your program at the 
  2311. selected address. When you select Set address, the Set Address window displays. 
  2312.  
  2313.  
  2314. ΓòÉΓòÉΓòÉ 6.3.4. Set Change Address Choice ΓòÉΓòÉΓòÉ
  2315.  
  2316. Select the Set change address choice to stop the execution of your program 
  2317. after the contents of memory at a given address changes. When you select Set 
  2318. change address, the Set Change Address window displays. 
  2319.  
  2320.  
  2321. ΓòÉΓòÉΓòÉ 6.3.5. Set Load Occurrence Choice ΓòÉΓòÉΓòÉ
  2322.  
  2323. Select the Set load occurrence choice to stop the execution of your program 
  2324. when the DLL that you specify is loaded. When you select Set load occurrence, 
  2325. the Set Load Occurrence window displays. 
  2326.  
  2327.  
  2328. ΓòÉΓòÉΓòÉ 6.3.6. List Choice ΓòÉΓòÉΓòÉ
  2329.  
  2330. Select the List choice to list the breakpoints that you have set. When you 
  2331. select List, the Breakpoint List window displays. 
  2332.  
  2333.  
  2334. ΓòÉΓòÉΓòÉ 6.3.7. Delete All Choice ΓòÉΓòÉΓòÉ
  2335.  
  2336. Select the Delete all choice to delete all the breakpoints that you have set. 
  2337.  
  2338. When you select Delete all, an information box displays for verification that 
  2339. you want to delete all the breakpoints. 
  2340.  
  2341.  
  2342. ΓòÉΓòÉΓòÉ 6.4. Monitors Menu ΓòÉΓòÉΓòÉ
  2343.  
  2344. Select choices from the Monitors menu to monitor expressions and variables and 
  2345. display other debugger windows. 
  2346.  
  2347. Menu Summary 
  2348.  
  2349. Monitor expression 
  2350.           Displays the Monitor Expression window to allow you to type the name 
  2351.           of the variable or expression you want to monitor. 
  2352.  
  2353. Call stack 
  2354.           Displays the Call Stack window to allow you to monitor the call stack 
  2355.           for a particular thread. 
  2356.  
  2357. Registers 
  2358.           Displays the Registers window to allow you to monitor registers and 
  2359.           flags for a particular component or thread. 
  2360.  
  2361. Storage 
  2362.           Displays the Storage window to allow you to monitor the storage in 
  2363.           your program. 
  2364.  
  2365. Local variables 
  2366.           Displays the local variables for the program's current function. 
  2367.  
  2368. Window analysis 
  2369.           Displays the windows of the program in a three dimensional view. 
  2370.  
  2371. Message queue 
  2372.           Displays the Presentation Manager messages associated with 
  2373.           Presentation Manager applications. 
  2374.  
  2375.  
  2376. ΓòÉΓòÉΓòÉ 6.4.1. Popup Expression Choice ΓòÉΓòÉΓòÉ
  2377.  
  2378. Select the Popup expression choice to monitor the highlighted variable or 
  2379. expression in a popup expression window. When you select the Popup expression 
  2380. choice, the Popup Expression window displays. 
  2381.  
  2382.  
  2383. ΓòÉΓòÉΓòÉ 6.4.2. Add to Private Monitor Choice ΓòÉΓòÉΓòÉ
  2384.  
  2385. Select the Add to private monitor choice to add the highlighted variable or 
  2386. expression to the Private Monitor window. 
  2387.  
  2388. To use the Add to private monitor choice: 
  2389.  
  2390.  1. Highlight the variable or expression you want to monitor by pressing and 
  2391.     holding mouse button one on the variable and dragging the mouse pointer 
  2392.     across the variable or expression. You can also highlight the variable by 
  2393.     double-clicking on the variable. 
  2394.  
  2395.  2. Select the Add to private monitor choice. The variable or expression you 
  2396.     highlighted is added to the Private Monitor window. 
  2397.  
  2398.  
  2399. ΓòÉΓòÉΓòÉ 6.4.3. Add to Monitor Expression Choice ΓòÉΓòÉΓòÉ
  2400.  
  2401. Select the Add to monitor expression choice to add the highlighted variable or 
  2402. expression to the Monitor Expression window. 
  2403.  
  2404. To use the Add to monitor expression choice: 
  2405.  
  2406.  1. Highlight the variable or expression you want to monitor by pressing and 
  2407.     holding mouse button one on the variable and dragging the mouse pointer 
  2408.     across the variable or expression. You can also highlight the variable by 
  2409.     double-clicking on the variable. 
  2410.  
  2411.  2. Select the Add to monitor expression choice. The variable or expression you 
  2412.     highlighted is added to the Monitor Expression window. 
  2413.  
  2414.  
  2415. ΓòÉΓòÉΓòÉ 6.4.4. Add to Storage Monitor Choice ΓòÉΓòÉΓòÉ
  2416.  
  2417. Select the Add to storage monitor choice to add a variable or expression to the 
  2418. Storage window. 
  2419.  
  2420. To add a variable or expression to the Storage window, do the following: 
  2421.  
  2422.  1. Highlight the variable or expression. 
  2423.  
  2424.  2. Select the Add to storage monitor choice. 
  2425.  
  2426. The value of whatever you highlight is evaluated and the contents found at this 
  2427. location is displayed. 
  2428.  
  2429. The Storage window displays with the selected variable or expression. 
  2430.  
  2431.  
  2432. ΓòÉΓòÉΓòÉ 6.4.5. Monitor Expression Choice ΓòÉΓòÉΓòÉ
  2433.  
  2434. Select the Monitor expression choice if you want to use the keyboard to type 
  2435. the name of a variable or an expression you want to monitor. 
  2436.  
  2437. When you select Monitor expression, the Monitor Expression window displays. 
  2438.  
  2439.  
  2440. ΓòÉΓòÉΓòÉ 6.4.5.1. Monitor Expression ΓòÉΓòÉΓòÉ
  2441.  
  2442. Use the Monitor Expression window to type in the expression you want to 
  2443. monitor. 
  2444.  
  2445. This window lists the following contextual information: 
  2446.  
  2447. o The component you are in. 
  2448. o The active line of the source code, which is highlighted. 
  2449. o The view of the program that is active. 
  2450. o The thread you are in. 
  2451.  
  2452. The expression language supported by the debugger is a subset of the C/C++ 
  2453. language. You can monitor only expressions with: 
  2454.  
  2455. o A supported operand type 
  2456. o A supported operator 
  2457. o A supported typecasting operation. 
  2458.  
  2459. To specify an expression to be monitored: 
  2460.  
  2461.  1. Type the name of the variable or expression you want to monitor in the 
  2462.     Expression entry field. 
  2463.  
  2464.  2. Select the appropriate push button from the Add to group box for the 
  2465.     location from where you want to monitor your expression. 
  2466.  
  2467.     Note:  The expression displays as specified in the Monitor Properties 
  2468.     window. To change the default location, select Monitor properties from the 
  2469.     Debugger settings choice from the Options menu in the source windows or the 
  2470.     Control window. 
  2471.  
  2472.  
  2473. ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Mouse ΓòÉΓòÉΓòÉ
  2474.  
  2475. To select a variable or expression for display using the mouse, use one of the 
  2476. following methods: 
  2477.  
  2478. o Point to any character within the variable name and double-click mouse button 
  2479.   one. 
  2480. o Highlight the variable name or expression by pressing and holding mouse 
  2481.   button one and dragging the mouse pointer across the variable name or 
  2482.   expression, and then double-click mouse button one anywhere within the name. 
  2483. o Highlight the variable name or expression and select Add to monitor 
  2484.   expression, Add to private monitor, or Popup expression from the Variable 
  2485.   menu. 
  2486.  
  2487.  
  2488. ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Mouse and Monitor Expression Window ΓòÉΓòÉΓòÉ
  2489.  
  2490. To monitor a variable or an expression using the mouse and the Monitor 
  2491. Expression window, use one of the two following methods: 
  2492.  
  2493. For a single variable name: 
  2494.  
  2495.  1. Highlight the variable name using either of the following methods: 
  2496.  
  2497.    o Point to the variable name and click on mouse button one. 
  2498.    o Highlight the variable by placing the mouse pointer on the beginning of 
  2499.      the variable and dragging the mouse across the entire variable while 
  2500.      pressing mouse button one. 
  2501.  
  2502.  2. Select Monitor expression from the Variable menu. 
  2503.  
  2504.     The Monitor Expression window displays with the highlighted variable name 
  2505.     in the Expression entry field. 
  2506.  
  2507. For an expression: 
  2508.  
  2509.  1. Highlight the expression by placing the mouse pointer on the beginning of 
  2510.     the expression and dragging the mouse across the entire expression while 
  2511.     pressing mouse button one. 
  2512.  
  2513.  2. Select Monitor expression from the Variable menu. 
  2514.  
  2515.     The Monitor Expression window displays with the highlighted expression name 
  2516.     in the Expression entry field. 
  2517.  
  2518. Select the appropriate push button to continue. 
  2519.  
  2520.  
  2521. ΓòÉΓòÉΓòÉ <hidden> Selecting Variables with the Keyboard ΓòÉΓòÉΓòÉ
  2522.  
  2523. To monitor a variable or expression using the keyboard: 
  2524.  
  2525.  1. Select Monitor expression from the Variable menu. The Monitor Expression 
  2526.     window displays. 
  2527.  
  2528.  2. Type the name of the variable or expression in the Expression entry field. 
  2529.  
  2530.  3. To change the defaults that control how a variable or expression displays 
  2531.     in a monitor or popup expression window, do the following: 
  2532.  
  2533.     a. Select Monitor Properties push button to display the Monitor Properties 
  2534.        window. 
  2535.  
  2536.     b. Select OK to close the Monitor Properties window. 
  2537.  
  2538.  4. Select OK to close the Monitor Expression window. 
  2539.  
  2540.  
  2541. ΓòÉΓòÉΓòÉ 6.5. Windows Menu ΓòÉΓòÉΓòÉ
  2542.  
  2543. Select the Windows menu to display a list of all the open debugger windows. By 
  2544. selecting a window from the Windows menu, it is brought into focus and made the 
  2545. active window. Also, if the window is minimized, it is restored. 
  2546.  
  2547.  
  2548. ΓòÉΓòÉΓòÉ 6.5.1. Windows Choices ΓòÉΓòÉΓòÉ
  2549.  
  2550. Select this choice to make the window active. By selecting this choice, the 
  2551. window is brought into focus and made the active window. Also, if the window is 
  2552. minimized, it is restored. 
  2553.  
  2554.  
  2555. ΓòÉΓòÉΓòÉ 6.5.2. Local Variables Choice ΓòÉΓòÉΓòÉ
  2556.  
  2557. Select the Local variables choice to display the local variables (static, 
  2558. automatic, and parameters) for the current function. 
  2559.  
  2560. When you select Local variables, the Local Variables window displays. 
  2561.  
  2562.  
  2563. ΓòÉΓòÉΓòÉ 6.5.3. Registers Choice ΓòÉΓòÉΓòÉ
  2564.  
  2565. Select the Registers choice to display the processor and math coprocessor 
  2566. registers. 
  2567.  
  2568.  
  2569. ΓòÉΓòÉΓòÉ 6.5.4. Call Stack Choice ΓòÉΓòÉΓòÉ
  2570.  
  2571. Select the Call stack choice to list the active functions or procedures for the 
  2572. thread that is displayed in the source window. 
  2573.  
  2574. When you select Call stack, the Call Stack window displays. 
  2575.  
  2576.  
  2577. ΓòÉΓòÉΓòÉ 6.5.5. Private Monitor Choice ΓòÉΓòÉΓòÉ
  2578.  
  2579. Select the Private Monitor choice to display the Private Monitor window. 
  2580.  
  2581.  
  2582. ΓòÉΓòÉΓòÉ 6.5.6. Monitor Expression Choice ΓòÉΓòÉΓòÉ
  2583.  
  2584. Select the Monitor expression choice to display the Monitor Expression window. 
  2585.  
  2586. Use the Monitor Expression window to collect variables or expressions that you 
  2587. want to monitor. 
  2588.  
  2589.  
  2590. ΓòÉΓòÉΓòÉ 6.5.7. Storage Choice ΓòÉΓòÉΓòÉ
  2591.  
  2592. Select the Storage choice to display the contents of storage used by your 
  2593. program. 
  2594.  
  2595. When you select Storage, the Storage window displays. 
  2596.  
  2597.  
  2598. ΓòÉΓòÉΓòÉ <hidden> Using the Storage Window ΓòÉΓòÉΓòÉ
  2599.  
  2600. You can scroll through storage using the up or down arrow keys and the PageUp 
  2601. or PageDown keys. 
  2602.  
  2603. To update the storage contents, type over the contents displayed in the Storage 
  2604. window. The display is updated when an elapsed time of one second occurs after 
  2605. the last keystroke has been typed. The contents of all affected windows are 
  2606. updated for each character changed in the Storage window. 
  2607.  
  2608. To specify a new address location, type over the address field displayed in the 
  2609. Storage window. When an elapsed time of one second occurs after the last 
  2610. keystroke has been typed, the window scrolls to the appropriate storage 
  2611. location. 
  2612.  
  2613.  
  2614. ΓòÉΓòÉΓòÉ 6.5.8. Window Analysis Choice ΓòÉΓòÉΓòÉ
  2615.  
  2616. Select the Window analysis choice to help you understand Presentation Manager 
  2617. application windows. It presents both graphical and textual information of 
  2618. debugged windows and lets you observe the relationships between windows. 
  2619.  
  2620. Note:  To display the Window Analysis window, you must stop your program. 
  2621.  
  2622.  
  2623. ΓòÉΓòÉΓòÉ 6.5.9. Message Queue Choice ΓòÉΓòÉΓòÉ
  2624.  
  2625. Select the Message queue choice to display the Message Queue Monitor window 
  2626. which displays Presentation Manager messages. 
  2627.  
  2628.  
  2629. ΓòÉΓòÉΓòÉ 6.5.10. Breakpoints Choice ΓòÉΓòÉΓòÉ
  2630.  
  2631. Select the Breakpoints choice to list the breakpoints that you have set. When 
  2632. you select Breakpoints, the Breakpoints window displays. 
  2633.  
  2634.  
  2635. ΓòÉΓòÉΓòÉ 6.5.11. Control Choice ΓòÉΓòÉΓòÉ
  2636.  
  2637. Select the Control choice to display the Control window. 
  2638.  
  2639.  
  2640. ΓòÉΓòÉΓòÉ 6.6. Run Menu ΓòÉΓòÉΓòÉ
  2641.  
  2642. Select choices from the Run menu to control the execution of your program. You 
  2643. can step through your program in several ways, or you can run your program 
  2644. until a breakpoint is encountered or your program is ended. 
  2645.  
  2646. You can access any of the choices in the Run menu by using the shortcut keys. 
  2647. These keys are also listed in the Run menu. For the Step over command, you can 
  2648. use the mouse. 
  2649.  
  2650. When you select a choice from the Run menu, the mouse pointer changes to a 
  2651. clock icon to indicate that the application is running and might require input 
  2652. to continue to the next breakpoint or end of the program. 
  2653.  
  2654. Menu Summary 
  2655.  
  2656. Step over 
  2657.           Execute the current line in your program. If the current line is a 
  2658.           call, execution stops when the call completes. 
  2659.  
  2660. Step into 
  2661.           Execute the current line in your program. If the current line is a 
  2662.           call, execution stops at the first statement in the called function. 
  2663.  
  2664. Step debug 
  2665.           Execute the current line in the program. The debugger steps over any 
  2666.           function for which debugging information is not available and steps 
  2667.           into any function for which debugging information is available. 
  2668.  
  2669. Step return 
  2670.           Step through the current function until the return is executed. 
  2671.  
  2672. Run 
  2673.           Execute the program from the current line until a breakpoint is 
  2674.           encountered or the program ends. 
  2675.  
  2676. Halt 
  2677.           Interrupt the program you are debugging. 
  2678.  
  2679. Run to location 
  2680.           Execute your program from the current line up to the line that is 
  2681.           highlighted with gray in the prefix area. 
  2682.  
  2683. Jump to location 
  2684.           Change the current line in the program without executing the code 
  2685.           between the present current line and the new current line. 
  2686.  
  2687. Hide debugger on Run 
  2688.           Hide the debugger windows while your application is running. 
  2689.  
  2690. Check heap when stopping 
  2691.           Check all memory blocks allocated or freed by the compiler debug 
  2692.           memory management functions to make sure that overwriting has not 
  2693.           occurred outside the bounds of allocated blocks and free memory 
  2694.           blocks have not been overwritten. 
  2695.  
  2696. Thread enabled 
  2697.           Enable or disable threads. 
  2698.  
  2699.  
  2700. ΓòÉΓòÉΓòÉ 6.6.1. Step Over Choice ΓòÉΓòÉΓòÉ
  2701.  
  2702. Select the Step over choice to execute the current line of the program. If the 
  2703. current line is a call, execution stops when the call completes. You can also 
  2704. access the Step over function by placing the mouse pointer in a source window 
  2705. and clicking mouse button two to execute one line. 
  2706.  
  2707. All enabled threads will execute during the step. 
  2708.  
  2709. Note:  The debugger stops in a called function if it encounters a breakpoint. 
  2710.  
  2711.  
  2712. ΓòÉΓòÉΓòÉ 6.6.2. Step Into Choice ΓòÉΓòÉΓòÉ
  2713.  
  2714. Select the Step into choice to execute the current line in the program. If the 
  2715. current line is a call, execution stops at the first statement in the called 
  2716. function. 
  2717.  
  2718. All enabled threads will execute during the step. 
  2719.  
  2720. Note:  If you have multiple calls on the same source line and perform a step 
  2721. into for which there is no source code available, the Disassembly view 
  2722. displays.  To return to the Source window, you have to do a step return.  To 
  2723. avoid this, perform step debug so that the debugger will step over any calls 
  2724. for which debugging data is not available, such as library and system 
  2725. functions, and steps into any function for which debugging information is 
  2726. available. 
  2727.  
  2728.  
  2729. ΓòÉΓòÉΓòÉ 6.6.3. Step Return Choice ΓòÉΓòÉΓòÉ
  2730.  
  2731. Select the Step return choice to automatically execute the lines of code up to, 
  2732. and including, the return statement of the current function. 
  2733.  
  2734. All enabled threads will execute during the step. 
  2735.  
  2736.  
  2737. ΓòÉΓòÉΓòÉ 6.6.4. Step Debug Choice ΓòÉΓòÉΓòÉ
  2738.  
  2739. Select the Step debug choice to execute the current line in the program. The 
  2740. debugger steps over any function for which debugging data is not available, 
  2741. such as library and system functions, and steps into any function for which 
  2742. debugging information is available. 
  2743.  
  2744. All enabled threads will execute during the step. 
  2745.  
  2746.  
  2747. ΓòÉΓòÉΓòÉ 6.6.5. Run Choice ΓòÉΓòÉΓòÉ
  2748.  
  2749. Select the Run choice to execute the program, including all enabled threads, 
  2750. from the current line until a breakpoint is encountered or the program ends. 
  2751.  
  2752.  
  2753. ΓòÉΓòÉΓòÉ 6.6.6. Run to Location Choice ΓòÉΓòÉΓòÉ
  2754.  
  2755. Select the Run to Location choice to execute your program from the current line 
  2756. up to the line that is highlighted or gray in the prefix area. 
  2757.  
  2758. To use the Run to location choice: 
  2759.  
  2760.  1. Single-click in the prefix area of the line you want to become the current 
  2761.     line. The prefix area turns gray. 
  2762.  
  2763.  2. Select the Run to location choice. The program runs up to the line that you 
  2764.     marked. 
  2765.  
  2766. The Run to location choice stops only on executable lines. If a highlighted 
  2767. line is not executable, the run is not performed. 
  2768.  
  2769.  
  2770. ΓòÉΓòÉΓòÉ 6.6.7. Jump to Location Choice ΓòÉΓòÉΓòÉ
  2771.  
  2772. Select the Jump to Location choice to change the current line in your program 
  2773. without executing the lines between the present current line and the new 
  2774. current line. 
  2775.  
  2776. To use the Jump to location choice: 
  2777.  
  2778.  1. Single-click in the prefix area of the line you want to become the current 
  2779.     line. The prefix area turns gray. 
  2780.  
  2781.  2. Select the Jump to location choice. The current line is changed and the 
  2782.     lines between are not executed. 
  2783.  
  2784. The Jump to location choice stops only on executable lines. If a highlighted 
  2785. line is not executable, the jump is not performed. 
  2786.  
  2787. Warning Jumping out of the current function may corrupt the call stack and 
  2788. cause your program to produce unpredictable results. 
  2789.  
  2790.  
  2791. ΓòÉΓòÉΓòÉ 6.6.8. Thread Enabled Choice ΓòÉΓòÉΓòÉ
  2792.  
  2793. Select the Thread enabled choice to execute the thread associated with the 
  2794. current source window, when the program runs. 
  2795.  
  2796. When a thread is enabled, a check mark symbol displays beside the Thread 
  2797. enabled choice. When a thread is not enabled, a check mark symbol does not 
  2798. display and the highlighted thread is not executed. 
  2799.  
  2800.  
  2801. ΓòÉΓòÉΓòÉ 6.6.9. Halt Choice ΓòÉΓòÉΓòÉ
  2802.  
  2803. Select the Halt choice to interrupt the program that you are debugging. You can 
  2804. also access this choice by pressing SysRq (Alt+PrintScreen). 
  2805.  
  2806.  
  2807. ΓòÉΓòÉΓòÉ 6.6.10. Hide Debugger on Run Choice ΓòÉΓòÉΓòÉ
  2808.  
  2809. Select the Hide debugger on Run choice to hide the debugger windows when your 
  2810. program is running. The hidden windows are restored when your program stops. 
  2811. For example, when a breakpoint is encountered. 
  2812.  
  2813.  
  2814. ΓòÉΓòÉΓòÉ 6.6.11. Check Heap When Stopping Choice ΓòÉΓòÉΓòÉ
  2815.  
  2816. Select the Check heap when stopping choice to check all memory blocks allocated 
  2817. or freed by the compiler debug memory management functions.  This makes sure 
  2818. that overwriting has not occurred outside the bounds of allocated blocks and 
  2819. free memory blocks have not been overwritten. 
  2820.  
  2821. When Check heap when stopping choice is enabled, each time the program stops, 
  2822. the heap is checked.  For example, stopping at a breakpoint or at the end of a 
  2823. step command would cause the heap check to be performed. If a heap error is 
  2824. detected, a message box displays with error information. 
  2825.  
  2826. Notes 
  2827.  
  2828. o For the Check heap when stopping choice to work, you have to compile your 
  2829.   application using the Tm+ compiler option. 
  2830. o If you enable the Check heap when stopping choice and you run your 
  2831.   application to termination, the heap check is not made. To check the heap 
  2832.   just before termination, set a breakpoint on the last line of your 
  2833.   application. 
  2834. o If you are debugging a multiple thread program and a thread stops while 
  2835.   running in compiler memory management code which is holding a memory 
  2836.   semaphore, the heap check will not be performed. 
  2837. o If the stopping thread is running in 16-bit code, the heap check will not be 
  2838.   performed. 
  2839.  
  2840.  
  2841. ΓòÉΓòÉΓòÉ 6.7. Options Menu ΓòÉΓòÉΓòÉ
  2842.  
  2843. Select choices from the Options menu in the Source, Mixed or Disassembly source 
  2844. windows to control the debugger windows. 
  2845.  
  2846. Menu Summary 
  2847.  
  2848. Window Settings 
  2849.           Select the color and font you want. 
  2850.  
  2851. Debugger settings 
  2852.           Set various debugger options. 
  2853.  
  2854.  
  2855. ΓòÉΓòÉΓòÉ 6.7.1. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ
  2856.  
  2857. The following choices are available from the Window Settings cascading choice: 
  2858.  
  2859. Colors 
  2860.           Change the color of various window elements. 
  2861.  
  2862. Fonts 
  2863.           Select the font for the source window. 
  2864.  
  2865.  
  2866. ΓòÉΓòÉΓòÉ 6.7.1.1. Colors Choice ΓòÉΓòÉΓòÉ
  2867.  
  2868. Use the Colors choice to change the color of the background and foreground 
  2869. (text) in the source windows. 
  2870.  
  2871. When you select Colors, the Colors window displays. 
  2872.  
  2873.  
  2874. ΓòÉΓòÉΓòÉ 6.7.1.1.1. Colors Window ΓòÉΓòÉΓòÉ
  2875.  
  2876. Use the Colors window to change the color of the background and foreground 
  2877. (text) in the source windows. 
  2878.  
  2879. To change the color of the background in the source window: 
  2880.  
  2881. o Open the OS/2 Color Palette window. 
  2882. o Using the mouse pointer, select a color from the color palette. 
  2883. o Hold down mouse button two and drag the selected color into the Colors 
  2884.   window. 
  2885. o Release mouse button two over the text line that represents the source window 
  2886.   area that you want to change. 
  2887. o Select the Apply push button. 
  2888.  
  2889. To change the color of the foreground in the source window: 
  2890.  
  2891. o Open the OS/2 Color Palette window. 
  2892. o Using the mouse pointer, select a color from the color palette. 
  2893. o Hold down the Ctrl key and mouse button two and drag the selected color into 
  2894.   the Colors window. 
  2895. o Release the Ctrl key and mouse button two over the text line that represents 
  2896.   the source window area that you want to change. 
  2897. o Select the Apply push button. 
  2898.  
  2899. To continue, select the appropriate push button. 
  2900.  
  2901. Note:  To change the colors in the other debugger windows, simply drag and drop 
  2902. the selected colors directly on the window that you want to change. 
  2903.  
  2904.  
  2905. ΓòÉΓòÉΓòÉ 6.7.2. Fonts Choice ΓòÉΓòÉΓòÉ
  2906.  
  2907. Select the Fonts choice to set the font you want to use for the text that 
  2908. displays in the Source windows. 
  2909.  
  2910.  
  2911. ΓòÉΓòÉΓòÉ 6.7.2.1. Font Selection Window ΓòÉΓòÉΓòÉ
  2912.  
  2913. Use this window to change the font of the text in the current window. 
  2914. ----------------------------------* 
  2915.  
  2916.  
  2917. ΓòÉΓòÉΓòÉ 6.7.3. Debugger Settings Cascading Choice ΓòÉΓòÉΓòÉ
  2918.  
  2919. Select choices from the Debugger settings cascading choice to set various 
  2920. debugger options that control how the debugger windows display. These settings 
  2921. affect the behavior of the debugger and remain in effect for the duration of 
  2922. the debugging session. 
  2923.  
  2924. Menu Summary 
  2925.  
  2926. Source window properties 
  2927.           Select the view that is to be displayed when the debugger starts and 
  2928.           how to process the views. 
  2929.  
  2930. Monitor properties 
  2931.           Select the settings for the variable monitor windows. 
  2932.  
  2933. PM debugging mode 
  2934.           Set parameters that control how the debugger handles messages passed 
  2935.           within the debugger and between other Presentation Manager 
  2936.           applications. 
  2937.  
  2938. Default data representation 
  2939.           Select how you want your data displayed in the monitor windows. 
  2940.  
  2941. Program profiles 
  2942.           Enable or disable the use of program profiles, delete, or change the 
  2943.           location where the program profiles are stored. program profiles. 
  2944.  
  2945. Exception filtering 
  2946.           Select exceptions that you want the debugger to recognize. 
  2947.  
  2948. Save window positions and sizes 
  2949.           Saves the window positions for this debugging session.  When you 
  2950.           close the debugging session and start another session the default 
  2951.           window position and sizes are displayed, 
  2952.  
  2953. Autosave window positions and sizes 
  2954.           When you enable this choice, the window positions and sizes are 
  2955.           automatically saved when you move or resize a window. When you close 
  2956.           the debugging session and start another session the positions and 
  2957.           sizes that you selected are displayed in the new session. 
  2958.           Alternatively, you may save the window positions and sizes by 
  2959.           positioning the debugger windows on the desktop and selecting the 
  2960.           Save window positions and sizes choice. 
  2961.  
  2962.  
  2963. ΓòÉΓòÉΓòÉ 6.7.4. Source Window Properties Choice ΓòÉΓòÉΓòÉ
  2964.  
  2965. Select the Source window properties choice to set the default characteristics 
  2966. of the Source windows. 
  2967.  
  2968. When you select Source window properties, the Source Window Properties window 
  2969. displays. 
  2970.  
  2971.  
  2972. ΓòÉΓòÉΓòÉ 6.7.4.1. Source Window Properties Window ΓòÉΓòÉΓòÉ
  2973.  
  2974. Use the Source Window Properties Window to define: 
  2975.  
  2976. o Which source window displays when the debugger starts and when a source 
  2977.   window first displays during a debugging session. 
  2978. o How to process a source window from which execution has just left. The window 
  2979.   can: 
  2980.  
  2981.    - Remain displayed 
  2982.    - Be turned into an icon 
  2983.    - Be discarded. 
  2984.  
  2985. New view priority Group Box 
  2986.  
  2987. Each source window displays as an icon: 
  2988.  
  2989. Source 
  2990.           Displays the source code for the thread or component. 
  2991.  
  2992. Disassembly 
  2993.           Displays your source code as assembler instructions without symbolic 
  2994.           information. 
  2995.  
  2996. Mixed 
  2997.           Displays a line of source code followed by the assembler instructions 
  2998.           for that line of source code. 
  2999.  
  3000. When a source window opens, the New view priority indicates which source window 
  3001. displays, subject to the availability of the source code. You can select the 
  3002. order in which the source windows display. 
  3003.  
  3004. To change the order: 
  3005.  
  3006. o Press and hold mouse button two on the view icon you want to rearrange. 
  3007. o Drag the icon and release mouse button two when you have the icon in its new 
  3008.   location. 
  3009.  
  3010. You can display the source views in the New view priority group box as icons or 
  3011. text. Select the appropriate push button to set the display mode. 
  3012.  
  3013. Old source disposition Group Box 
  3014.  
  3015. In the course of debugging, these selections allow you to control the behavior 
  3016. of source windows from which execution has just left. The Old source 
  3017. disposition controls the behavior of source windows within a thread. 
  3018.  
  3019. The dispositions that the views can take are: 
  3020.  
  3021. Keep 
  3022.           Leaves open the source windows that contain the components and 
  3023.           threads that you select with Display at stop. 
  3024.  
  3025. Iconize 
  3026.           Changes into icons the views that contain the components and threads 
  3027.           that you select with Display at stop. 
  3028.  
  3029. Discard 
  3030.           Disposes of the views that contain the components and threads that 
  3031.           you select with Display at stop. 
  3032.  
  3033. Display at stop Group Box 
  3034.  
  3035. You can control how many source windows are displayed at once. 
  3036.  
  3037. The choices are: 
  3038.  
  3039. Only stopping thread 
  3040.           Keeps, iconizes, or discards all views that are not the stopping 
  3041.           thread. 
  3042.  
  3043. All threads 
  3044.           Keeps, iconizes, or discards the views for old components within each 
  3045.           thread. 
  3046.  
  3047. For example, if you select Only stopping thread, the Old source disposition 
  3048. applies to all of the source windows except the current view of the stopping 
  3049. thread. If you select All threads, the Old source disposition applies only to 
  3050. the source windows for the components from which execution has just left within 
  3051. a thread. 
  3052.  
  3053. Source as notebook 
  3054.  
  3055. You can display your source window in a notebook format if there are include 
  3056. files in the source file. 
  3057.  
  3058. Multiple views 
  3059.  
  3060. You can choose to display more than one source window for a particular source 
  3061. file. The default is not to display multiple source windows. 
  3062.  
  3063. Title bar buttons 
  3064.  
  3065. Enable the Title bar buttons check box if you want the title bar buttons 
  3066. displayed in the window. When enabled, a check mark symbol is shown and the 
  3067. title bar buttons are displayed. If disabled, a check mark symbol is not shown 
  3068. and the title bar buttons do not display in the window. 
  3069.  
  3070. Title bar buttons help 
  3071.  
  3072. Enable the Title bar buttons help check box if you want the title bar buttons 
  3073. hover help displayed in the window. It displays the name of the title bar 
  3074. button in the title bar area whenever you place the mouse pointer on a button. 
  3075. If you drag the mouse pointer across the buttons, the name in the title bar 
  3076. area changes to reflect the button you are on. When enabled, a check mark 
  3077. symbol displays. If disabled, a check mark symbol is not shown and the title 
  3078. bar buttons help does not display in the window. 
  3079.  
  3080. Select the appropriate push button to continue. 
  3081.  
  3082.  
  3083. ΓòÉΓòÉΓòÉ 6.7.5. Monitor Properties Choice ΓòÉΓòÉΓòÉ
  3084.  
  3085. Select the Monitor Properties choice to select the settings for monitoring 
  3086. variables or expressions. 
  3087.  
  3088. When you select Monitor properties, the Monitor Properties window displays. 
  3089.  
  3090.  
  3091. ΓòÉΓòÉΓòÉ 6.7.6. Monitor Properties Window ΓòÉΓòÉΓòÉ
  3092.  
  3093. Use the Monitor Properties window to select the settings for monitoring 
  3094. variables or expressions. You can set the following: 
  3095.  
  3096. o Whether or not the context for variables or expressions displays in the 
  3097.   monitor windows. 
  3098. o The window into which the variable or expression being monitored is placed. 
  3099. o Whether or not the displayed contents of the variable or expression are 
  3100.   updated as the state of the program changes. 
  3101. o For popup expression windows, how long the monitor windows display. 
  3102.  
  3103. After you have selected the settings you want from this window, select one of 
  3104. the push buttons to continue. 
  3105.  
  3106. For a description of the settings that are available from this window, 
  3107. double-click on one of the following topics: 
  3108.  
  3109. o Show context 
  3110. o Monitor location 
  3111. o Enabled 
  3112. o Popup duration. 
  3113.  
  3114.  
  3115. ΓòÉΓòÉΓòÉ 6.7.7. Show context Check Box ΓòÉΓòÉΓòÉ
  3116.  
  3117. Select the Show context check box to display the context for variables or 
  3118. expressions when they are selected for monitoring. 
  3119.  
  3120.  
  3121. ΓòÉΓòÉΓòÉ 6.7.8. Monitor Location Group Box ΓòÉΓòÉΓòÉ
  3122.  
  3123. Choose one of the following radio buttons to select the monitor window that 
  3124. opens when you select a variable or expression to monitor. The selections you 
  3125. can make, and the corresponding windows, are as follows: 
  3126.  
  3127. Popup 
  3128.           Display the variable or expression in a popup expression window. 
  3129.  
  3130. Private monitor 
  3131.           Display the variable or expression in the Private Monitor window. 
  3132.  
  3133. Program monitor 
  3134.           Display the variable or expression in the Program moniotor window. 
  3135.  
  3136. Storage monitor 
  3137.           Display the variable or expression in the Storage window. 
  3138.  
  3139. Related Information 
  3140.  
  3141. o Using the mouse 
  3142. o Selecting Variables with the Mouse and Monitor 
  3143. o Selecting Variables with the Keyboard 
  3144.  
  3145.  
  3146. ΓòÉΓòÉΓòÉ 6.7.9. Enabled Check Box ΓòÉΓòÉΓòÉ
  3147.  
  3148. Select the Enabled check box to update the displayed contents of variables when 
  3149. they are selected for monitoring. 
  3150.  
  3151.  
  3152. ΓòÉΓòÉΓòÉ 6.7.10. Popup Duration ΓòÉΓòÉΓòÉ
  3153.  
  3154. If you select Popup from the Monitor location group box, select one of the 
  3155. following radio buttons to specify how long the popup expression window 
  3156. displays: 
  3157.  
  3158. Step/run 
  3159.           The monitor window closes when the next step command or Run is 
  3160.           executed. 
  3161.  
  3162. New source 
  3163.           The monitor window closes when execution stops in a new source. 
  3164.  
  3165. Permanent 
  3166.           This monitor window is associated with a specific source window and 
  3167.           is closed when the associated source window is closed. 
  3168.  
  3169.  
  3170. ΓòÉΓòÉΓòÉ 6.7.11. PM Debugging Mode Choice ΓòÉΓòÉΓòÉ
  3171.  
  3172. The PM Debugging Mode choice allows to set the debugging mode to asynchronous 
  3173. or synchronous, and control the interaction between the program windows and PM, 
  3174. while the application has stopped executing. 
  3175.  
  3176. When you select PM debugging mode, the PM Debugging Mode window displays. 
  3177.  
  3178.  
  3179. ΓòÉΓòÉΓòÉ 6.7.11.1. PM Debugging Mode Window ΓòÉΓòÉΓòÉ
  3180.  
  3181. Use the PM Debugging Mode window to set the debugging mode to asynchronous or 
  3182. synchronous, and control the interaction between the program windows and PM, 
  3183. while the application has stopped executing. 
  3184.  
  3185. The Presentation Manager system is a message-based system. As program events 
  3186. are encountered by Presentation Manager programs, the programs communicate with 
  3187. each other by passing messages and by receiving user input through input 
  3188. messages. When a Presentation Manager program encounters an enabled breakpoint, 
  3189. the input queue can become blocked and dependent program events, or processes, 
  3190. can also become blocked as a result. For example, the input queue can become 
  3191. blocked when your program stops at a breakpoint that has been triggered by an 
  3192. input event. 
  3193.  
  3194. The debugger provides two modes of operation by which Presentation Manager 
  3195. messages can be processed while the debugger has control. 
  3196.  
  3197. Debugging mode Group Box 
  3198.  
  3199. Select one of the following Presentation Manager debugging modes: 
  3200.  
  3201. o Synchronous 
  3202. o Asynchronous. 
  3203.  
  3204. Program windows Group Box 
  3205.  
  3206. Select one of the following to select how you want the windows painted. 
  3207.  
  3208. No painting Radio Button 
  3209.  
  3210. Enable this option if you want none of the invalid areas of the window are 
  3211. repainted. 
  3212.  
  3213. Color invalid areas Radio Button 
  3214.  
  3215. The Color invalid areas option works only in asynchronous mode. Enable this 
  3216. option if you want the invalid areas painted in a solid fill color. The color 
  3217. can be changed by selecting a different color from the Invalid area color 
  3218. combination box. 
  3219.  
  3220. Restore Radio Button 
  3221.  
  3222. The Restore option works only in asynchronous mode. Enable this option if you 
  3223. want to restore the application window with the last available image of the 
  3224. window. The image that you can regain consists of the last available image when 
  3225. a step or run command ended, minus any parts of the window that were covered 
  3226. when the step or run command ended. The parts of the window that were covered 
  3227. are filled with the solid color you chose from the Invalid area color 
  3228. combination box. 
  3229.  
  3230. Repaint Radio Button 
  3231.  
  3232. Enable this option if you want to restore the application window with the last 
  3233. available image. The image that you can regain consists of the last available 
  3234. image when a step or run command ended minus any parts of the window that were 
  3235. covered when the step or run command ended. The parts of the window that were 
  3236. covered are filled with the solid color you chose from the Invalid area color 
  3237. combination box. 
  3238.  
  3239. The Repaint option differs from the Restore option. It interrupts the normal 
  3240. debugging process of the window as follows: 
  3241.  
  3242. o The program windows will not receive any screen interaction messages while 
  3243.   the application is stopped. For example, the application will not receive any 
  3244.   of the WM_MOUSEMOVE or WM_PAINT messages that were generated while the 
  3245.   application was stopped. 
  3246. o An extra WM_PAINT message is generated for the program windows when execution 
  3247.   resumes. 
  3248.  
  3249.   Note:  The program windows might not process the WM_PAINT message depending 
  3250.   on where the breakpoints are set or on which step or run command was 
  3251.   selected. 
  3252.  
  3253. Invalid area color Group Box 
  3254.  
  3255. Select the color that is to be used to repaint the invalid area of an 
  3256. application window. Depending on the original color of the application window, 
  3257. certain colors will be more appropriate for repainting. The color you choose is 
  3258. used when you select the Color invalid areas, Restore, or Repaint options. 
  3259.  
  3260. After you have selected the parameters you want from this window, click on the 
  3261. appropriate push buttons. 
  3262.  
  3263.  
  3264. ΓòÉΓòÉΓòÉ 6.7.12. Default Data Representation Cascading Choice ΓòÉΓòÉΓòÉ
  3265.  
  3266. When you select Default data representation, a cascaded menu displays with 
  3267. language choices.  This lets you change the default representation for a data 
  3268. type in the language that you select. 
  3269.  
  3270.  
  3271. ΓòÉΓòÉΓòÉ 6.7.12.1. Language Choices ΓòÉΓòÉΓòÉ
  3272.  
  3273. Select a language to change the default representation of the selected data 
  3274. type. For example, you can change the default representation for an integer in 
  3275. the C language from decimal to hexadecimal. 
  3276.  
  3277. When you select the System choice, the Default Representation window displays. 
  3278.  
  3279.  
  3280. ΓòÉΓòÉΓòÉ 6.7.12.2. System Choice ΓòÉΓòÉΓòÉ
  3281.  
  3282. Select the System choice to change the default representation of the math 
  3283. coprocessor registers. This choice is language independent. 
  3284.  
  3285. When you select the System choice, the Default Representation window displays. 
  3286.  
  3287.  
  3288. ΓòÉΓòÉΓòÉ 6.7.12.2.1. Default Representation Window ΓòÉΓòÉΓòÉ
  3289.  
  3290. Use the Default Representation window to select how you want your data 
  3291. represented in the monitor windows. For example, you can change the default 
  3292. representation for an integer in the C language from decimal to hexadecimal. 
  3293.  
  3294. You can change the representation of the value displayed in a monitor to: 
  3295.  
  3296. o Hexadecimal 
  3297. o Decimal 
  3298. o String 
  3299. o Character 
  3300. o Floating-point 
  3301. o Hexadecimal pointer 
  3302. o Decimal pointer 
  3303. o Array. 
  3304.  
  3305. Note:  The representation you can select varies with the data type being 
  3306. displayed. 
  3307.  
  3308. Select the appropriate radio button for the data type you want. 
  3309.  
  3310. Select the appropriate push button to continue. 
  3311.  
  3312.  
  3313. ΓòÉΓòÉΓòÉ 6.7.13. Exception Filtering Choice ΓòÉΓòÉΓòÉ
  3314.  
  3315. When you select Exception filtering, the Exception Filtering window displays. 
  3316. From this window, you select the exceptions that you want the debugger to 
  3317. recognize. 
  3318.  
  3319.  
  3320. ΓòÉΓòÉΓòÉ 6.7.13.1. Exception Filtering Window ΓòÉΓòÉΓòÉ
  3321.  
  3322. Use the Exception Filtering window to select exceptions that you want the 
  3323. debugger to recognize. 
  3324.  
  3325. To highlight an exception: 
  3326.  
  3327. o Select the exception by clicking on the name. It becomes highlighted. 
  3328. o Select the OK push button. 
  3329.  
  3330. If a highlighted exception is encountered during the execution of your program, 
  3331. the Exception window is displayed. Any other exceptions that are encountered 
  3332. are ignored. 
  3333.  
  3334. Select the appropriate push button to continue. 
  3335.  
  3336. For details on the OS/2 exception definitions listed in this window, refer to 
  3337. the Control Program Programming Reference (S10G-6263-00). The Software 
  3338. exception will not be listed, since this is a user-defined OS/2 exception 
  3339. generated by the DosRaiseException call. 
  3340.  
  3341.  
  3342. ΓòÉΓòÉΓòÉ 6.7.14. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  3343.  
  3344. Select the Save window positions and sizes choice to save the position and size 
  3345. of each type of debugger window currently open. Type refers to the different 
  3346. windows such as Registers, Storage, and so on. 
  3347.  
  3348. When you select this choice, the window positions are saved and any new windows 
  3349. will display in the saved positions. 
  3350.  
  3351.  
  3352. ΓòÉΓòÉΓòÉ 6.7.15. Autosave Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  3353.  
  3354. Select the Autosave window positions and sizes choice to enable automatic 
  3355. saving of window positions and sizes for each type of debugger window currently 
  3356. open. Type refers to the different windows such as Registers, Storage, and so 
  3357. on. 
  3358.  
  3359. When you enable this choice, the window positions and sizes are automatically 
  3360. saved when you move or resize a window. When you close the debugging session 
  3361. and start another session the positions and sizes that you selected are 
  3362. displayed in the new session. 
  3363.  
  3364. Alternatively, you may save the window positions and sizes by positioning the 
  3365. debugger windows on the desktop and selecting the Save window positions and 
  3366. sizes choice. 
  3367.  
  3368.  
  3369. ΓòÉΓòÉΓòÉ 6.7.16. Program Profiles Choice ΓòÉΓòÉΓòÉ
  3370.  
  3371. Select the Program profiles cascading choice to specify if you want to enable 
  3372. program profiling, delete program profiles, or change the location where the 
  3373. program profiles are stored. 
  3374.  
  3375. Menu Summary 
  3376.  
  3377. Enable program profiling 
  3378.           Enable or disable the use of program profiles. 
  3379.  
  3380. Delete 
  3381.           Delete program profiles that have been saved for a program that you 
  3382.           have previously debugged. 
  3383.  
  3384. Change location 
  3385.           Change the directory where all the program profiles are stored. 
  3386.  
  3387.  
  3388. ΓòÉΓòÉΓòÉ 6.7.16.1. Enable Program Profiling Choice ΓòÉΓòÉΓòÉ
  3389.  
  3390. Select the Enable program profiling choice to enable or disable the use of 
  3391. program profiles.  When debugging a program more than once, this will restore 
  3392. the breakpoints, source windows and monitors to the same state as when last 
  3393. debugged. 
  3394.  
  3395. When it is enabled, a check mark symbol displays. If it is disabled, a check 
  3396. mark symbol is not displayed. 
  3397.  
  3398.  
  3399. ΓòÉΓòÉΓòÉ 6.7.16.2. Change Location Choice ΓòÉΓòÉΓòÉ
  3400.  
  3401. Select the Change location choice to specify where you want the program 
  3402. profiles stored. 
  3403.  
  3404. The default location for the program profiles is as follows: 
  3405.  
  3406.    C:\OS2\
  3407.  
  3408. Where C: is your OS/2 boot drive. 
  3409.  
  3410. When you select Change location, the Change Location window displays. 
  3411.  
  3412.  
  3413. ΓòÉΓòÉΓòÉ 6.7.16.2.1. Change Location Window ΓòÉΓòÉΓòÉ
  3414.  
  3415. Use the Change Location window to specify the directory where you want the 
  3416. program profiles saved. 
  3417.  
  3418. The default location for the program profiles is as follows: 
  3419.  
  3420.    C:\OS2\
  3421.  
  3422. Where C: is your OS/2 boot drive. 
  3423.  
  3424. To use the Change Location window, do the following: 
  3425.  
  3426.  1. Type the full path name of the directory where you want the debugger 
  3427.     profile information file stored in the Path entry field. 
  3428.  
  3429.  2. Select the appropriate push button to continue. 
  3430.  
  3431. Note:  Any existing program profiles will be moved to the new directory that 
  3432. you specified. 
  3433.  
  3434.  
  3435. ΓòÉΓòÉΓòÉ 6.7.16.3. Delete Choice ΓòÉΓòÉΓòÉ
  3436.  
  3437. Select the Delete choice to delete the program profiles which for programs that 
  3438. have been previously debugged. 
  3439.  
  3440. When you select Delete, the Delete window displays. 
  3441.  
  3442.  
  3443. ΓòÉΓòÉΓòÉ 6.7.16.3.1. Delete Window ΓòÉΓòÉΓòÉ
  3444.  
  3445. Use the Delete window to delete program profiles for a program that you have 
  3446. previously debugged. 
  3447.  
  3448. To delete program profiles: 
  3449.  
  3450.  1. Select the path name and file name of the program whose program profiles 
  3451.     you want to delete. 
  3452.  
  3453.  2. Select the Delete push button. 
  3454.  
  3455.     Note:  You can delete program profiles to lessen the storage space required 
  3456.     by the debugger files. 
  3457.  
  3458.  
  3459. ΓòÉΓòÉΓòÉ 6.7.17. Control Choice ΓòÉΓòÉΓòÉ
  3460.  
  3461. Select the Control choice to display the Control window. 
  3462.  
  3463.  
  3464. ΓòÉΓòÉΓòÉ 6.8. Project Menu ΓòÉΓòÉΓòÉ
  3465.  
  3466. When you start the debugger from within the WorkFrame/2 environment, additional 
  3467. tool support is provided.  A new menu item is added to the Source window called 
  3468. Project. 
  3469.  
  3470. Select choices from the Project menu to open other tools such as an editor, 
  3471. browser, or the compiler. This menu is only available from the Source window. 
  3472.  
  3473. This feature also provides context sensitive help. This help becomes available 
  3474. when you select a string, using the mouse pointer, and press and hold down 
  3475. Ctrl+H. If you place the mouse pointer on a space in the Source window and 
  3476. double-click, an editor opens to the corresponding source line that you 
  3477. selected. 
  3478.  
  3479. Notes 
  3480.  
  3481. o This menu is only available if you started the debugger within the 
  3482.   WorkFrame/2 environment. 
  3483. o If you are debugging a Presentation Manager application, the PM debugging 
  3484.   mode should be asynchronous. 
  3485.  
  3486. Menu Summary 
  3487.  
  3488. Edit 
  3489.           Display the system editor. 
  3490.  
  3491. Browse 
  3492.           Display classes, functions, members, inheritance and include files. 
  3493.  
  3494.  
  3495. ΓòÉΓòÉΓòÉ 6.8.1. Edit Choice ΓòÉΓòÉΓòÉ
  3496.  
  3497. Select the Edit choice to open the system editor. 
  3498.  
  3499.  
  3500. ΓòÉΓòÉΓòÉ 6.8.2. Browser Choice ΓòÉΓòÉΓòÉ
  3501.  
  3502. Select the Browse cascading choice to view classes, functions, members, 
  3503. inheritance and include files. 
  3504.  
  3505. List all classes 
  3506.           Display a list of classes. 
  3507.  
  3508. List all functions 
  3509.           Display a list of functions. 
  3510.  
  3511. List members 
  3512.           Display a list of class members. 
  3513.  
  3514. Graph inheritance 
  3515.           Display an inheritance graph. 
  3516.  
  3517. Graph include files 
  3518.           Display a graph that shows the include files. 
  3519.  
  3520. Graph classes 
  3521.           Display a graph that shows classes. 
  3522.  
  3523.  
  3524. ΓòÉΓòÉΓòÉ 6.8.3. List All Classes Choice ΓòÉΓòÉΓòÉ
  3525.  
  3526. Select the List all classes choice to view a list of the classes. 
  3527.  
  3528.  
  3529. ΓòÉΓòÉΓòÉ 6.8.4. List All Functions Choice ΓòÉΓòÉΓòÉ
  3530.  
  3531. Select the List all functions choice to view a list of the functions. 
  3532.  
  3533.  
  3534. ΓòÉΓòÉΓòÉ 6.8.5. List Members Choice ΓòÉΓòÉΓòÉ
  3535.  
  3536. Select the List members choice to view a list of the members. 
  3537.  
  3538.  
  3539. ΓòÉΓòÉΓòÉ 6.8.6. Graph Inheritance Choice ΓòÉΓòÉΓòÉ
  3540.  
  3541. Select the Graph inheritance choice to view an inheritance graph. 
  3542.  
  3543.  
  3544. ΓòÉΓòÉΓòÉ 6.8.7. Graph Include Files Choice ΓòÉΓòÉΓòÉ
  3545.  
  3546. Select the Graph include files choice to view a graph containing the include 
  3547. files. 
  3548.  
  3549.  
  3550. ΓòÉΓòÉΓòÉ 6.8.8. Graph Classes Choice ΓòÉΓòÉΓòÉ
  3551.  
  3552. Select the Graph classes choice to view a graph containing the classes. 
  3553.  
  3554.  
  3555. ΓòÉΓòÉΓòÉ 6.9. Help Menu ΓòÉΓòÉΓòÉ
  3556.  
  3557. Select choices from the Help menu to complement the online help information 
  3558. that you can get for the debugger when you press F1 or select the Help push 
  3559. button. 
  3560.  
  3561. Menu Summary 
  3562.  
  3563. Help index 
  3564.           An alphabetical index of all available debugger help topics. 
  3565.  
  3566. General help 
  3567.           Help information for the active window. 
  3568.  
  3569. Using help 
  3570.           How to use the help facility. 
  3571.  
  3572. How do I 
  3573.           Display the debugger task help. 
  3574.  
  3575. IBM VisualAge C++ for OS/2 Help Menu Choices 
  3576.           Launches the IBM VisualAge C++ for OS/2 documentation associated with 
  3577.           the menu item. This is only available when starting the debugger from 
  3578.           the WorkFrame/2 environment. 
  3579.  
  3580. Product information 
  3581.           Display product information. 
  3582.  
  3583.  
  3584. ΓòÉΓòÉΓòÉ 6.9.1. Help Index Choice ΓòÉΓòÉΓòÉ
  3585.  
  3586. Select the Help index choice display an alphabetical list of index topics for 
  3587. the debugger. Use the Find choice provided with the online help facility to 
  3588. locate topics in the index. 
  3589.  
  3590.  
  3591. ΓòÉΓòÉΓòÉ 6.9.2. General Help Choice ΓòÉΓòÉΓòÉ
  3592.  
  3593. Select the General help choice to display online help for the active debugger 
  3594. window. The online help panel displayed is the same panel that displays when 
  3595. you place your cursor inside the window and press F1. 
  3596.  
  3597.  
  3598. ΓòÉΓòÉΓòÉ 6.9.3. Using Help Choice ΓòÉΓòÉΓòÉ
  3599.  
  3600. Select the Using help choice to display online help information about the 
  3601. OS/2help facility. 
  3602.  
  3603.  
  3604. ΓòÉΓòÉΓòÉ 6.9.4. How do I Choice ΓòÉΓòÉΓòÉ
  3605.  
  3606. Select the How do I choice to display the online task help. This lists tasks 
  3607. that you may want to do and instructions on how to complete these tasks. 
  3608.  
  3609.  
  3610. ΓòÉΓòÉΓòÉ 6.9.5. IBM VisualAge C++ for OS/2 Help Menu Choices ΓòÉΓòÉΓòÉ
  3611.  
  3612. The central portion of the Help menu is dedicated to all the online 
  3613. documentation that is shipped with IBM VisualAge C++ for OS/2. Making a 
  3614. selection from any of these cascade menus launches the IBM VisualAge C++ for 
  3615. OS/2 documentation associated with the menu item. You can find the same 
  3616. documentation in the Information folder found in the IBM VisualAge C++ for OS/2 
  3617. Desktop folder. 
  3618.  
  3619. The cascade menus are organized as follows: 
  3620.  
  3621. At a Glance  
  3622.           Provides general information on using IBM VisualAge C++ for OS/2, 
  3623.           such as what is new in this release, the overall tutorial, a 
  3624.           description of all the sample programs, and answers to frequently 
  3625.           asked questions. 
  3626.  
  3627. Using IBM VisualAge C++ for OS/2  
  3628.           Provides direct access to the individual sections of the User's 
  3629.           Guide. For example, if you are using the Browser, you would look in 
  3630.           the Browsing section for more information. 
  3631.  
  3632. How Do I... Selections  
  3633.           Provides access to the How Do I... information for each component of 
  3634.           IBM VisualAge C++ for OS/2. Use How Do I... information to find out 
  3635.           how to perform common tasks within IBM VisualAge C++ for OS/2. 
  3636.  
  3637. C/C++  
  3638.           Provides access to the information that is specific to programming in 
  3639.           C and C++. 
  3640.  
  3641. Class Libraries  
  3642.           Provides access to the IBM VisualAge C++ for OS/2 Open Class Library 
  3643.           documentation. 
  3644.  
  3645. Visual Programming  
  3646.           Provides access to the information that is specific to creating your 
  3647.           programs visually. 
  3648.  
  3649. OS/2, PM, and Graphics  
  3650.           Provides access to the documentation for the key aspects of OS/2, 
  3651.           Presentation Manager, and graphics programming. 
  3652.  
  3653. IPF, REXX, and Editing  
  3654.           Provides access to the IPF, REXX and Editor references. 
  3655.  
  3656. SOM and WorkPlace Shell  
  3657.           Provides access to the information specific to SOM and the WorkPlace 
  3658.           Shell. 
  3659.  
  3660. Multimedia  
  3661.           Provides access to the information that is specific to creating 
  3662.           multimedia applications. 
  3663.  
  3664.  
  3665. ΓòÉΓòÉΓòÉ <hidden> Product information ΓòÉΓòÉΓòÉ
  3666.  
  3667. Select the Product information choice to display the product information. 
  3668.  
  3669.  
  3670. ΓòÉΓòÉΓòÉ 7. Registers Window ΓòÉΓòÉΓòÉ
  3671.  
  3672. Registers Window 
  3673.  
  3674. Use the Registers window to view or modify the contents of the registers 
  3675. monitored for your program. One set of processor registers exists for each 
  3676. thread. 
  3677.  
  3678. In the Registers window, floating-point registers display as floating-point 
  3679. decimal numbers or as hexadecimal. They are updated based on the current 
  3680. representation. 
  3681.  
  3682. Menu Bar Summary 
  3683.  
  3684. File 
  3685.           End your debugging session. 
  3686.  
  3687. Options 
  3688.           Change the font used for the text in the Registers window. 
  3689.  
  3690. Windows 
  3691.           Display the active debugger windows. 
  3692.  
  3693. Help 
  3694.           Display online help that compliments the information you get when you 
  3695.           press F1 or select a Help push button. 
  3696.  
  3697. Related Information 
  3698.  
  3699. o Expression Language Guidelines 
  3700.  
  3701.  
  3702. ΓòÉΓòÉΓòÉ 7.1. Options Menu ΓòÉΓòÉΓòÉ
  3703.  
  3704. Select the Options menu to change the fonts used for the text in the Registers 
  3705. window, set debugger options, and end the debugging session. 
  3706.  
  3707. Menu Summary 
  3708.  
  3709. Fonts 
  3710.           Change the fonts for the text in the Registers window. 
  3711.  
  3712.  
  3713. ΓòÉΓòÉΓòÉ 7.1.1. Fonts Choice ΓòÉΓòÉΓòÉ
  3714.  
  3715. Select the Fonts choice to set the font you want to use for the text that 
  3716. displays in the Register window. 
  3717.  
  3718. When you select Fonts, a Fonts window displays. 
  3719.  
  3720.  
  3721. ΓòÉΓòÉΓòÉ 7.1.2. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  3722.  
  3723. Select the Where is execution point choice to locate the next line to be 
  3724. executed in the thread. 
  3725.  
  3726.  
  3727. ΓòÉΓòÉΓòÉ 7.1.3. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  3728.  
  3729. Select the Save window positions and sizes choice to save the position of all 
  3730. debugger windows. 
  3731.  
  3732. When you select this choice, the window positions are saved and the windows 
  3733. display in the selected positions. 
  3734.  
  3735. Note:  You do not need to save program profile for this choice to 
  3736.  
  3737.  
  3738. ΓòÉΓòÉΓòÉ 7.1.4. Control Choice ΓòÉΓòÉΓòÉ
  3739.  
  3740. Select the Control choice to display the Control window. 
  3741.  
  3742.  
  3743. ΓòÉΓòÉΓòÉ 7.1.5. Close Debugger Choice ΓòÉΓòÉΓòÉ
  3744.  
  3745. Select the Close debugger choice to close your current debugging session. 
  3746.  
  3747. When you select the Close debugger choice, a message box prompts you to confirm 
  3748. that you want to end the debugging session. 
  3749.  
  3750.  
  3751. ΓòÉΓòÉΓòÉ 7.2. Windows Menu ΓòÉΓòÉΓòÉ
  3752.  
  3753. Select the Windows menu to display a list of all the open debugger windows. By 
  3754. selecting a window from the Windows menu, it is brought into focus and made the 
  3755. active window. Also, if the window is minimized, it is restored. 
  3756.  
  3757.  
  3758. ΓòÉΓòÉΓòÉ 7.2.1. Windows Choices ΓòÉΓòÉΓòÉ
  3759.  
  3760. Select this choice to make the window active. By selecting this choice, the 
  3761. window is brought into focus and made the active window. Also, if the window is 
  3762. minimized, it is restored. 
  3763.  
  3764.  
  3765. ΓòÉΓòÉΓòÉ 7.3. Help Menu ΓòÉΓòÉΓòÉ
  3766.  
  3767. Select choices from the Help menu to complement the online help information 
  3768. that you can get for the debugger when you press F1 or select the Help push 
  3769. button. 
  3770.  
  3771.  Menu Summary 
  3772.  
  3773. Help index 
  3774.           An alphabetical index of all available debugger help topics. 
  3775.  
  3776. General help 
  3777.           Help information for the active window. 
  3778.  
  3779. Using help 
  3780.           How to use the help facility. 
  3781.  
  3782.  
  3783. ΓòÉΓòÉΓòÉ 7.3.1. Help Index Choice ΓòÉΓòÉΓòÉ
  3784.  
  3785. Select the Index choice display an alphabetical list of index topics for the 
  3786. debugger. Use the Find choice provided with the online help facility to locate 
  3787. topics in the index. 
  3788.  
  3789.  
  3790. ΓòÉΓòÉΓòÉ 7.3.2. General Help Choice ΓòÉΓòÉΓòÉ
  3791.  
  3792. Select the General help choice to display online help for the active debugger 
  3793. window. The online help panel displayed is the same panel that displays when 
  3794. you place your cursor inside the window and press F1. 
  3795.  
  3796.  
  3797. ΓòÉΓòÉΓòÉ 7.3.3. Using Help Choice ΓòÉΓòÉΓòÉ
  3798.  
  3799. Select the Using help choice to display online help information about the 
  3800. OS/2help facility. 
  3801.  
  3802.  
  3803. ΓòÉΓòÉΓòÉ 8. Call Stack Window ΓòÉΓòÉΓòÉ
  3804.  
  3805. Call Stack Window 
  3806.  
  3807. The Call Stack window lists all of the active functions for a particular 
  3808. thread, including Presentation Manager calls. The functions display in the 
  3809. order that they were called. 
  3810.  
  3811. Each Call Stack window displays call stack information for one thread only. 
  3812. When the state of the program changes, such as when you execute the program or 
  3813. you update displayed data, the Call Stack window changes to reflect the current 
  3814. state. You can double-click on any call stack entry to display the source code 
  3815. for that entry. The line that calls the next call stack entry is highlighted. 
  3816. The remaining call stack size shows the bytes left in the stack for the thread. 
  3817.  
  3818. Menu Bar Summary 
  3819.  
  3820. File 
  3821.           End your debugging session. 
  3822.  
  3823. Options 
  3824.           Select the font you want to use for the text in the Call Stack window 
  3825.           and select the parameters that control how the items on the call 
  3826.           stack display. 
  3827.  
  3828. Windows 
  3829.           Display the active debugger windows. 
  3830.  
  3831. Help 
  3832.           Display online help that compliments the information you get when you 
  3833.           press F1 or select a Help push button. 
  3834.  
  3835.  
  3836. ΓòÉΓòÉΓòÉ 8.1. File Menu ΓòÉΓòÉΓòÉ
  3837.  
  3838. Select the File menu choice to end your debugging session. 
  3839.  
  3840. Menu Summary 
  3841.  
  3842. Close debugger 
  3843.           End your debugging session. 
  3844.  
  3845.  
  3846. ΓòÉΓòÉΓòÉ 8.1.1. Close Debugger Choice ΓòÉΓòÉΓòÉ
  3847.  
  3848. Select the Close debugger choice to close your current debugging session. 
  3849.  
  3850. When you select the Close debugger choice, a message box prompts you to confirm 
  3851. that you want to end the debugging session. 
  3852.  
  3853.  
  3854. ΓòÉΓòÉΓòÉ 8.2. Options Menu ΓòÉΓòÉΓòÉ
  3855.  
  3856. Select the Options menu choice to control how the items display in the window. 
  3857.  
  3858. Menu Summary 
  3859.  
  3860. Display style 
  3861.           Control how the items on the call stack are displayed. 
  3862.  
  3863. Fonts 
  3864.           Select the font you want to use for the text in the Call Stack 
  3865.           window. 
  3866.  
  3867.  
  3868. ΓòÉΓòÉΓòÉ 8.2.1. Display Style Choice ΓòÉΓòÉΓòÉ
  3869.  
  3870. Select the Display style choice to control how the items on the call stack 
  3871. display. You can select the type of information you want displayed for all of 
  3872. the call stack items and you can choose to display new call stack items on the 
  3873. top or the bottom of the stack. 
  3874.  
  3875. When you select Display style, the Display Style window displays. 
  3876.  
  3877.  
  3878. ΓòÉΓòÉΓòÉ 8.2.1.1. Display Style Window ΓòÉΓòÉΓòÉ
  3879.  
  3880. Use the Display Style window to control how the items on the call stack 
  3881. display. You can select the type of descriptive information you want to display 
  3882. for all of the call stack items. You can also choose to display new call stack 
  3883. items on the top or the bottom of the stack. 
  3884.  
  3885. To change how call stack items display: 
  3886.  
  3887.  1. Select one or more of the items under Columns to select the information you 
  3888.     want to display for each call stack entry. Each item causes a new column to 
  3889.     be added to the Call Stack window. 
  3890.  
  3891.     The following items are available: 
  3892.  
  3893.    Entry No. 
  3894.              Represents the position of the call stack item in the list. Entry 
  3895.              level 1 is the first function invoked. 
  3896.  
  3897.    Function 
  3898.              Lists program name or the address of the function call that 
  3899.              created the new call stack entry. 
  3900.  
  3901.    Source 
  3902.              Lists the component name that contains the function. The name 
  3903.              displayed corresponds with a name listed in the Components list 
  3904.              box in the Control window. 
  3905.  
  3906.    Address 
  3907.              The address represents where execution will return in that 
  3908.              function. 
  3909.  
  3910.    Recursion 
  3911.              Lists the recursion level. 0 is the first invocation. 
  3912.  
  3913.    EBP 
  3914.              Start of the call stack frame for that function. 
  3915.  
  3916.    ESP 
  3917.              End of the call stack frame for that function. 
  3918.  
  3919.    Size 
  3920.              Size of the call stack frame for that function. 
  3921.  
  3922.  2. Select one of the following Growth direction radio buttons to determine how 
  3923.     new items are displayed on the call stack. 
  3924.  
  3925.    Up 
  3926.              Displays new items at the top of the Call Stack window. 
  3927.  
  3928.    Down 
  3929.              Displays new items at the bottom of the Call Stack window. 
  3930.  
  3931.  3. Select one of the push buttons to continue. 
  3932.  
  3933.  
  3934. ΓòÉΓòÉΓòÉ 8.2.2. Fonts Choice ΓòÉΓòÉΓòÉ
  3935.  
  3936. Select the Fonts choice to set the font you want to use for the text that 
  3937. displays in the Call Stack window. 
  3938.  
  3939.  
  3940. ΓòÉΓòÉΓòÉ 8.3. Windows Menu ΓòÉΓòÉΓòÉ
  3941.  
  3942. Select the Windows menu to display a list of all the open debugger windows. By 
  3943. selecting a window from the Windows menu, it is brought into focus and made the 
  3944. active window. Also, if the window is minimized, it is restored. 
  3945.  
  3946.  
  3947. ΓòÉΓòÉΓòÉ 8.3.1. Windows Choices ΓòÉΓòÉΓòÉ
  3948.  
  3949. Select this choice to make the window active. By selecting this choice, the 
  3950. window is brought into focus and made the active window. Also, if the window is 
  3951. minimized, it is restored. 
  3952.  
  3953.  
  3954. ΓòÉΓòÉΓòÉ 8.4. Help Menu ΓòÉΓòÉΓòÉ
  3955.  
  3956. Select choices from the Help menu to complement the online help information 
  3957. that you can get for the debugger when you press F1 or, if available, select 
  3958. the Help push button. 
  3959.  
  3960. Menu Summary 
  3961.  
  3962. Help index 
  3963.           An alphabetical index of all available debugger help topics. 
  3964.  
  3965. General help 
  3966.           Help information for the active window. 
  3967.  
  3968. Using help 
  3969.           How to use the help facility. 
  3970.  
  3971.  
  3972. ΓòÉΓòÉΓòÉ 8.4.1. Help Index Choice ΓòÉΓòÉΓòÉ
  3973.  
  3974. Select the Index choice display an alphabetical list of index topics for the 
  3975. debugger. Use the Find choice provided with the online help facility to locate 
  3976. topics in the index. 
  3977.  
  3978.  
  3979. ΓòÉΓòÉΓòÉ 8.4.2. General Help Choice ΓòÉΓòÉΓòÉ
  3980.  
  3981. Select the General help choice to display online help for the active debugger 
  3982. window. The online help panel displayed is the same panel that displays when 
  3983. you place your cursor inside the window and press F1. 
  3984.  
  3985.  
  3986. ΓòÉΓòÉΓòÉ 8.4.3. Using Help Choice ΓòÉΓòÉΓòÉ
  3987.  
  3988. Select the Using help choice to display online help information about the 
  3989. OS/2help facility. 
  3990.  
  3991.  
  3992. ΓòÉΓòÉΓòÉ 9. Local Variables Window ΓòÉΓòÉΓòÉ
  3993.  
  3994. Local Variables Window 
  3995.  
  3996. The Local Variables window displays the local variables for the current 
  3997. execution point in a given thread. As execution moves from function to 
  3998. function, the window updates with the new local variables. 
  3999.  
  4000. Note:  When your program returns from a called function, the data display 
  4001. options you previously selected (for example, representation) are lost. If you 
  4002. want to save these display options, monitor the variable or expression in a 
  4003. Private Monitor window, the Monitor Expression window, or a popup expression 
  4004. window. 
  4005.  
  4006. To monitor only specific variables or expressions, instead of all the local 
  4007. variables of a function, use the Monitor Expression window. 
  4008.  
  4009.  Menu Bar Summary 
  4010.  
  4011. File 
  4012.           End your debugging session. 
  4013.  
  4014. Edit 
  4015.           Select or delete variables. 
  4016.  
  4017. Options 
  4018.           Control how the contents of variables display. 
  4019.  
  4020. Windows 
  4021.           Displays the active debugger windows. 
  4022.  
  4023. Help 
  4024.           Displays online help that compliments the information you get when 
  4025.           you press F1 or select a Help push button. 
  4026.  
  4027. Shortcut Keys 
  4028.  
  4029. The following shortcut keys are available from the Local Variables window: 
  4030.  
  4031. Close debugger                  F3 
  4032. Delete                          Delete 
  4033. Select all                      Ctrl+/ 
  4034. Deselect all                    Ctrl+\ 
  4035.  
  4036. Related Information 
  4037.  
  4038. o Monitor Properties 
  4039. o Monitor Expression Window 
  4040. o Private Monitor Window 
  4041. o Popup Expression Window 
  4042.  
  4043.  
  4044. ΓòÉΓòÉΓòÉ 9.1. Edit Menu ΓòÉΓòÉΓòÉ
  4045.  
  4046. Select choices from the Edit menu to delete, select, and deselect expressions. 
  4047.  
  4048.  Menu Summary 
  4049.  
  4050. Delete 
  4051.           Delete all the selected expressions. 
  4052.  
  4053. Select all 
  4054.           Select all expressions. 
  4055.  
  4056. Deselect all 
  4057.           Deselect all expressions. 
  4058.  
  4059.  
  4060. ΓòÉΓòÉΓòÉ 9.1.1. Delete Choice ΓòÉΓòÉΓòÉ
  4061.  
  4062. Select the Delete choice to delete variables or expressions that are being 
  4063. monitored from a monitor window. 
  4064.  
  4065. To delete a variable or expression from a monitor window: 
  4066.  
  4067.  1. Select the variable or expression with your mouse. The monitor for the 
  4068.     variable or expression highlights. 
  4069.  
  4070.  2. Select the Delete choice from the Options menu. 
  4071.  
  4072.  
  4073. ΓòÉΓòÉΓòÉ 9.1.2. Select All Choice ΓòÉΓòÉΓòÉ
  4074.  
  4075. Select the Select all choice to select all the expressions in the window. 
  4076.  
  4077.  
  4078. ΓòÉΓòÉΓòÉ 9.1.3. Deselect All Choice ΓòÉΓòÉΓòÉ
  4079.  
  4080. Select the Deselect all choice to cancel the selection of all the expressions 
  4081. in the window. 
  4082.  
  4083.  
  4084. ΓòÉΓòÉΓòÉ 9.1.4. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  4085.  
  4086. Select the Where is execution point choice to locate the next line to be 
  4087. executed in the thread. 
  4088.  
  4089.  
  4090. ΓòÉΓòÉΓòÉ 9.1.5. Close Debugger Choice ΓòÉΓòÉΓòÉ
  4091.  
  4092. Select the Close debugger choice to close the current debugging session. 
  4093.  
  4094. When you select the Close debugger choice, a message box prompts you to confirm 
  4095. that you want to end the debugging session. 
  4096.  
  4097.  
  4098. ΓòÉΓòÉΓòÉ 9.2. Options Menu ΓòÉΓòÉΓòÉ
  4099.  
  4100. Select choices from the Options menu to control how the contents of variables 
  4101. display and to set the debugger options. 
  4102.  
  4103.  Menu Summary 
  4104.  
  4105. Representation 
  4106.           Display the contents of a monitored variable in a different format. 
  4107.  
  4108. Show context 
  4109.           Display the contextual information for all selected expressions. 
  4110.  
  4111. Hide context 
  4112.           Prevent the display of contextual information for all selected 
  4113.           expressions. 
  4114.  
  4115. Fonts 
  4116.           Select the font you want to use for the text in the Local Variables 
  4117.           window. 
  4118.  
  4119.  
  4120. ΓòÉΓòÉΓòÉ 9.2.1. Fonts Choice ΓòÉΓòÉΓòÉ
  4121.  
  4122. Select the Fonts choice to set the font you want to use for the text that 
  4123. displays in the Local Variables window. 
  4124.  
  4125.  
  4126. ΓòÉΓòÉΓòÉ 9.2.2. Representation Cascading Choice ΓòÉΓòÉΓòÉ
  4127.  
  4128. Select the Representation cascading choice to display the contents of the 
  4129. variable in a new representation. The types of representation that display on 
  4130. the menu depend on the data type of the variable you are monitoring. 
  4131.  
  4132. The following are possible representations: 
  4133.  
  4134. Hexadecimal 
  4135.           Displays the contents of the monitored variable in hexadecimal 
  4136.           notation. 
  4137.  
  4138. Decimal 
  4139.           Displays the contents of the monitored variable in decimal notation. 
  4140.  
  4141. String 
  4142.           Displays the contents of the monitored variable as a character 
  4143.           string. 
  4144.  
  4145. Hexadecimal pointer 
  4146.           Displays the contents of the monitored variable as a hexadecimal 
  4147.           pointer. 
  4148.  
  4149. Decimal pointer 
  4150.           Displays the contents of the monitored variable as a decimal pointer. 
  4151.  
  4152. Array 
  4153.           Displays the contents of the monitored variable as an array. 
  4154.  
  4155. Floating point 
  4156.           Displays the contents of the monitored variable in floating-point 
  4157.           notation. 
  4158.  
  4159. Character 
  4160.           Displays the contents of the monitored variable in character form. 
  4161.  
  4162. Note:  Floating point registers or variables display as either a floating-point 
  4163. decimal number or as a hexadecimal string. However, they cannot be updated with 
  4164. a hexadecimal string that represents a floating-point number.  If you need to 
  4165. update a floating-point variable with a hexadecimal representation of a 
  4166. floating-point number, you must step through the Disassembly window to see when 
  4167. the variable loads into a register and then change the value in the Registers 
  4168. window. 
  4169.  
  4170.  
  4171. ΓòÉΓòÉΓòÉ 9.2.3. Representations ΓòÉΓòÉΓòÉ
  4172.  
  4173. Select the Hexadecimal choice to display the contents of a variable that is 
  4174. being monitored in hexadecimal notation. 
  4175.  
  4176. Select the Decimal choice to display the contents of a variable that is being 
  4177. monitored in decimal notation. 
  4178.  
  4179. Select the String choice to display the contents of a monitored variable as a 
  4180. character string. 
  4181.  
  4182. Select the Hexadecimal pointer choice to display the contents of a monitored 
  4183. variable as a hexadecimal pointer. 
  4184.  
  4185. Select the Decimal pointer choice to display the contents of a monitored 
  4186. variable as a decimal pointer. 
  4187.  
  4188. Select the Array choice to display the contents of a monitored variable as an 
  4189. array. 
  4190.  
  4191. Select the Floating point choice to display the contents of a monitored 
  4192. variable in floating-point notation. 
  4193.  
  4194. Select the Character choice to display the contents of a monitored variable as 
  4195. a character. 
  4196.  
  4197.  
  4198. ΓòÉΓòÉΓòÉ 9.2.4. Show Context Choice ΓòÉΓòÉΓòÉ
  4199.  
  4200. Select the Show context choice to display the contextual information for the 
  4201. variable you are monitoring. The following information displays: 
  4202.  
  4203. o Source 
  4204. o File 
  4205. o Line 
  4206. o Thread. 
  4207.  
  4208.  
  4209. ΓòÉΓòÉΓòÉ 9.2.5. Hide Context Choice ΓòÉΓòÉΓòÉ
  4210.  
  4211. Select the Hide context choice to hide the contextual information for the 
  4212. variable you are monitoring. 
  4213.  
  4214.  
  4215. ΓòÉΓòÉΓòÉ 9.2.6. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  4216.  
  4217. Select the Save window positions and sizes choice to save the position of all 
  4218. debugger windows. 
  4219.  
  4220. When you select this choice, the window positions are saved and the windows 
  4221. display in the selected positions. 
  4222.  
  4223. Note:  You do not need to save program profile for this choice to 
  4224.  
  4225.  
  4226. ΓòÉΓòÉΓòÉ 9.2.7. Control Choice ΓòÉΓòÉΓòÉ
  4227.  
  4228. Select the Control choice to display the Control window. 
  4229.  
  4230.  
  4231. ΓòÉΓòÉΓòÉ 9.3. Windows Menu ΓòÉΓòÉΓòÉ
  4232.  
  4233. Select the Windows menu to display a list of all the open debugger windows. By 
  4234. selecting a window from the Windows menu, it is brought into focus and made the 
  4235. active window. Also, if the window is minimized, it is restored. 
  4236.  
  4237.  
  4238. ΓòÉΓòÉΓòÉ 9.3.1. Windows Choices ΓòÉΓòÉΓòÉ
  4239.  
  4240. Select this choice to make the window active. By selecting this choice, the 
  4241. window is brought into focus and made the active window. Also, if the window is 
  4242. minimized, it is restored. 
  4243.  
  4244.  
  4245. ΓòÉΓòÉΓòÉ 9.4. Help Menu ΓòÉΓòÉΓòÉ
  4246.  
  4247. Select choices from the Help menu to complement the online help information 
  4248. that you can get for the debugger when you press F1 or select the Help push 
  4249. button. 
  4250.  
  4251. Menu Summary 
  4252.  
  4253. Help index 
  4254.           An alphabetical index of all available debugger help topics. 
  4255.  
  4256. General help 
  4257.           Help information for the active window. 
  4258.  
  4259. Using help 
  4260.           How to use the help facility. 
  4261.  
  4262.  
  4263. ΓòÉΓòÉΓòÉ 9.4.1. Help Index Choice ΓòÉΓòÉΓòÉ
  4264.  
  4265. Select the Index choice display an alphabetical list of index topics for the 
  4266. debugger. Use the Find choice provided with the online help facility to locate 
  4267. topics in the index. 
  4268.  
  4269.  
  4270. ΓòÉΓòÉΓòÉ 9.4.2. General Help Choice ΓòÉΓòÉΓòÉ
  4271.  
  4272. Select the General help choice to display online help for the active debugger 
  4273. window. The online help panel displayed is the same panel that displays when 
  4274. you place your cursor inside the window and press F1. 
  4275.  
  4276.  
  4277. ΓòÉΓòÉΓòÉ 9.4.3. Using Help Choice ΓòÉΓòÉΓòÉ
  4278.  
  4279. Select the Using help choice to display online help information about the 
  4280. OS/2help facility. 
  4281.  
  4282.  
  4283. ΓòÉΓòÉΓòÉ 10. Program Monitor Window ΓòÉΓòÉΓòÉ
  4284.  
  4285. Program Monitor Window 
  4286.  
  4287. Use the Program Monitor window to collect variables or expressions that you 
  4288. want to monitor. This window is not associated with any specific source window 
  4289. and remains open at all times unless you close it. 
  4290.  
  4291. You can select the variables or expressions you want to display from the source 
  4292. window by: 
  4293.  
  4294. o Using the mouse 
  4295. o Using the mouse and monitor expression window 
  4296. o Using the keyboard. 
  4297.  
  4298. You must select an expression with a valid: 
  4299.  
  4300. o Operand type 
  4301. o Operator 
  4302. o Typecasting operation. 
  4303.  
  4304.  Menu Bar Summary 
  4305.  
  4306. File 
  4307.           End your debugging session. 
  4308.  
  4309. Edit 
  4310.           Select or delete monitors. 
  4311.  
  4312. Options 
  4313.           Modify the style of monitoring and the presentation of variables and 
  4314.           expressions. 
  4315.  
  4316. Windows 
  4317.           Displays the active debugger windows. 
  4318.  
  4319. Help 
  4320.           Displays online help that compliments the information you get when 
  4321.           you press F1 or select a Help push button. 
  4322.  
  4323. Related Information 
  4324.  
  4325. o Using the Variable Monitors 
  4326. o Local Variables Window 
  4327. o Monitor Properties 
  4328. o Private Monitor Window 
  4329.  
  4330.  
  4331. ΓòÉΓòÉΓòÉ 10.1. File Menu ΓòÉΓòÉΓòÉ
  4332.  
  4333. Select the File menu choice to end your debugging session. 
  4334.  
  4335. Menu Summary 
  4336.  
  4337. Close debugger 
  4338.           End your debugging session. 
  4339.  
  4340.  
  4341. ΓòÉΓòÉΓòÉ 10.2. Edit Menu ΓòÉΓòÉΓòÉ
  4342.  
  4343. Select choices from the Edit menu to delete, select, and deselect expressions. 
  4344.  
  4345.  Menu Summary 
  4346.  
  4347. Delete 
  4348.           Delete all of the selected data items that are being monitored. 
  4349.  
  4350. Delete all 
  4351.           Delete all the expressions and no longer monitor their values in this 
  4352.           window, 
  4353.  
  4354. Select all 
  4355.           Select all expressions.  Selected expressions may be controlled by 
  4356.           using the Optionsmenu.  For example, by selecting one or more 
  4357.           expressions, you can change the representation for all the selected 
  4358.           expressions at one time. 
  4359.  
  4360. Deselect all 
  4361.           Deselect all expressions. 
  4362.  
  4363. Close debugger 
  4364.           Close the debugging session. 
  4365.  
  4366.  
  4367. ΓòÉΓòÉΓòÉ 10.2.1. Delete Choice ΓòÉΓòÉΓòÉ
  4368.  
  4369. Select the Delete choice to delete variables or expressions that are being 
  4370. monitored from a monitor window. 
  4371.  
  4372. To delete a variable or expression from a monitor window: 
  4373.  
  4374.  1. Select the variable or expression with your mouse. The monitor for the 
  4375.     variable or expression highlights. 
  4376.  
  4377.  2. Select the Delete choice from the Options menu. 
  4378.  
  4379.  
  4380. ΓòÉΓòÉΓòÉ 10.2.2. Delete All Choice ΓòÉΓòÉΓòÉ
  4381.  
  4382. Select the Delete all choice to delete all the variables or expressions that 
  4383. are being monitored from a monitor window. 
  4384.  
  4385. To delete the variables or expressions from a monitor window, select the Delete 
  4386. all choice from the Options menu. 
  4387.  
  4388.  
  4389. ΓòÉΓòÉΓòÉ 10.2.3. Select All Choice ΓòÉΓòÉΓòÉ
  4390.  
  4391. Select the Select all choice to select all the expressions in the window. 
  4392. Selected expressions may be controlled by using the Options menu.  For example, 
  4393. by selecting one or more expressions, you can change the representation for all 
  4394. the selected expressions at one time. 
  4395.  
  4396.  
  4397. ΓòÉΓòÉΓòÉ 10.2.4. Deselect All Choice ΓòÉΓòÉΓòÉ
  4398.  
  4399. Select the Deselect all choice to cancel the selection of all the expressions 
  4400. in the window. 
  4401.  
  4402.  
  4403. ΓòÉΓòÉΓòÉ 10.2.5. Close Debugger Choice ΓòÉΓòÉΓòÉ
  4404.  
  4405. Select the Close debugger choice to close the current debugging session. 
  4406.  
  4407. When you select the Close debugger choice, a message box prompts you to confirm 
  4408. that you want to end the debugging session. 
  4409.  
  4410.  
  4411. ΓòÉΓòÉΓòÉ 10.3. Options Menu ΓòÉΓòÉΓòÉ
  4412.  
  4413. Select choices from the Options menu to change the representation of a variable 
  4414. or expression, delete a variable or expression from the Monitor Expression 
  4415. window, control the updating of the displayed contents, display context, and 
  4416. change the font for the text in this window. 
  4417.  
  4418.  Menu Summary 
  4419.  
  4420. Fonts 
  4421.           Select the font for the text in the Monitor Expression window. 
  4422.  
  4423. Representation 
  4424.           Display the contents of a monitored variable or expression in a 
  4425.           different representation. 
  4426.  
  4427. Enable 
  4428.           Displays the contents of a variable or expression as it updates. 
  4429.  
  4430. Disable 
  4431.           Prevent the displayed contents of a variable or expression from 
  4432.           updating. 
  4433.  
  4434. Show context 
  4435.           Display the contextual information for a variable or expression being 
  4436.           monitored. 
  4437.  
  4438. Hide context 
  4439.           Prevent the contextual information for a monitored variable or 
  4440.           expression from displaying. 
  4441.  
  4442. Close debugger 
  4443.           Close the debugging session. 
  4444.  
  4445.  
  4446. ΓòÉΓòÉΓòÉ 10.3.1. Fonts Choice ΓòÉΓòÉΓòÉ
  4447.  
  4448. Select the Fonts choice to set the font you want to use for the text that 
  4449. displays in the Program Monitor window. 
  4450.  
  4451.  
  4452. ΓòÉΓòÉΓòÉ <hidden> Representation Cascading Choice ΓòÉΓòÉΓòÉ
  4453.  
  4454. Select the Representation cascading choice to display the contents of the 
  4455. variable in a new representation. The types of representation that display on 
  4456. the menu depend on the data type of the variable you are monitoring. 
  4457.  
  4458. The following are possible representations: 
  4459.  
  4460. Hexadecimal 
  4461.           Displays the contents of the monitored variable in hexadecimal 
  4462.           notation. 
  4463.  
  4464. Decimal 
  4465.           Displays the contents of the monitored variable in decimal notation. 
  4466.  
  4467. String 
  4468.           Displays the contents of the monitored variable as a character 
  4469.           string. 
  4470.  
  4471. Hexadecimal pointer 
  4472.           Displays the contents of the monitored variable as a hexadecimal 
  4473.           pointer. 
  4474.  
  4475. Decimal pointer 
  4476.           Displays the contents of the monitored variable as a decimal pointer. 
  4477.  
  4478. Array 
  4479.           Displays the contents of the monitored variable as an array. 
  4480.  
  4481. Floating point 
  4482.           Displays the contents of the monitored variable in floating-point 
  4483.           notation. 
  4484.  
  4485. Character 
  4486.           Displays the contents of the monitored variable in character form. 
  4487.  
  4488. Note:  Floating point registers or variables display as either a floating-point 
  4489. decimal number or as a hexadecimal string. However, they cannot be updated with 
  4490. a hexadecimal string that represents a floating-point number. If you need to 
  4491. update a floating-point variable with a hexadecimal representation of a 
  4492. floating-point number, you must step through the Disassembly window to see when 
  4493. the variable loads into a register and then changes the value in the Registers 
  4494. window. 
  4495.  
  4496.  
  4497. ΓòÉΓòÉΓòÉ 10.3.2. Enable Choice ΓòÉΓòÉΓòÉ
  4498.  
  4499. Select the Enable choice to have the displayed contents of a variable or 
  4500. expression updated as the state of the program changes. 
  4501.  
  4502.  
  4503. ΓòÉΓòÉΓòÉ 10.3.3. Disable Choice ΓòÉΓòÉΓòÉ
  4504.  
  4505. Select the Disable choice to prevent the displayed contents of a variable or 
  4506. expression from updating as the state of the program changes. 
  4507.  
  4508.  
  4509. ΓòÉΓòÉΓòÉ 10.3.4. Show Context Choice ΓòÉΓòÉΓòÉ
  4510.  
  4511. Select the Show context choice to display the contextual information for the 
  4512. variable you are monitoring. The following information displays: 
  4513.  
  4514. o Source 
  4515. o File 
  4516. o Line 
  4517. o Thread. 
  4518.  
  4519.  
  4520. ΓòÉΓòÉΓòÉ 10.3.5. Hide Context Choice ΓòÉΓòÉΓòÉ
  4521.  
  4522. Select the Hide context choice to hide the contextual information for the 
  4523. variable you are monitoring. 
  4524.  
  4525.  
  4526. ΓòÉΓòÉΓòÉ 10.3.6. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  4527.  
  4528. Select the Save window positions and sizes choice to save the position of all 
  4529. debugger windows. 
  4530.  
  4531. When you select this choice, the window positions are saved and the windows 
  4532. display in the selected positions. 
  4533.  
  4534. Note:  You do not need to save program profile for this choice to 
  4535.  
  4536.  
  4537. ΓòÉΓòÉΓòÉ 10.3.7. Control Choice ΓòÉΓòÉΓòÉ
  4538.  
  4539. Select the Control choice to display the Control window. 
  4540.  
  4541.  
  4542. ΓòÉΓòÉΓòÉ 10.4. Windows Menu ΓòÉΓòÉΓòÉ
  4543.  
  4544. Select the Windows menu to display a list of all the open debugger windows. By 
  4545. selecting a window from the Windows menu, it is brought into focus and made the 
  4546. active window. Also, if the window is minimized, it is restored. 
  4547.  
  4548.  
  4549. ΓòÉΓòÉΓòÉ 10.4.1. Windows Choices ΓòÉΓòÉΓòÉ
  4550.  
  4551. Select this choice to make the window active. By selecting this choice, the 
  4552. window is brought into focus and made the active window. Also, if the window is 
  4553. minimized, it is restored. 
  4554.  
  4555.  
  4556. ΓòÉΓòÉΓòÉ 10.5. Help Menu ΓòÉΓòÉΓòÉ
  4557.  
  4558. Select choices from the Help menu to complement the online help information 
  4559. that you can get for the debugger when you press F1 or select the Help push 
  4560. button. 
  4561.  
  4562. Menu Summary 
  4563.  
  4564. Help index 
  4565.           An alphabetical index of all available debugger help topics. 
  4566.  
  4567. General help 
  4568.           Help information for the active window. 
  4569.  
  4570. Using help 
  4571.           How to use the help facility. 
  4572.  
  4573.  
  4574. ΓòÉΓòÉΓòÉ 10.5.1. Help Index Choice ΓòÉΓòÉΓòÉ
  4575.  
  4576. Select the Index choice display an alphabetical list of index topics for the 
  4577. debugger. Use the Find choice provided with the online help facility to locate 
  4578. topics in the index. 
  4579.  
  4580.  
  4581. ΓòÉΓòÉΓòÉ 10.5.2. General Help Choice ΓòÉΓòÉΓòÉ
  4582.  
  4583. Select the General help choice to display online help for the active debugger 
  4584. window. The online help panel displayed is the same panel that displays when 
  4585. you place your cursor inside the window and press F1. 
  4586.  
  4587.  
  4588. ΓòÉΓòÉΓòÉ 10.5.3. Using Help Choice ΓòÉΓòÉΓòÉ
  4589.  
  4590. Select the Using help choice to display online help information about the 
  4591. OS/2help facility. 
  4592.  
  4593.  
  4594. ΓòÉΓòÉΓòÉ 11. Private Monitor Window ΓòÉΓòÉΓòÉ
  4595.  
  4596. Private Monitor Window 
  4597.  
  4598. Use the Private Monitor window to collect variables or expressions that you 
  4599. want to monitor. This window is associated with a specific source window and is 
  4600. closed when the associated source window is closed. 
  4601.  
  4602. You can select the variables or expressions you want to display from a window: 
  4603.  
  4604. o Using the mouse 
  4605. o Using the mouse and the Monitor window 
  4606. o Using the keyboard. 
  4607.  
  4608. You must select an expression with a valid: 
  4609.  
  4610. o Operand type 
  4611. o Operator 
  4612. o Typecasting operation. 
  4613.  
  4614.  Menu Bar Summary 
  4615.  
  4616. Edit 
  4617.           Delete, select, and deselect expressions. 
  4618.  
  4619. Options 
  4620.           Modify the style of monitoring and the presentation of variables and 
  4621.           expressions. 
  4622.  
  4623. Help 
  4624.           Displays online help that compliments the information you get when 
  4625.           you press F1 or select a Help push button. 
  4626.  
  4627. Related Information 
  4628.  
  4629. o Using the Variable Monitors 
  4630. o Local Variables Window 
  4631. o Monitor Properties 
  4632. o Monitor Expression Window 
  4633.  
  4634.  
  4635. ΓòÉΓòÉΓòÉ 11.1. Edit Menu ΓòÉΓòÉΓòÉ
  4636.  
  4637. Select choices from the Edit menu to delete, select, and deselect expressions. 
  4638.  
  4639.  Menu Summary 
  4640.  
  4641. Delete 
  4642.           Delete a selected data item that is being monitored. 
  4643.  
  4644. Delete all 
  4645.           Delete all the expressions. 
  4646.  
  4647. Select all 
  4648.           Select all expressions. 
  4649.  
  4650. Deselect all 
  4651.           Deselect all expressions. 
  4652.  
  4653.  
  4654. ΓòÉΓòÉΓòÉ 11.1.1. Delete Choice ΓòÉΓòÉΓòÉ
  4655.  
  4656. Select the Delete choice to delete variables or expressions that are being 
  4657. monitored from a monitor window. 
  4658.  
  4659. To delete a variable or expression from a monitor window: 
  4660.  
  4661.  1. Select the variable or expression with your mouse. The monitor for the 
  4662.     variable or expression highlights. 
  4663.  
  4664.  2. Select the Delete choice. 
  4665.  
  4666.  
  4667. ΓòÉΓòÉΓòÉ 11.1.2. Delete All Choice ΓòÉΓòÉΓòÉ
  4668.  
  4669. Select the Delete all choice to delete all the variables or expressions that 
  4670. are being monitored from a monitor window. 
  4671.  
  4672. To delete the variables or expressions from a monitor window, select the Delete 
  4673. all choice. 
  4674.  
  4675.  
  4676. ΓòÉΓòÉΓòÉ 11.1.3. Select All Choice ΓòÉΓòÉΓòÉ
  4677.  
  4678. Select the Select all choice to select all the expressions in the window. 
  4679.  
  4680.  
  4681. ΓòÉΓòÉΓòÉ 11.1.4. Deselect All Choice ΓòÉΓòÉΓòÉ
  4682.  
  4683. Select the Deselect all choice to cancel the selection of all the expressions 
  4684. in the window. 
  4685.  
  4686.  
  4687. ΓòÉΓòÉΓòÉ 11.1.5. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  4688.  
  4689. Select the Where is execution point choice to locate the next line to be 
  4690. executed in the thread. 
  4691.  
  4692.  
  4693. ΓòÉΓòÉΓòÉ 11.2. Options Menu ΓòÉΓòÉΓòÉ
  4694.  
  4695. Select choices from the Options menu to change the representation of a variable 
  4696. or expression, delete a variable or expression from the Private Monitor window, 
  4697. control the updating of the displayed contents, display context, and change the 
  4698. font for the text in this window. 
  4699.  
  4700. Menu Summary 
  4701.  
  4702. Fonts 
  4703.           Select the font for the text in the Private Monitor window. 
  4704.  
  4705. Representation 
  4706.           Display the contents of a monitored variable or expression in a 
  4707.           different representation. 
  4708.  
  4709. Enable 
  4710.           Displays the contents of a variable or expression as it updates. 
  4711.  
  4712. Disable 
  4713.           Prevent the displayed contents of a variable or expression from 
  4714.           updating. 
  4715.  
  4716. Show context 
  4717.           Display the contextual information for a variable or expression being 
  4718.           monitored. 
  4719.  
  4720. Hide context 
  4721.           Prevent the contextual information for a monitored variable or 
  4722.           expression from displaying. 
  4723.  
  4724.  
  4725. ΓòÉΓòÉΓòÉ 11.2.1. Fonts Choice ΓòÉΓòÉΓòÉ
  4726.  
  4727. Select the Fonts choice to set the font you want to use for the text that 
  4728. displays in the Private Monitor window. 
  4729.  
  4730.  
  4731. ΓòÉΓòÉΓòÉ <hidden> Representation Cascading Choice ΓòÉΓòÉΓòÉ
  4732.  
  4733. Select the Representation cascading choice to display the contents of the 
  4734. variable in a new representation. The types of representation that display on 
  4735. the menu depend on the data type of the variable you are monitoring. 
  4736.  
  4737. The following are possible representations: 
  4738.  
  4739. Hexadecimal 
  4740.           Displays the contents of the monitored variable in hexadecimal 
  4741.           notation. 
  4742.  
  4743. Decimal 
  4744.           Displays the contents of the monitored variable in decimal notation. 
  4745.  
  4746. String 
  4747.           Displays the contents of the monitored variable as a character 
  4748.           string. 
  4749.  
  4750. Hexadecimal pointer 
  4751.           Displays the contents of the monitored variable as a hexadecimal 
  4752.           pointer. 
  4753.  
  4754. Decimal pointer 
  4755.           Displays the contents of the monitored variable as a decimal pointer. 
  4756.  
  4757. Array 
  4758.           Displays the contents of the monitored variable as an array. 
  4759.  
  4760. Floating point 
  4761.           Displays the contents of the monitored variable in floating-point 
  4762.           notation. 
  4763.  
  4764. Character 
  4765.           Displays the contents of the monitored variable in character form. 
  4766.  
  4767. Note:  Floating point registers or variables display as either a floating-point 
  4768. decimal number or as a hexadecimal string. However, they cannot be updated with 
  4769. a hexadecimal string that represents a floating-point number. If you need to 
  4770. update a floating-point variable with a hexadecimal representation of a 
  4771. floating-point number, you must step through the Disassembly window to see when 
  4772. the variable loads into a register and then changes the value in the Registers 
  4773. window. 
  4774.  
  4775.  
  4776. ΓòÉΓòÉΓòÉ 11.2.2. Enable Choice ΓòÉΓòÉΓòÉ
  4777.  
  4778. Select the Enable choice to have the displayed contents of a variable or 
  4779. expression updated as the state of the program changes. 
  4780.  
  4781.  
  4782. ΓòÉΓòÉΓòÉ 11.2.3. Disable Choice ΓòÉΓòÉΓòÉ
  4783.  
  4784. Select the Disable choice to prevent the displayed contents of a variable or 
  4785. expression from updating as the state of the program changes. 
  4786.  
  4787.  
  4788. ΓòÉΓòÉΓòÉ 11.2.4. Show Context Choice ΓòÉΓòÉΓòÉ
  4789.  
  4790. Select the Show context choice to display the contextual information for the 
  4791. variable you are monitoring. The following information displays: 
  4792.  
  4793. o Source 
  4794. o File 
  4795. o Line 
  4796. o Thread. 
  4797.  
  4798.  
  4799. ΓòÉΓòÉΓòÉ 11.2.5. Hide Context Choice ΓòÉΓòÉΓòÉ
  4800.  
  4801. Select the Hide context choice to hide the contextual information for the 
  4802. variable you are monitoring. 
  4803.  
  4804.  
  4805. ΓòÉΓòÉΓòÉ 11.3. Help Menu ΓòÉΓòÉΓòÉ
  4806.  
  4807. Select choices from the Help menu to complement the online help information 
  4808. that you can get for the debugger when you press F1 or select the Help push 
  4809. button. 
  4810.  
  4811. Menu Summary 
  4812.  
  4813. Help index 
  4814.           An alphabetical index of all available debugger help topics. 
  4815.  
  4816. General help 
  4817.           Help information for the active window. 
  4818.  
  4819. Using help 
  4820.           How to use the help facility. 
  4821.  
  4822.  
  4823. ΓòÉΓòÉΓòÉ 11.3.1. Help Index Choice ΓòÉΓòÉΓòÉ
  4824.  
  4825. Select the Index choice display an alphabetical list of index topics for the 
  4826. debugger. Use the Find choice provided with the online help facility to locate 
  4827. topics in the index. 
  4828.  
  4829.  
  4830. ΓòÉΓòÉΓòÉ 11.3.2. General Help Choice ΓòÉΓòÉΓòÉ
  4831.  
  4832. Select the General help choice to display online help for the active debugger 
  4833. window. The online help panel displayed is the same panel that displays when 
  4834. you place your cursor inside the window and press F1. 
  4835.  
  4836.  
  4837. ΓòÉΓòÉΓòÉ 11.3.3. Using Help Choice ΓòÉΓòÉΓòÉ
  4838.  
  4839. Select the Using help choice to display online help information about the 
  4840. OS/2help facility. 
  4841.  
  4842.  
  4843. ΓòÉΓòÉΓòÉ 12. Popup Expression Window ΓòÉΓòÉΓòÉ
  4844.  
  4845. Popup Expression Window 
  4846.  
  4847. The Popup Expression window displays the variable or expression you select for 
  4848. monitoring. It is associated with a specific source window and is closed when 
  4849. the associated window is closed. 
  4850.  
  4851. You can select the variables or expressions you want to display: 
  4852.  
  4853. o Using the mouse 
  4854. o Using the mouse and the Monitor window 
  4855. o Using the keyboard. 
  4856.  
  4857. You must select an expression with a valid: 
  4858.  
  4859. o Operand type 
  4860. o Operator 
  4861. o Typecasting operation. 
  4862.  
  4863.  Menu Bar Summary 
  4864.  
  4865. Options 
  4866.           Transfer a variable to the Private Monitor or the Monitor Expression 
  4867.           window, select how long to monitor a variable, and control how the 
  4868.           contents of the variable display. 
  4869.  
  4870. Help 
  4871.           Displays online help that compliments the information you get when 
  4872.           you press F1 or select a Help push button. 
  4873.  
  4874. Related Information 
  4875.  
  4876. o Local Variables Window 
  4877. o Monitor Properties 
  4878. o Monitor Expression Window 
  4879. o Private Monitor Window 
  4880.  
  4881.  
  4882. ΓòÉΓòÉΓòÉ 12.1. Edit Menu ΓòÉΓòÉΓòÉ
  4883.  
  4884. Select choices from the Edit menu to copy and place selected items to the 
  4885. clipboard. 
  4886.  
  4887. Menu Bar Summary 
  4888.  
  4889.  
  4890. ΓòÉΓòÉΓòÉ 12.1.1. Where Is Execution Point Choice ΓòÉΓòÉΓòÉ
  4891.  
  4892. Select the Where is execution point choice to locate the next line to be 
  4893. executed in the thread. 
  4894.  
  4895.  
  4896. ΓòÉΓòÉΓòÉ 12.2. Options Menu ΓòÉΓòÉΓòÉ
  4897.  
  4898. The Options menu controls how the contents of the monitored variable display, 
  4899. updates the displayed contents, how long the Popup Expression window remains 
  4900. open, and the window to which you can transfer the variable. 
  4901.  
  4902. Menu Summary 
  4903.  
  4904. Fonts 
  4905.           Choose the font for the text in the Popup Expression window. 
  4906.  
  4907. Representation 
  4908.           Change the representation of the displayed contents. 
  4909.  
  4910. Enabled 
  4911.           Control the updating of the displayed contents. 
  4912.  
  4913. Show context 
  4914.           Display the contextual information for a variable. 
  4915.  
  4916. Duration 
  4917.           Select when the Popup Expression window closes. 
  4918.  
  4919. Transfer to 
  4920.           Transfer the variable to the Monitor Expression window or the Private 
  4921.           Monitor window. 
  4922.  
  4923.  
  4924. ΓòÉΓòÉΓòÉ 12.2.1. Fonts Choice ΓòÉΓòÉΓòÉ
  4925.  
  4926. Select the Fonts choice to set the font you want to use for the text that 
  4927. displays in the Popup Expression window. 
  4928.  
  4929.  
  4930. ΓòÉΓòÉΓòÉ <hidden> Representation Cascading Choice ΓòÉΓòÉΓòÉ
  4931.  
  4932. Select the Representation cascading choice to display the contents of the 
  4933. variable in a new representation. The types of representation that display on 
  4934. the menu depend on the data type of the variable you are monitoring. 
  4935.  
  4936. The following are possible representations: 
  4937.  
  4938. Hexadecimal 
  4939.           Displays the contents of the monitored variable in hexadecimal 
  4940.           notation. 
  4941.  
  4942. Decimal 
  4943.           Displays the contents of the monitored variable in decimal notation. 
  4944.  
  4945. String 
  4946.           Displays the contents of the monitored variable as a character 
  4947.           string. 
  4948.  
  4949. Hexadecimal pointer 
  4950.           Displays the contents of the monitored variable as a hexadecimal 
  4951.           pointer. 
  4952.  
  4953. Decimal pointer 
  4954.           Displays the contents of the monitored variable as a decimal pointer. 
  4955.  
  4956. Array 
  4957.           Displays the contents of the monitored variable as an array. 
  4958.  
  4959. Floating point 
  4960.           Displays the contents of the monitored variable in floating-point 
  4961.           notation. 
  4962.  
  4963. Character 
  4964.           Displays the contents of the monitored variable in character form. 
  4965.  
  4966. Note:  Floating point registers or variables display as either a floating-point 
  4967. decimal number or as a hexadecimal string. However, they cannot be updated with 
  4968. a hexadecimal string that represents a floating-point number. If you need to 
  4969. update a floating-point variable with a hexadecimal representation of a 
  4970. floating-point number, you must step through the Disassembly window to see when 
  4971. the variable loads into a register and then changes the value in the Registers 
  4972. window. 
  4973.  
  4974.  
  4975. ΓòÉΓòÉΓòÉ 12.2.2. Enabled Choice ΓòÉΓòÉΓòÉ
  4976.  
  4977. Select the Enabled choice to update the displayed value of the variables or 
  4978. expressions you are monitoring as the state of the program changes. The Enabled 
  4979. choice is selected when check mark symbol is displayed. To disable the 
  4980. variable, select the Enabled menu choice again, to remove the check mark 
  4981. symbol. 
  4982.  
  4983.  
  4984. ΓòÉΓòÉΓòÉ 12.2.3. Show Context Choice ΓòÉΓòÉΓòÉ
  4985.  
  4986. Select the Show context choice to display contextual information for the 
  4987. variables you are monitoring. The following information displays: 
  4988.  
  4989. o Source 
  4990. o File 
  4991. o Line 
  4992. o Thread. 
  4993.  
  4994. The Show context choice is selected when check mark symbol displays. To hide 
  4995. the contextual information, select the Show context choice again to remove 
  4996. check mark symbol. 
  4997.  
  4998.  
  4999. ΓòÉΓòÉΓòÉ 12.2.4. Duration Choice ΓòÉΓòÉΓòÉ
  5000.  
  5001. Select the Duration choice to set the conditions under which the Popup 
  5002. Expression window closes. 
  5003.  
  5004. Menu Summary 
  5005.  
  5006. Step/run 
  5007.           Closes the monitor window when the next step command or Run executes. 
  5008.  
  5009. New source 
  5010.           Closes the monitor window when the debugger enters a new object file. 
  5011.  
  5012. Permanent 
  5013.           Keeps the monitor window open for the remainder of the debugging 
  5014.           session. 
  5015.  
  5016.  
  5017. ΓòÉΓòÉΓòÉ 12.2.4.1. Step/Run Choice ΓòÉΓòÉΓòÉ
  5018.  
  5019. Select the Step/Run choice to close the Popup Expression window the next time a 
  5020. step command or Run executes. 
  5021.  
  5022.  
  5023. ΓòÉΓòÉΓòÉ 12.2.4.2. New Source Choice ΓòÉΓòÉΓòÉ
  5024.  
  5025. Select the New source choice to close the Popup Expression window when the 
  5026. current line moves to a different part of the program. 
  5027.  
  5028.  
  5029. ΓòÉΓòÉΓòÉ 12.2.4.3. Permanent Choice ΓòÉΓòÉΓòÉ
  5030.  
  5031. Select the Permanent choice to cause the Popup Expression window to remain open 
  5032. for the remainder of the debugging session. 
  5033.  
  5034.  
  5035. ΓòÉΓòÉΓòÉ 12.2.5. Transfer to Choice ΓòÉΓòÉΓòÉ
  5036.  
  5037. Select the Transfer to choice to move the variable or expression you are 
  5038. monitoring to the Private Monitor or Monitor Expression window. 
  5039.  
  5040. Any variable or expression can be transferred either to the Private Monitor 
  5041. window or to the Monitor Expression window. It does not matter whether the 
  5042. variable or expression is used throughout the program. The Private Monitor 
  5043. window, however, is a secondary window to the source window for which it was 
  5044. opened. It closes when its associated source window closes. You should, 
  5045. therefore, monitor local variables in the Private Monitor window, and monitor 
  5046. global variables in the Monitor Expression window. 
  5047.  
  5048.  Menu Summary 
  5049.  
  5050. Private monitor 
  5051.           Move the variable or expression you are monitoring to the Private 
  5052.           Monitor window. 
  5053.  
  5054. Monitor expression 
  5055.           Move the variable or expression you are monitoring to the Monitor 
  5056.           Expression window. 
  5057.  
  5058. Storage 
  5059.           Monitor the storage in your program. 
  5060.  
  5061.  
  5062. ΓòÉΓòÉΓòÉ 12.2.5.1. Private Monitor Choice ΓòÉΓòÉΓòÉ
  5063.  
  5064. Select the Private Monitor choice to move the variable or expression you are 
  5065. monitoring to the Private Monitor window. 
  5066.  
  5067.  
  5068. ΓòÉΓòÉΓòÉ 12.2.5.2. Monitor Expression Choice ΓòÉΓòÉΓòÉ
  5069.  
  5070. Select the Monitor expression choice to display the Monitor Expression window. 
  5071.  
  5072. Use the Monitor Expression window to collect variables or expressions that you 
  5073. want to monitor. 
  5074.  
  5075.  
  5076. ΓòÉΓòÉΓòÉ 12.2.5.3. Storage Choice ΓòÉΓòÉΓòÉ
  5077.  
  5078. Select the Storage choice to  display the Storage window. 
  5079.  
  5080. Use this window to update the storage contents. 
  5081.  
  5082.  
  5083. ΓòÉΓòÉΓòÉ 12.3. Help Menu ΓòÉΓòÉΓòÉ
  5084.  
  5085. Select choices from the Help menu to complement the online help information 
  5086. that you can get for the debugger when you press F1 or select the Help push 
  5087. button. 
  5088.  
  5089. Menu Summary 
  5090.  
  5091. Help index 
  5092.           An alphabetical index of all available debugger help topics. 
  5093.  
  5094. General help 
  5095.           Help information for the active window. 
  5096.  
  5097. Using help 
  5098.           How to use the help facility. 
  5099.  
  5100.  
  5101. ΓòÉΓòÉΓòÉ 12.3.1. Help Index Choice ΓòÉΓòÉΓòÉ
  5102.  
  5103. Select the Index choice display an alphabetical list of index topics for the 
  5104. debugger. Use the Find choice provided with the online help facility to locate 
  5105. topics in the index. 
  5106.  
  5107.  
  5108. ΓòÉΓòÉΓòÉ 12.3.2. General Help Choice ΓòÉΓòÉΓòÉ
  5109.  
  5110. Select the General help choice to display online help for the active debugger 
  5111. window. The online help panel displayed is the same panel that displays when 
  5112. you place your cursor inside the window and press F1. 
  5113.  
  5114.  
  5115. ΓòÉΓòÉΓòÉ 12.3.3. Using Help Choice ΓòÉΓòÉΓòÉ
  5116.  
  5117. Select the Using help choice to display online help information about the 
  5118. OS/2help facility. 
  5119.  
  5120.  
  5121. ΓòÉΓòÉΓòÉ <hidden> Using the Variable Monitors ΓòÉΓòÉΓòÉ
  5122.  
  5123. After you have selected a variable or expression for monitoring, you can: 
  5124.  
  5125. o Use the data manipulation icons 
  5126. o Use the keyboard to move around a monitor 
  5127. o Enable or disable monitors 
  5128. o Display context 
  5129. o Change the value of a variable 
  5130. o Change the representation of a variable or expression. 
  5131.  
  5132.  
  5133. ΓòÉΓòÉΓòÉ <hidden> Keyboard Sequences ΓòÉΓòÉΓòÉ
  5134.  
  5135. You can use various combinations of keys to move around the monitor windows. 
  5136. The key combinations you can use and the functions they provide are: 
  5137.  
  5138. Action    Key Sequence 
  5139.  
  5140. Alt+     Move to the next monitor. 
  5141.  
  5142. Alt+     Move to the previous monitor. 
  5143.  
  5144. Tab       Move to the next monitor component. (The cursor moves in a circular 
  5145.           fashion from component to component. The monitor, itself, is included 
  5146.           in the circular path.) 
  5147.  
  5148. BackTab   Move to the previous monitor component. 
  5149.  
  5150. Alt+     Dereference a highlighted pointer. 
  5151.  
  5152. Enter     Open or close data structures (structures or arrays). 
  5153.  
  5154. Alt+PageUp, Alt+PageDown Scroll through the monitor. 
  5155.  
  5156.  
  5157. ΓòÉΓòÉΓòÉ <hidden> Enabling and Disabling Monitors ΓòÉΓòÉΓòÉ
  5158.  
  5159. You can enable and disable monitors. When enabled, the monitor updates the stop 
  5160. value of the program to actual value in storage. However, a disabled monitor 
  5161. suspends this updating and reflects the stop value or the value held when the 
  5162. monitor was disabled. 
  5163.  
  5164. You cannot change the value of a disabled monitor. When you enable a disabled 
  5165. monitor, the current value displays. 
  5166.  
  5167.  
  5168. ΓòÉΓòÉΓòÉ <hidden> Displaying Context ΓòÉΓòÉΓòÉ
  5169.  
  5170. Monitors display the data value in their context. The context consists of: 
  5171.  
  5172. o Source 
  5173. o File 
  5174. o Line 
  5175. o Thread. 
  5176.  
  5177.  
  5178. ΓòÉΓòÉΓòÉ <hidden> Changing the Value of a Variable ΓòÉΓòÉΓòÉ
  5179.  
  5180. You can change the value of a variable or expression that displays in a 
  5181. monitor. To change the value, do the following: 
  5182.  
  5183.  1. Select the variable or expression with your mouse or the Tab key. 
  5184.  
  5185.  2. Type in the new value. 
  5186.  
  5187.  3. Press Enter (or select another part of the debugger). 
  5188.  
  5189.  
  5190. ΓòÉΓòÉΓòÉ <hidden> Changing the Representation ΓòÉΓòÉΓòÉ
  5191.  
  5192. To change the representation, do the following: 
  5193.  
  5194.  1. Select the expression. 
  5195.  
  5196.  2. Select an alternate representation from the Options  Default data 
  5197.     representation choice. The new representation takes effect immediately. 
  5198.  
  5199. You change the representation of the value displayed in a monitor to: 
  5200.  
  5201. o Hexadecimal 
  5202. o Decimal 
  5203. o String 
  5204. o Character 
  5205. o Floating-point 
  5206. o Hexadecimal pointer 
  5207. o Decimal pointer 
  5208. o Array. 
  5209.  
  5210. Note:  The representation you can select varies with the data type being 
  5211. displayed. 
  5212.  
  5213.  
  5214. ΓòÉΓòÉΓòÉ <hidden> Supported Expression Operands ΓòÉΓòÉΓòÉ
  5215.  
  5216. You can monitor an expression that uses the following types of operands only: 
  5217.  
  5218. Operand        Definition 
  5219.  
  5220. Variable       A variable used in your program. 
  5221.  
  5222. Constant       The constant can be one of the following types: 
  5223.  
  5224.    o Fixed or floating-point constant. 
  5225.  
  5226.      Note:  The largest floating-point constant is 1.8E308. The smallest 
  5227.      floating-point is 2.23E-308. 
  5228.    o A string constant, enclosed in quotation marks (" ") 
  5229.    o A character constant, enclosed in single quote marks (' ') 
  5230.    o Segment:Offset address specification (0000:0000) 
  5231.  
  5232.      When you are specifying a segment offset address for monitoring in a 
  5233.      variable monitor window, specify the offset address in the following 
  5234.      format: 
  5235.  
  5236.                0x0000:0
  5237.  
  5238. Registers      One of the following register names: 
  5239.                AX, BX, CX, DX, SP, BP, SI, DI, AL, BL, CL, DL, AH, BH, CH, DH, 
  5240.                EAX, EBX, ECX, EDX, ESP, EBP, ESI, EDI, EIP, CS, DS, ES, FS, GS, 
  5241.                SS, EFLAGS. 
  5242.                One of the following floating-point register names: 
  5243.                ST0 through ST7, FPCW, FPSW, FPTW, FPEIP, FPCS, FPEDP, FPDS. 
  5244.  
  5245.                In the case of conflicting names, the program variable names 
  5246.                take precedence over the register names. For conversions that 
  5247.                are done automatically when the registers display in mixed-mode 
  5248.                expressions, general purpose registers are treated as unsigned 
  5249.                arithmetic items with a length appropriate to the register. For 
  5250.                example, EAX is 32-bits, AX is 16-bits, and AL is 8-bits. 
  5251.  
  5252. If you monitor an enumerated variable, a comment displays to the right of the 
  5253. value.  If the value of the variable matches one of the enumerated types, the 
  5254. comment contains the name of the first enumerated type that matches the value 
  5255. of the variable. If the length of the enumerated name does not fit in the 
  5256. monitor, the contents display as an empty entry field. 
  5257.  
  5258. The comment (empty or not) lets you distinguish between a valid enumerated 
  5259. value and an invalid value. An invalid value does not have a comment to the 
  5260. right of the value. 
  5261.  
  5262. You can not update an enumerated variable by entering an enumerated type. You 
  5263. must enter a value or expression. If the value is a valid enumerated value, the 
  5264. comment to the right of the value updates. 
  5265.  
  5266. Bit fields are supported for C/C++ compiled code only. You can display and 
  5267. update bit fields, but you cannot use them in expressions. You cannot look at 
  5268. variables that have been defined using the define preprocessor directive. 
  5269.  
  5270.  
  5271. ΓòÉΓòÉΓòÉ <hidden> Supported Expression Operators ΓòÉΓòÉΓòÉ
  5272.  
  5273. You can monitor an expression that uses the following operators only: 
  5274.  
  5275. Operator                      Coded as 
  5276.  
  5277. Global scope resolution       ::a 
  5278.  
  5279. Class scope resolution        a::b 
  5280.  
  5281. Subscripting                  a[b] 
  5282.  
  5283. Member selection              a.b or a->b 
  5284.  
  5285. Size                          sizeof a or sizeof (type) 
  5286.  
  5287. Logical not                   !a 
  5288.  
  5289. One's complement              ~a 
  5290.  
  5291. Unary minus                   -a 
  5292.  
  5293. Unary plus                    +a 
  5294.  
  5295. Dereference                   *a 
  5296.  
  5297. Type cast                     (type) a 
  5298.  
  5299. Multiply                      a * b 
  5300.  
  5301. Divide                        a / b 
  5302.  
  5303. Modulo                        a % b 
  5304.  
  5305. Add                           a + b 
  5306.  
  5307. Subtract                      a - b 
  5308.  
  5309. Left shift                    a << b 
  5310.  
  5311. Right shift                   a >> b 
  5312.  
  5313. Less than                     a < b 
  5314.  
  5315. Greater than                  a > b 
  5316.  
  5317. Less than or equal to         a <= b 
  5318.  
  5319. Greater than or equal to      a >= b 
  5320.  
  5321. Equal                         a == b 
  5322.  
  5323. Not equal                     a != b 
  5324.  
  5325. Bitwise AND                   a & b 
  5326.  
  5327. Bitwise OR                    a | b 
  5328.  
  5329. Bitwise exclusive OR          a ^ b 
  5330.  
  5331. Logical AND                   a && b 
  5332.  
  5333. Logical OR                    a || b 
  5334.  
  5335.  
  5336. ΓòÉΓòÉΓòÉ <hidden> Supported Data Types ΓòÉΓòÉΓòÉ
  5337.  
  5338. You can monitor an expression that uses the following typecasting operations 
  5339. only: 
  5340.  
  5341. o 8-bit signed byte 
  5342. o 8-bit unsigned byte 
  5343. o 16-bit signed integer 
  5344. o 16-bit unsigned integer 
  5345. o 32-bit signed integer 
  5346. o 32-bit unsigned integer 
  5347. o 32-bit floating-point 
  5348. o 64-bit floating-point 
  5349. o 80-bit floating-point 
  5350. o Pointers 
  5351. o User-defined types. 
  5352.  
  5353. These data types include int, short, char and so on. 
  5354.  
  5355.  
  5356. ΓòÉΓòÉΓòÉ 12.3.4. Using the Data Manipulation Icons ΓòÉΓòÉΓòÉ
  5357.  
  5358. You can select any of the following icons from any monitor window, such as 
  5359. Monitor Expression, Private Monitor, Popup Expression or Local Variables, to 
  5360. manipulate the data parts of variables: 
  5361.  
  5362.           Expands the contracted parts of an array. 
  5363.  
  5364.           Expands the contracted parts of a structure. 
  5365.  
  5366.           Expands the contracted parts of a class. 
  5367.  
  5368.           Contracts the parts of an expanded array, structure or class. 
  5369.  
  5370.           Displays the object referenced by a pointer in a new monitor. 
  5371.  
  5372. The four windows to monitor variables and expressions are: 
  5373.  
  5374. o Monitor Expression 
  5375. o Private Monitor 
  5376. o Popup Expression 
  5377. o Local Variables. 
  5378.  
  5379.  
  5380. ΓòÉΓòÉΓòÉ 13. Storage Window ΓòÉΓòÉΓòÉ
  5381.  
  5382. Storage Window 
  5383.  
  5384. Use the Storage window to view and update the contents of the storage used by 
  5385. your program. The following storage data displays in the Storage window: 
  5386.  
  5387. o Fields for the displayed addresses. You may select one of the following 
  5388.   storage models for the addresses that display: 
  5389.  
  5390.    - 16:16 (segmented) storage addresses 
  5391.    - Flat storage model addresses 
  5392.    - Both 16:16 and flat storage model addresses. 
  5393.  
  5394. o Fields for the data storage contents. Storage can be displayed in various 
  5395.   styles. However, you can display only one storage style at a time. 
  5396. o Titles for the displayed addresses and storage content fields. 
  5397.  
  5398. You can open multiple storage windows to view different storage locations at 
  5399. once.  When the state of your program changes, the contents of the Storage 
  5400. window updates to reflect the change. 
  5401.  
  5402. To scroll through memory, use one of the following methods: 
  5403.  
  5404. o Scroll bars 
  5405. o Up and Down arrow keys 
  5406. o PageUp and PageDown keys. 
  5407.  
  5408. The address of the cursor displays in the title bar of the Storage window. 
  5409.  
  5410. You can update the contents of storage or view the contents of storage at a new 
  5411. address location. 
  5412.  
  5413. Menu Bar Summary 
  5414.  
  5415. File 
  5416.           End your debugging session. 
  5417.  
  5418. Options 
  5419.           Set options that control how the storage content and addresses 
  5420.           display. 
  5421.  
  5422. Windows 
  5423.           Displays the active debugger windows. 
  5424.  
  5425. Help 
  5426.           Displays online help that compliments the information you get when 
  5427.           you press F1 or select a Help push button. 
  5428.  
  5429. Double-click on one of the following topics to find out how to update the 
  5430. contents of storage or specify a new address location: 
  5431.  
  5432. Related Information 
  5433.  
  5434. o Updating Storage 
  5435. o Specifying an Address Location 
  5436. o Expression Language Guidelines 
  5437.  
  5438.  
  5439. ΓòÉΓòÉΓòÉ 13.1. Options Menu ΓòÉΓòÉΓòÉ
  5440.  
  5441. Select choices from the Options menu to control how the storage contents and 
  5442. addresses display, control the display of the storage window control 
  5443. attributes, and end your debugging session. 
  5444.  
  5445. Menu Summary 
  5446.  
  5447. Monitor expression 
  5448.           Type the name of the variable or expression you want to monitor. 
  5449.  
  5450. Display style 
  5451.           Select the display format for the storage contents and addresses, and 
  5452.           change the columns per line that display. 
  5453.  
  5454. Fonts 
  5455.           Change the font used for text in the Storage window. 
  5456.  
  5457.  
  5458. ΓòÉΓòÉΓòÉ 13.1.1. Window Settings Cascading Choice ΓòÉΓòÉΓòÉ
  5459.  
  5460. Select the Window settings cascaded choice to change the context and address 
  5461. style of the Storage window. 
  5462.  
  5463.  Menu Summary 
  5464.  
  5465. Display style 
  5466.           Select the display format for the storage contents and addresses, and 
  5467.           change the columns per line that display. 
  5468.  
  5469. Fonts 
  5470.           Change the font used for text in the Storage window. 
  5471.  
  5472.  
  5473. ΓòÉΓòÉΓòÉ 13.1.1.1. Display Style Choice ΓòÉΓòÉΓòÉ
  5474.  
  5475. Select the Display style choice to display the format for the storage contents 
  5476. and storage addresses, and change the columns per line that display. You can 
  5477. select from several storage display styles. 
  5478.  
  5479. When you select Display style, the Display Style window displays. 
  5480.  
  5481.  
  5482. ΓòÉΓòÉΓòÉ 13.1.1.1.1. Display Style Window ΓòÉΓòÉΓòÉ
  5483.  
  5484. Use the Display Style window to select the parameters that control how the 
  5485. storage contents display and set how the storage addresses display. 
  5486.  
  5487. Content Style 
  5488.  
  5489. Select how you want the storage contents displayed. You can select from several 
  5490. storage display styles. 
  5491.  
  5492. To select the storage content style: 
  5493.  
  5494.  1. Scroll to the content style you want. 
  5495.  
  5496.  2. Select the content style. 
  5497.  
  5498.  3. The style becomes highlighted. 
  5499.  
  5500. Address Style 
  5501.  
  5502. Select how you want the address style displayed. 
  5503.  
  5504. To select an address style: 
  5505.  
  5506.  1. Scroll to the address style you want. 
  5507.  
  5508.  2. Select the address style. 
  5509.  
  5510.  3. The address style becomes highlighted. 
  5511.  
  5512. Columns per line 
  5513.  
  5514. Select the number of columns per line you want displayed in the Storage window. 
  5515.  
  5516. Use the Up or Down arrow keys to select the number of columns you want 
  5517. displayed in the Storage window. The available number of columns per line are 
  5518. 1-16. 
  5519.  
  5520. Column titles 
  5521.  
  5522. Select this check box to display the titles of the columns in the Storage 
  5523. window. 
  5524.  
  5525.  
  5526. ΓòÉΓòÉΓòÉ 13.1.2. Monitor Expression Choice ΓòÉΓòÉΓòÉ
  5527.  
  5528. Select the Monitor expression choice to type in the expression or variable that 
  5529. you want to monitor. 
  5530.  
  5531. When you select Monitor expression, the Monitor Expression In Storage window 
  5532. displays. 
  5533.  
  5534.  
  5535. ΓòÉΓòÉΓòÉ 13.1.2.1. Monitor Expression In Storage Window ΓòÉΓòÉΓòÉ
  5536.  
  5537. Use the Monitor Expression In Storage window to type in the address or 
  5538. expression you want to monitor. 
  5539.  
  5540. To specify an expression: 
  5541.  
  5542.  1. Type the name of the variable or expression you want to monitor in the 
  5543.     Address or Expression entry field. 
  5544.  
  5545. You must select an expression with: 
  5546.  
  5547. o A valid operand type 
  5548. o A valid operator 
  5549. o A valid typecasting operation 
  5550.  
  5551. To specify an address: 
  5552.  
  5553.  1. Type the name of the hexadecimal address you want to monitor in the Address 
  5554.     or Expression entry field. 
  5555.  
  5556. The expression evaluator used is based on the context.  For example if you 
  5557. display the Storage window by selecting the Monitor expression choice from the 
  5558. Monitors menu, the evaluator used is based on the context in the Monitor 
  5559. Expression window.  However, if you display the Storage window first and then 
  5560. select the Monitor expression choice from the Options menu of the Storage 
  5561. window, the evaluator used is based on the context of the stopping thread. 
  5562.  
  5563. Note:  You cannot look at variables that have been defined using the define 
  5564. preprocessor directive. If the variable is not in scope when the monitor is 
  5565. opened, the default address is displayed.  If the variable goes out of scope, 
  5566. the address is changed to a hex constant. 
  5567.  
  5568. If you enable the Enabled monitor check box, the monitor is updated to reflect 
  5569. the actual value in storage once the program stops. However, a disabled monitor 
  5570. suspends the updating of the storage monitor and the monitor remains the same 
  5571. value as when the monitor was disabled. 
  5572.  
  5573. Related Information 
  5574.  
  5575. o Expression Language Guidelines. 
  5576.  
  5577.  
  5578. ΓòÉΓòÉΓòÉ 13.1.2.2. Fonts Choice ΓòÉΓòÉΓòÉ
  5579.  
  5580. Select the Fonts choice to set the font you want to use for the text that 
  5581. displays in the Storage window. 
  5582.  
  5583.  
  5584. ΓòÉΓòÉΓòÉ 13.1.3. Control Choice ΓòÉΓòÉΓòÉ
  5585.  
  5586. Select the Control choice to display the Control window. 
  5587.  
  5588.  
  5589. ΓòÉΓòÉΓòÉ 13.1.4. Save Debugger Window Position Choice ΓòÉΓòÉΓòÉ
  5590.  
  5591. Select the Save window positions and sizes choice to save the position of all 
  5592. debugger windows. 
  5593.  
  5594. When you select this choice, the window positions are saved and the windows 
  5595. display in the selected positions. 
  5596.  
  5597. Note:  You do not need to save program profile for this choice to 
  5598.  
  5599.  
  5600. ΓòÉΓòÉΓòÉ 13.1.5. Close Debugger Choice ΓòÉΓòÉΓòÉ
  5601.  
  5602. Select the Close debugger choice to close the current debugging session. 
  5603.  
  5604. When you select the Close debugger choice, a message box prompts you to confirm 
  5605. that you want to end the debugging session. 
  5606.  
  5607.  
  5608. ΓòÉΓòÉΓòÉ 13.2. Windows Menu ΓòÉΓòÉΓòÉ
  5609.  
  5610. Select the Windows menu to display a list of all the open debugger windows. By 
  5611. selecting a window from the Windows menu, it is brought into focus and made the 
  5612. active window. Also, if the window is minimized, it is restored. 
  5613.  
  5614.  
  5615. ΓòÉΓòÉΓòÉ 13.2.1. Windows Choices ΓòÉΓòÉΓòÉ
  5616.  
  5617. Select this choice to make the window active. By selecting this choice, the 
  5618. window is brought into focus and made the active window. Also, if the window is 
  5619. minimized, it is restored. 
  5620.  
  5621.  
  5622. ΓòÉΓòÉΓòÉ 13.3. Help Menu ΓòÉΓòÉΓòÉ
  5623.  
  5624. Select choices from the Help menu to complement the online help information 
  5625. that you can get for the debugger when you press F1 or select the Help push 
  5626. button. 
  5627.  
  5628. Menu Summary 
  5629.  
  5630. Help index 
  5631.           An alphabetical index of all available debugger help topics. 
  5632.  
  5633. General help 
  5634.           Help information for the active window. 
  5635.  
  5636. Using help 
  5637.           How to use the help facility. 
  5638.  
  5639.  
  5640. ΓòÉΓòÉΓòÉ 13.3.1. Help Index Choice ΓòÉΓòÉΓòÉ
  5641.  
  5642. Select the Index choice display an alphabetical list of index topics for the 
  5643. debugger. Use the Find choice provided with the online help facility to locate 
  5644. topics in the index. 
  5645.  
  5646.  
  5647. ΓòÉΓòÉΓòÉ 13.3.2. General Help Choice ΓòÉΓòÉΓòÉ
  5648.  
  5649. Select the General help choice to display online help for the active debugger 
  5650. window. The online help panel displayed is the same panel that displays when 
  5651. you place your cursor inside the window and press F1. 
  5652.  
  5653.  
  5654. ΓòÉΓòÉΓòÉ 13.3.3. Using Help Choice ΓòÉΓòÉΓòÉ
  5655.  
  5656. Select the Using help choice to display online help information about the 
  5657. OS/2help facility. 
  5658.  
  5659.  
  5660. ΓòÉΓòÉΓòÉ <hidden> Storage Display Styles ΓòÉΓòÉΓòÉ
  5661.  
  5662. You can display storage content in the following value styles: 
  5663.  
  5664. o Hexadecimal and character text 
  5665. o Character text 
  5666. o 16-bit integer 
  5667. o 16-bit unsigned integer 
  5668. o 16-bit integer in hexadecimal (byte reversed) 
  5669. o 32-bit integer 
  5670. o 32-bit unsigned integer 
  5671. o 32-bit integer in hexadecimal (byte reversed) 
  5672. o 32-bit floating-point 
  5673. o 64-bit floating-point 
  5674. o 80-bit floating-point 
  5675. o 16-bit near pointers 
  5676. o 16:16-bit far pointers 
  5677. o 32-bit flat pointers. 
  5678.  
  5679. You can display storage in the following address styles: 
  5680.  
  5681. o Flat and 16:16 
  5682. o Flat only 
  5683. o 16:16 only. 
  5684.  
  5685. You can also change the number of columns per line that display. This number 
  5686. varies depending on the content style you have selected. 
  5687.  
  5688.  
  5689. ΓòÉΓòÉΓòÉ <hidden> Updating Storage ΓòÉΓòÉΓòÉ
  5690.  
  5691. To update the contents of storage in the Storage window, use one of the 
  5692. following methods: 
  5693.  
  5694. o Highlight the appropriate line and press Enter.  An entry field displays, 
  5695.   Type the new storage information in the entry field. 
  5696. o Double-click on the appropriate column.  An entry field displays. Type in the 
  5697.   new storage information. 
  5698.  
  5699. To move around in the Storage window, press the Tab key to move the selected 
  5700. column to the right or press Shift+Tab to move the selected column to the left. 
  5701. The up and down arrow keys move the highlighted line up and down. 
  5702.  
  5703. After you have made a change in the Storage window, click anywhere in the 
  5704. window and it saves your changes.  If you enter an incorrect storage address, a 
  5705. prompt box displays and the previous storage address is returned in the column. 
  5706.  
  5707.  
  5708. ΓòÉΓòÉΓòÉ <hidden> Specifying an Address Location ΓòÉΓòÉΓòÉ
  5709.  
  5710. To view the storage at a different address, double-click on the address which 
  5711. causes a Multiple Line Entry (MLE) field to display. Type the new address in 
  5712. the MLE field. You can choose to update either the Flat address field or the 
  5713. 16:16 (segmented) address field. The Storage window scrolls to the appropriate 
  5714. address. 
  5715.  
  5716.  
  5717. ΓòÉΓòÉΓòÉ 14. Breakpoint List Window ΓòÉΓòÉΓòÉ
  5718.  
  5719. Breakpoint List Window 
  5720.  
  5721. Use the Breakpoint List window to display a list of the breakpoints that have 
  5722. been set. The following information is also provided for each breakpoint. 
  5723.  
  5724. o The enablement state 
  5725. o The type of breakpoint 
  5726. o The position of the breakpoint 
  5727. o The conditions under which the breakpoint is activated. 
  5728.  
  5729. Menu Bar Summary 
  5730.  
  5731. File 
  5732.           End the debugging session. 
  5733.  
  5734. Edit 
  5735.           Delete, disable, or modify breakpoints. 
  5736.  
  5737. Set 
  5738.           Set and manipulate breakpoints in your program. 
  5739.  
  5740. Options 
  5741.           Control how items are displayed, change the font and sort items. 
  5742.  
  5743. Help 
  5744.           Displays online help that compliments the information you get when 
  5745.           you press F1 or select a Help push button. 
  5746.  
  5747. Related Information 
  5748.  
  5749. o Breakpoints Menu 
  5750. o Sort Window 
  5751.  
  5752.  
  5753. ΓòÉΓòÉΓòÉ 14.1. File Menu ΓòÉΓòÉΓòÉ
  5754.  
  5755. Select the choice from the File menu of the Breakpoint window to end the 
  5756. debugging session. 
  5757.  
  5758. Menu Summary 
  5759.  
  5760. Close debugger 
  5761.           End the debugging session. 
  5762.  
  5763.  
  5764. ΓòÉΓòÉΓòÉ 14.1.1. Close Debugger Choice ΓòÉΓòÉΓòÉ
  5765.  
  5766. Select the Close debugger choice to close your current debugging session. 
  5767.  
  5768. When you select the Close debugger choice, a message box prompts you to confirm 
  5769. that you want to end the debugging session. 
  5770.  
  5771.  
  5772. ΓòÉΓòÉΓòÉ 14.2. Edit Menu ΓòÉΓòÉΓòÉ
  5773.  
  5774. Select choices from the Edit menu to delete breakpoints, disable set 
  5775. breakpoints, and modify set breakpoints. 
  5776.  
  5777. Menu Bar Summary 
  5778.  
  5779. Delete 
  5780.           Delete a breakpoint. 
  5781.  
  5782. Disable 
  5783.           Disable a breakpoint. 
  5784.  
  5785. Modify 
  5786.           Modify a breakpoint. 
  5787.  
  5788. Delete all 
  5789.           Deletes all breakpoints. 
  5790.  
  5791.  
  5792. ΓòÉΓòÉΓòÉ 14.2.1. Delete Choice ΓòÉΓòÉΓòÉ
  5793.  
  5794. Deletes any highlighted breakpoints in the Breakpoint List window. 
  5795.  
  5796. To delete a breakpoint: 
  5797.  
  5798.  1. Highlight the breakpoint you want to delete. 
  5799.  
  5800.  2. Select the Delete choice. The breakpoint is deleted. 
  5801.  
  5802.  
  5803. ΓòÉΓòÉΓòÉ 14.2.2. Delete All Choice ΓòÉΓòÉΓòÉ
  5804.  
  5805. Deletes all breakpoints that are shown in the Breakpoint List window. 
  5806.  
  5807.  
  5808. ΓòÉΓòÉΓòÉ 14.2.3. Disable Choice ΓòÉΓòÉΓòÉ
  5809.  
  5810. Select the Disable choice to keep the breakpoint set but not effective.  This 
  5811. allows your program to run and not stop when the breakpoint is encountered. 
  5812.  
  5813. To disable a breakpoint: 
  5814.  
  5815.  1. Highlight the breakpoint you want to disable. 
  5816.  
  5817.  2. Select the Disable choice. The breakpoint becomes disabled. 
  5818.  
  5819.  
  5820. ΓòÉΓòÉΓòÉ 14.2.4. Modify Choice ΓòÉΓòÉΓòÉ
  5821.  
  5822. Use the Modify choice to change the breakpoints that have been set in your 
  5823. program. 
  5824.  
  5825. To modify a breakpoint: 
  5826.  
  5827.  1. Highlight the breakpoint you want to change. 
  5828.  
  5829.  2. Select the Modify choice. The breakpoint window that represents the type of 
  5830.     breakpoint displays. 
  5831.  
  5832.  3. Make the appropriate changes to the entry fields. 
  5833.  
  5834.  4. Select the OK push button to accept your changes and close the window. If 
  5835.     you want to make other changes, select the Set push button to accept the 
  5836.     changes and keep the window open. 
  5837.  
  5838.  
  5839. ΓòÉΓòÉΓòÉ 14.3. Set Menu ΓòÉΓòÉΓòÉ
  5840.  
  5841. Select choices from the Set menu to set breakpoints and to stop the execution 
  5842. of your program at any point. You can set as many breakpoints as you want. 
  5843.  
  5844. Breakpoints can be set from the Control window or from a source window. When 
  5845. you set a breakpoint in one view of your program, it is reflected in the other 
  5846. appropriate views. 
  5847.  
  5848. There are five types of breakpoints that you can set. You can customize the 
  5849. breakpoints using the various breakpoint windows. 
  5850.  
  5851. Menu Summary 
  5852.  
  5853. Line... 
  5854.           Set a line breakpoint to stop the execution of your program at a 
  5855.           specific line number. 
  5856.  
  5857. Function... 
  5858.           Set a function breakpoint to stop the execution of your program after 
  5859.           calling a specific function. 
  5860.  
  5861. Address... 
  5862.           Set an address breakpoint to stop the execution of your program at a 
  5863.           specific address. 
  5864.  
  5865. Change address... 
  5866.           Set a change address breakpoint to stop the execution of your program 
  5867.           when contents of memory at a given address changes. 
  5868.  
  5869. Load occurrence... 
  5870.           Set a load occurrence breakpoint to stop the execution of your 
  5871.           program after loading a DLL. 
  5872.  
  5873. You can also set simple line breakpoints. Double-click on one of the following 
  5874. for the procedures you use to set or clear simple line breakpoints: 
  5875.  
  5876. o Setting simple line breakpoints 
  5877. o Deleting simple line breakpoints. 
  5878.  
  5879.  
  5880. ΓòÉΓòÉΓòÉ 14.3.1. Address Choice ΓòÉΓòÉΓòÉ
  5881.  
  5882. Select the Address choice to stop the execution of your program at the selected 
  5883. address. When you select Address, the Set Address window displays. 
  5884.  
  5885.  
  5886. ΓòÉΓòÉΓòÉ 14.3.2. Change Address Choice ΓòÉΓòÉΓòÉ
  5887.  
  5888. Select the Change address choice to stop the execution of your program after 
  5889. the contents of memory at a given address changes. When you select Change 
  5890. address, the Set Change Address window displays. 
  5891.  
  5892.  
  5893. ΓòÉΓòÉΓòÉ 14.3.3. Function Choice ΓòÉΓòÉΓòÉ
  5894.  
  5895. Select the Function choice to stop the execution of your program after the 
  5896. function that you specify is called. When you select Function, the Set Function 
  5897. window displays. 
  5898.  
  5899.  
  5900. ΓòÉΓòÉΓòÉ 14.3.4. Line Choice ΓòÉΓòÉΓòÉ
  5901.  
  5902. Select the Line choice to stop the execution of your program at the line number 
  5903. you select. When you select Line, the Set Line window displays. 
  5904.  
  5905. You can also set simple line breakpoints. Double-click on one of the following 
  5906. for the procedures you use to set or clear simple line breakpoints: 
  5907.  
  5908. o Setting simple line breakpoints 
  5909. o Deleting simple line breakpoints. 
  5910.  
  5911.  
  5912. ΓòÉΓòÉΓòÉ 14.3.5. Load Occurrence Choice ΓòÉΓòÉΓòÉ
  5913.  
  5914. Select the Load Occurrence choice to stop the execution of your program after 
  5915. the DLL that you specify is loaded. When you select Load Occurrence, the Set 
  5916. Load Occurrence window displays. 
  5917.  
  5918.  
  5919. ΓòÉΓòÉΓòÉ 14.4. Options Menu ΓòÉΓòÉΓòÉ
  5920.  
  5921. Select choices from the Options menu to control which items are displayed, 
  5922. change the font, or sort items in the window. 
  5923.  
  5924. Sort 
  5925.           Sort the breakpoints. 
  5926.  
  5927. Display style 
  5928.           Choose how the breakpoints display. 
  5929.  
  5930. Fonts 
  5931.           Choose the font for the active window. 
  5932.  
  5933.  
  5934. ΓòÉΓòÉΓòÉ 14.4.1. Display Style Choice ΓòÉΓòÉΓòÉ
  5935.  
  5936. Select the Display style choice to select the characteristics of the breakpoint 
  5937. you want displayed. When you select Display style, the Display Style window 
  5938. displays. 
  5939.  
  5940.  
  5941. ΓòÉΓòÉΓòÉ 14.4.2. Sort Choice ΓòÉΓòÉΓòÉ
  5942.  
  5943. Select the Sort choice to sort the breakpoints by characteristics of the 
  5944. breakpoint. When you select Sort, the Sort window displays. 
  5945.  
  5946.  
  5947. ΓòÉΓòÉΓòÉ <hidden> Display Style Window ΓòÉΓòÉΓòÉ
  5948.  
  5949. Use the Display Style window to control how the items in the breakpoint list 
  5950. display. You can select the type of descriptive information you want to display 
  5951. for all of the breakpoint items. 
  5952.  
  5953. To change how breakpoint items display: 
  5954.  
  5955. o Select one or more of the items under Columns to select the information you 
  5956.   want to display. Each item causes a new column to be added to the Breakpoint 
  5957.   List window. 
  5958.  
  5959.  
  5960. ΓòÉΓòÉΓòÉ 14.4.3. Fonts Choice ΓòÉΓòÉΓòÉ
  5961.  
  5962. Select the Fonts choice to set the font you want to use for the text that 
  5963. displays in the Breakpoint List window. 
  5964.  
  5965. When you select Fonts, a Fonts window displays. 
  5966.  
  5967.  
  5968. ΓòÉΓòÉΓòÉ <hidden> Sort Window ΓòÉΓòÉΓòÉ
  5969.  
  5970. Use the Sort window to sort the breakpoints that have been set in your program. 
  5971. Breakpoints can be sorted according to any of the following categories: 
  5972.  
  5973. o Type 
  5974. o Executable 
  5975. o Source 
  5976. o File 
  5977. o Function 
  5978. o Line number 
  5979. o Address 
  5980. o Status 
  5981. o Thread 
  5982. o Condition 
  5983. o From 
  5984. o To 
  5985. o Every. 
  5986.  
  5987. Select  the category you want and select the OK push button. 
  5988.  
  5989.  
  5990. ΓòÉΓòÉΓòÉ 14.4.4. Control Choice ΓòÉΓòÉΓòÉ
  5991.  
  5992. Select the Control choice to display the Control window. 
  5993.  
  5994.  
  5995. ΓòÉΓòÉΓòÉ 14.5. Windows Menu ΓòÉΓòÉΓòÉ
  5996.  
  5997. Select the Windows menu to display a list of all the open debugger windows. By 
  5998. selecting a window from the Windows menu, it is brought into focus and made the 
  5999. active window. Also, if the window is minimized, it is restored. 
  6000.  
  6001.  
  6002. ΓòÉΓòÉΓòÉ 14.5.1. Windows Choices ΓòÉΓòÉΓòÉ
  6003.  
  6004. Select this choice to make the window active. By selecting this choice, the 
  6005. window is brought into focus and made the active window. Also, if the window is 
  6006. minimized, it is restored. 
  6007.  
  6008.  
  6009. ΓòÉΓòÉΓòÉ 14.6. Help Menu ΓòÉΓòÉΓòÉ
  6010.  
  6011. Select choices from the Help menu to complement the online help information 
  6012. that you can get for the debugger when you press F1 or select the Help push 
  6013. button. 
  6014.  
  6015. Menu Summary 
  6016.  
  6017. Help index 
  6018.           An alphabetical index of all available debugger help topics. 
  6019.  
  6020. General help 
  6021.           Help information for the active window. 
  6022.  
  6023. Using help 
  6024.           How to use the help facility. 
  6025.  
  6026.  
  6027. ΓòÉΓòÉΓòÉ 14.6.1. Help Index Choice ΓòÉΓòÉΓòÉ
  6028.  
  6029. Select the Index choice display an alphabetical list of index topics for the 
  6030. debugger. Use the Find choice provided with the online help facility to locate 
  6031. topics in the index. 
  6032.  
  6033.  
  6034. ΓòÉΓòÉΓòÉ 14.6.2. General Help Choice ΓòÉΓòÉΓòÉ
  6035.  
  6036. Select the General help choice to display online help for the active debugger 
  6037. window. The online help panel displayed is the same panel that displays when 
  6038. you place your cursor inside the window and press F1. 
  6039.  
  6040.  
  6041. ΓòÉΓòÉΓòÉ 14.6.3. Using Help Choice ΓòÉΓòÉΓòÉ
  6042.  
  6043. Select the Using help choice to display online help information about the 
  6044. OS/2help facility. 
  6045.  
  6046.  
  6047. ΓòÉΓòÉΓòÉ <hidden> Set Line Window ΓòÉΓòÉΓòÉ
  6048.  
  6049. Use the Set Line window to set a line breakpoint. Program execution stops when 
  6050. a specific source line is executed that contains a line breakpoint. 
  6051.  
  6052. Line Number Entry Field 
  6053.  
  6054. Type a line number in the Line number entry field. The breakpoint is set on the 
  6055. line number. 
  6056.  
  6057. For example, to set a line breakpoint on the line number 610, you would type 
  6058. the following in the Line number entry field: 
  6059.  
  6060.    610
  6061.  
  6062. Other Entry Fields 
  6063.  
  6064. For a description of the types of data you can type in the other entry fields, 
  6065. double-click on one of the following topics: 
  6066.  
  6067. o Executable 
  6068. o Source 
  6069. o File 
  6070. o Thread 
  6071. o From 
  6072. o To 
  6073. o Every 
  6074. o Expression 
  6075.  
  6076. Defer breakpoint Check Box 
  6077.  
  6078. Enable this check box if you want to set a breakpoint in a DLL that is not 
  6079. currently loaded. If your application consists of DLLs that are dynamically 
  6080. loaded, use this choice to set breakpoints in DLLs which have not been loaded 
  6081. yet. 
  6082.  
  6083. Note:  If your application consists of an EXE or preloaded DLLs, do not enable 
  6084. this choice. To debug preloaded DLLs, you must enable the Debug initialization 
  6085. code check box in the Program Startup window. 
  6086.  
  6087. If you set a deferred line breakpoint and the line is located in a template, 
  6088. the debugger sets the line breakpoint in all of the templates when the DLL is 
  6089. loaded. 
  6090.  
  6091. When a DLL is loaded and a deferred breakpoint has been set in the DLL, the 
  6092. state of the breakpoint changes from deferred to active. When a DLL is freed, 
  6093. any breakpoints that were set in the DLL change from the active state to 
  6094. deferred state. 
  6095.  
  6096. If you enter an invalid source, file, or line number, the debugger will not 
  6097. recognize the name as invalid and will be unable to activate the breakpoint. 
  6098. Therefore, the invalid breakpoint will remain in the deferred state even after 
  6099. the DLL is loaded. 
  6100.  
  6101. Refer to the Breakpoints List window for the current state of the breakpoints 
  6102. that have been set. 
  6103.  
  6104. Push Buttons 
  6105.  
  6106. Select the appropriate  push button to continue. 
  6107.  
  6108. Related Information 
  6109.  
  6110. o Setting simple line breakpoints 
  6111. o Deleting simple line breakpoints. 
  6112.  
  6113.  
  6114. ΓòÉΓòÉΓòÉ 14.6.4. Setting Simple Line Breakpoints ΓòÉΓòÉΓòÉ
  6115.  
  6116. To set a simple line breakpoint in all threads, double-click in the prefix area 
  6117. of an executable statement in the source windows: 
  6118.  
  6119. Source 
  6120.           Sets the breakpoint at a specific statement. 
  6121.  
  6122. Disassembly 
  6123.           Sets the breakpoint at a specific assembler instruction. 
  6124.  
  6125. Mixed 
  6126.           Sets the breakpoint at a specific assembler instruction. (The lines 
  6127.           of source code displayed in the Mixed window are treated as comment 
  6128.           lines only.) 
  6129.  
  6130. The prefix area turns red indicating that the breakpoint has been set. 
  6131.  
  6132. To set a thread-specific breakpoint for the thread shown in a source view, hold 
  6133. down the CTRL key as you double-click in the prefix area. 
  6134.  
  6135.  
  6136. ΓòÉΓòÉΓòÉ 14.6.5. Deleting Simple Line Breakpoints ΓòÉΓòÉΓòÉ
  6137.  
  6138. To remove a simple line breakpoint in all threads, double-click in a red prefix 
  6139. area of the Source, Disassembly, or Mixed window. The color changes indicating 
  6140. that the breakpoint cleared. 
  6141.  
  6142. If the prefix area turns gray instead, double-click again to make sure the 
  6143. breakpoint clears. 
  6144.  
  6145.  
  6146. ΓòÉΓòÉΓòÉ <hidden> Executable Entry Field ΓòÉΓòÉΓòÉ
  6147.  
  6148. To select a component from the Executable list: 
  6149.  
  6150.  1. Open the Executable list by selecting the arrow with your mouse. 
  6151.  
  6152.  2. Highlight the executable where you want to set the breakpoint. 
  6153.  
  6154.     OR 
  6155.  
  6156.     Type the executable name in the entry field. 
  6157.  
  6158.  
  6159. ΓòÉΓòÉΓòÉ <hidden> Source Entry Field ΓòÉΓòÉΓòÉ
  6160.  
  6161. To select a component from the Source list: 
  6162.  
  6163.  1. Open the Source list by selecting the arrow with your mouse. 
  6164.  
  6165.  2. Highlight the source where you want to set the breakpoint. 
  6166.  
  6167.     OR 
  6168.  
  6169.     Type the source name in the entry field. 
  6170.  
  6171.  
  6172. ΓòÉΓòÉΓòÉ <hidden> Line Number Entry Field ΓòÉΓòÉΓòÉ
  6173.  
  6174. To set a line breakpoint, type the line number in the Line number entry field. 
  6175. The breakpoint is set on the line number. 
  6176.  
  6177.  
  6178. ΓòÉΓòÉΓòÉ 14.6.6. Modify Choice ΓòÉΓòÉΓòÉ
  6179.  
  6180. Use the Modify choice to change the breakpoints that have been set in your 
  6181. program. 
  6182.  
  6183. To modify a breakpoint: 
  6184.  
  6185.  1. Highlight the breakpoint you want to change. 
  6186.  
  6187.  2. Select the Modify choice. 
  6188.  
  6189.  3. The entry fields contain the information pertaining to that breakpoint. 
  6190.     Make your changes to the entry fields. 
  6191.  
  6192.  4. Accepts the changes and close the window. If you want to make other 
  6193.     changes, select Set to accept the changes and keep the window open. 
  6194.  
  6195.  
  6196. ΓòÉΓòÉΓòÉ 15. Window Analysis Window ΓòÉΓòÉΓòÉ
  6197.  
  6198. Window Analysis Window 
  6199.  
  6200. Window Analysis gives you an understanding of Presentation Manager application 
  6201. windows. It presents both graphical and textual information about the windows 
  6202. of your application and lets you observe the relationships between windows. 
  6203.  
  6204. It allows you to view a three-dimensional image of your application's windows, 
  6205. characteristics of windows, and parent-child relationships between the windows. 
  6206.  
  6207. Your application creates many windows, directly or indirectly, to perform 
  6208. tasks. All of these windows are children or descendents of desktop and 
  6209. desktop-object windows. Windows created by the application being debugged are 
  6210. referred to as debuggee windows. 
  6211.  
  6212. Window Analysis consists of the following windows: 
  6213.  
  6214. o Window Analysis is the primary window. 
  6215. o Parent and Z-Order Tree is a secondary window. 
  6216. o Window Characteristics is a secondary window. 
  6217.  
  6218. The secondary windows provide information about the Window Analysis window. 
  6219. When you select an item in any of the three windows, it is reflected in the 
  6220. other two windows. If you close the Window Analysis window, the secondary 
  6221. windows closes. 
  6222.  
  6223. The Window Analysis presents an image of your debuggee windows. When this image 
  6224. displays, you can rotate the image to visually separate the windows, select a 
  6225. window on the image, and look at the detailed information about that window. 
  6226.  
  6227. The Window Analysis window is represented in a notebook format. The notebook is 
  6228. divided in two sections: desktop and desktop-object. The notebook has major and 
  6229. minor tabs. Major tabs correspond to the two major sections that are located at 
  6230. the bottom of the notebook. Major tab pages define the beginning of major 
  6231. sections and are called primary pages. Pages within major sections are called 
  6232. regular pages. They have minor tabs that are located at the right of the 
  6233. notebook. 
  6234.  
  6235. The images on the desktop and desktop-object primary pages represent children 
  6236. of the desktop window and desktop-object window, respectively. 
  6237.  
  6238. The images on the regular pages represent the child of the desktop or 
  6239. desktop-object window as a parent and all its descendents. 
  6240.  
  6241. To display the pages and tabs, you can use the notebook standard keyboard 
  6242. selection technique. Another method of displaying the pages is to double-click 
  6243. on the window on the primary page. 
  6244.  
  6245. You can select any window on a page by selecting the window. By using the Tab 
  6246. and BackTab keys, you can move the selection from window to another window. 
  6247. When you select an item in the Window Analysis window, it is reflected in the 
  6248. two secondary windows. 
  6249.  
  6250. Each page has a status line that is used to display sizes of a window that is 
  6251. selected on the page. 
  6252.  
  6253. Use the vertical slider or vertical arrows to rotate the page image vertically 
  6254. (around the x-axis). Use the horizontal slider to rotate the image horizontally 
  6255. (around the y-axis). 
  6256.  
  6257. The borders of the windows are drawn as follows: 
  6258.  
  6259. Screen 
  6260.           Solid thick line (only on a primary page) 
  6261.  
  6262. Visible window 
  6263.           Solid thin line 
  6264.  
  6265. Invisible window 
  6266.           Dashed thin line 
  6267.  
  6268. Menu Bar Summary 
  6269.  
  6270. File 
  6271.           End your debugging session. 
  6272.  
  6273. Monitors 
  6274.           View the secondary windows of Window Analysis. 
  6275.  
  6276. Options 
  6277.           Control the way that Window Analysis displays. 
  6278.  
  6279. Windows 
  6280.           Displays the active debugger windows. 
  6281.  
  6282. Help 
  6283.           Displays online help that compliments the information you get when 
  6284.           you press F1 or select a Help push button. 
  6285.  
  6286. Related Information 
  6287.  
  6288. o Parent and Z-Order Tree 
  6289. o Window Characteristics 
  6290.  
  6291.  
  6292. ΓòÉΓòÉΓòÉ <hidden> Desktop ΓòÉΓòÉΓòÉ
  6293.  
  6294. The desktop section contains a primary page and several regular pages. The 
  6295. primary page of the desktop section contains the image of the desktop window 
  6296. and debuggee windows that are children of the desktop window. The primary page 
  6297. has a major tab with the name Desktop at the bottom of the notebook. The major 
  6298. tab defines the beginning of the desktop section. 
  6299.  
  6300. The regular page of the desktop section contains the image of the child of the 
  6301. desktop as a parent and all its descendents. The regular page has a minor tab 
  6302. with the image of the desktop window child and its descendents or a text. The 
  6303. minor tabs are at the right of the notebook. 
  6304.  
  6305. Note:  The sizes and distribution of windows may cause the image to be 
  6306. displayed as a small dot on the screen, or number of dots positioned according 
  6307. to the z-order. This may occur as a consequence of minimizing the debuggee 
  6308. windows, or if the sizes of windows are zero. 
  6309.  
  6310.  
  6311. ΓòÉΓòÉΓòÉ <hidden> Desktop-Object Windows ΓòÉΓòÉΓòÉ
  6312.  
  6313. The desktop-object section contains a primary page and a number of regular 
  6314. pages. The primary page of the desktop-object section contains the image of 
  6315. debuggee windows that are children of the Desktop-object window. The primary 
  6316. page has a major tab with the name "Desktop-object" at the bottom of the 
  6317. notebook. The major tab defines the beginning of the desktop-object section. 
  6318. ;p. The regular page of the desktop-object section contains the image of the 
  6319. child of the desktop-object as a parent and all its descendents. The regular 
  6320. page has a minor tab with a text on it. The minor tab is at the right of the 
  6321. notebook. The desktop-object part is optional. 
  6322.  
  6323. Note:  The sizes and distribution of windows may cause the image to be 
  6324. displayed as a small dot on the screen, or number of dots positioned according 
  6325. to  the z-order. This is a consequence of sizes of object windows often being 
  6326. zero. 
  6327.  
  6328.  
  6329. ΓòÉΓòÉΓòÉ 15.1. Monitors Menu ΓòÉΓòÉΓòÉ
  6330.  
  6331. Select choices from the Monitors menu to view the secondary windows of Window 
  6332. Analysis. 
  6333.  
  6334. Menu Summary 
  6335.  
  6336. Parent and z-order tree 
  6337.           Display the Parent and Z_Order Tree window to view the relationships 
  6338.           between the debuggee window and non-debuggee windows. 
  6339.  
  6340. Window characteristics 
  6341.           Display the Window Characteristics window to view characteristics of 
  6342.           the window such as class, handle, and so on. 
  6343.  
  6344.  
  6345. ΓòÉΓòÉΓòÉ 15.1.1. Parent and Z-Order Tree Choice ΓòÉΓòÉΓòÉ
  6346.  
  6347. Select the Parent and z-order tree choice to show the relationships between the 
  6348. following windows: 
  6349.  
  6350. o Debuggee 
  6351. o Non-debuggee 
  6352. o Debuggee and non-debuggee. 
  6353.  
  6354. Note:  Items selected in this window are reflected in the other two windows 
  6355. (Window Analysis and Window Characteristics). 
  6356.  
  6357. When you select Parent and z-order tree, the Parent and Z-Order Tree window 
  6358. displays. 
  6359.  
  6360.  
  6361. ΓòÉΓòÉΓòÉ 15.1.1.1. Parent and Z-Order Tree Window ΓòÉΓòÉΓòÉ
  6362.  
  6363. The Parent and Z-Order Tree window shows the relationship between the following 
  6364. windows: 
  6365.  
  6366. o Debuggee 
  6367. o Non-debuggee 
  6368. o Debuggee and non-debuggee. 
  6369.  
  6370. Note:  Items selected in this window are reflected in the other two windows 
  6371. (Window Analysis and Window Characteristics). 
  6372.  
  6373. The non-debuggee windows shown in the Parent and Z-Order Tree window are the 
  6374. desktop and desktop-object windows and their children which are not debuggee 
  6375. windows. 
  6376.  
  6377. Menu Summary 
  6378.  
  6379. Options 
  6380.           Control how the items in the Parent and Z-order Tree window display. 
  6381.  
  6382. Help 
  6383.           Displays online help that compliments the information you get when 
  6384.           you press F1 or select a Help push button. 
  6385.  
  6386.  
  6387. ΓòÉΓòÉΓòÉ 15.1.1.2. Options Menu ΓòÉΓòÉΓòÉ
  6388.  
  6389. Select choices from the Options menu to control the display of the window class 
  6390. and handle and select the fonts. 
  6391.  
  6392. Menu Summary 
  6393.  
  6394. Display style 
  6395.           Select to display the window class and window handle. 
  6396.  
  6397. Fonts 
  6398.           Select the font you want to use for the text in the active window. 
  6399.  
  6400.  
  6401. ΓòÉΓòÉΓòÉ 15.1.1.2.1. Display Style Choice ΓòÉΓòÉΓòÉ
  6402.  
  6403. Select the Display style choice to display the window class and window handle 
  6404. in the Parent and Z-OrderTree window. 
  6405.  
  6406. When you select Display style, the Display Style window displays. 
  6407.  
  6408.  
  6409. ΓòÉΓòÉΓòÉ 15.1.1.2.1.1. Display Style Window ΓòÉΓòÉΓòÉ
  6410.  
  6411. Use the Display Style window to select which items you want to display in the 
  6412. Parent and Z-Order Tree window. 
  6413.  
  6414. Visible Characteristics 
  6415.  
  6416. Select one of these radio button to select the information you want displayed 
  6417. for each window: 
  6418.  
  6419. Window class The registered class of the window. 
  6420.  
  6421. Window handle The handle of the window. 
  6422.  
  6423. Both window handle and class The handle and class of the window. 
  6424.  
  6425. Include non-debuggee desktop children 
  6426.  
  6427. Select this box if you want to display all the non-debuggee desktop children. 
  6428.  
  6429. Include non-debuggee desktop-object children 
  6430.  
  6431. Select this check box to display all of the non-debuggee desktop-object 
  6432. children. 
  6433.  
  6434. Note:  This choice is only available if you selected Desktop-object windows 
  6435. from the Window Analysis window. 
  6436.  
  6437.  
  6438. ΓòÉΓòÉΓòÉ 15.1.2. Fonts Choice ΓòÉΓòÉΓòÉ
  6439.  
  6440. Select the Fonts choice to set the font you want to use for the text that 
  6441. displays in the Window Analysis window. 
  6442.  
  6443. When you select Fonts, a Fonts window displays. 
  6444.  
  6445.  
  6446. ΓòÉΓòÉΓòÉ 15.1.3. Window Characteristics Choice ΓòÉΓòÉΓòÉ
  6447.  
  6448. Select the Window characteristics choice to view the characteristics of the 
  6449. debuggee windows. 
  6450.  
  6451. Note:  Items selected in this window are reflected in the other two windows 
  6452. (Window Analysis and Parent and Z-Order Tree). 
  6453.  
  6454. When you select Window characteristics, the Window Characteristics window 
  6455. displays. 
  6456.  
  6457.  
  6458. ΓòÉΓòÉΓòÉ 15.1.3.1. Window Characteristics Window ΓòÉΓòÉΓòÉ
  6459.  
  6460. The Window Characteristics window displays the characteristics of the debuggee 
  6461. windows. The Window Characteristics window displays in a table format with each 
  6462. row representing a different debuggee window and each column representing a 
  6463. different characteristic. The rows listed in the Window Characteristics window 
  6464. reflect the debuggee windows on the current page of the Window Analysis window. 
  6465.  
  6466. Note:  Items selected in this window are reflected in the other two windows 
  6467. (Window Analysis and Parent and Z-Order Tree). 
  6468.  
  6469. Menu Summary 
  6470.  
  6471. Options 
  6472.           Control which characteristics display. 
  6473.  
  6474. Help 
  6475.           Displays online help that compliments the information you get when 
  6476.           you press F1 or select a Help push button. 
  6477.  
  6478.  
  6479. ΓòÉΓòÉΓòÉ 15.1.4. Options Menu ΓòÉΓòÉΓòÉ
  6480.  
  6481. Select choices from the Options menu to control the display of window 
  6482. characteristics, titles in the window, and fonts for the window. 
  6483.  
  6484. Menu Summary 
  6485.  
  6486. Display style 
  6487.           Select which window characteristics display. 
  6488.  
  6489. Window controls 
  6490.           Turn titles on or off in the Window Characteristics window. 
  6491.  
  6492. Fonts 
  6493.           Select the font you want to use for the text in the active window. 
  6494.  
  6495.  
  6496. ΓòÉΓòÉΓòÉ 15.1.5. Display Style Choice ΓòÉΓòÉΓòÉ
  6497.  
  6498. Select the Display style choice to choose which window characteristics you want 
  6499. to display in the Window Characteristics window. 
  6500.  
  6501. When you select Display style, the Display Style window displays. 
  6502.  
  6503.  
  6504. ΓòÉΓòÉΓòÉ 15.1.6. Window Controls Choice ΓòÉΓòÉΓòÉ
  6505.  
  6506. Select the window controls choice to choose whether titles display in the 
  6507. Window Characteristics window. 
  6508.  
  6509. When you select Window controls, the Window Controls window displays. 
  6510.  
  6511.  
  6512. ΓòÉΓòÉΓòÉ 15.1.7. Window Controls Window ΓòÉΓòÉΓòÉ
  6513.  
  6514. Use the Window controls window to turn the titles on or off in the Window 
  6515. Characteristics window. 
  6516.  
  6517.  Display titles 
  6518.  
  6519. Select this check box if you want titles to be displayed in the window. 
  6520.  
  6521. Select the appropriate  push button to continue. 
  6522.  
  6523.  
  6524. ΓòÉΓòÉΓòÉ 15.1.8. Display Style Window ΓòÉΓòÉΓòÉ
  6525.  
  6526. Use the Display Style window to select the characteristics you want to display 
  6527. in the Window Characteristics window. 
  6528.  
  6529. Visible characteristics 
  6530.  
  6531. Select the characteristics you want to display in the Window Characteristics 
  6532. window by selecting the names of the titles. The highlighted names will be 
  6533. displayed in the Window Characteristics window. 
  6534.  
  6535. Select one of the push buttons to continue. 
  6536.  
  6537.  
  6538. ΓòÉΓòÉΓòÉ <hidden> Characteristics List ΓòÉΓòÉΓòÉ
  6539.  
  6540. Class 
  6541.           Window class of the window 
  6542.  
  6543. Hwnd 
  6544.           Window handle in 32-bit hex format 
  6545.  
  6546. Hwnd (16:16) 
  6547.           Window handle in 16:16-bit hex format 
  6548.  
  6549. Parent 
  6550.           Parent window handle of the window in 32-bit hex format 
  6551.  
  6552. Parent (16:16) 
  6553.           Parent window handle of the window in 16:16-bit hex format 
  6554.  
  6555. Owner 
  6556.           Owner window handle of the window in 32-bit hex format 
  6557.  
  6558. Owner (16:16) 
  6559.           Owner window handle of the window in 16:16-bit hex format 
  6560.  
  6561. X 
  6562.           X-coordinate of the position of the window relative to the desktop 
  6563.  
  6564. Y 
  6565.           Y-coordinate of the position of the window relative to the desktop 
  6566.  
  6567. Width 
  6568.           Width of the window 
  6569.  
  6570. Height 
  6571.           Height of the window 
  6572.  
  6573. X' 
  6574.           X-coordinate of the position of the window relative to its parent 
  6575.           window 
  6576.  
  6577. Y' 
  6578.           Y-coordinate of the position of the window relative to its parent 
  6579.           window 
  6580.  
  6581. PID 
  6582.           Process identification of the window 
  6583.  
  6584. TID 
  6585.           Thread identification of the window 
  6586.  
  6587. Text 
  6588.           Window text (valid only for windows with the class of WC_BUTTON, 
  6589.           WC_STATIC and WC_TITLEBAR) 
  6590.  
  6591. Active 
  6592.           Whether the window is the active window 
  6593.  
  6594. Focus 
  6595.           Whether the window has the focus 
  6596.  
  6597. Enabled 
  6598.           Whether the window is enabled 
  6599.  
  6600. Checked 
  6601.           Whether the window is checked (only for windows with a class of 
  6602.           WC_BUTTON, WC_STATIC and WC_TITLEBAR) 
  6603.  
  6604. Visible 
  6605.           Whether the window has its visibility set on 
  6606.  
  6607. Showing 
  6608.           Whether the window is showing 
  6609.  
  6610. Function 
  6611.           Address of the window procedure 
  6612.  
  6613. Function name 
  6614.           Name of the window procedure 
  6615.  
  6616. Thunk function 
  6617.           Address of the thunk function of the window 
  6618.  
  6619. Class function 
  6620.           Address of the function for the class of the window 
  6621.  
  6622. Model 
  6623.           The memory model of the window 
  6624.  
  6625. Msgq 
  6626.           The handle of message queue of the window 
  6627.  
  6628. Style 
  6629.           The window style settings 
  6630.  
  6631. HHeap 
  6632.           The heap handle used by the child window of the window 
  6633.  
  6634. Hwnd focus 
  6635.           The window handle of the child window of the window that last had the 
  6636.           focus in 32-bit HEX format 
  6637.  
  6638. Hwnd focus (16:16) 
  6639.           The window handle of the child window of the window that last had the 
  6640.           focus in 16:16-bit hex format 
  6641.  
  6642. User 
  6643.           A ULONG value for applications to use at the offset QWL_USER in the 
  6644.           windows of some preregistered window classes 
  6645.  
  6646. Defbutton 
  6647.           The window handle of the default push button for a dialog in 32-bit 
  6648.           hex format 
  6649.  
  6650. Defbutton (16:16) 
  6651.           The window handle of the default push button for a dialog in 
  6652.           16:16-bit hex format 
  6653.  
  6654. ID 
  6655.           The window identity of the window. The value of the id parameter of 
  6656.           the WinCreateWindow function. 
  6657.  
  6658. Flags 
  6659.           The frame window flags of the window 
  6660.  
  6661. Result 
  6662.           The dialog result parameter, as established by the WinDismissDlg 
  6663.           function 
  6664.  
  6665. X Restore 
  6666.           X coordinate of the position to which the window is restored 
  6667.  
  6668. Y Restore 
  6669.           Y coordinate of the position to which the window is restored 
  6670.  
  6671. CX Restore 
  6672.           Width to which the window is restored 
  6673.  
  6674. CY Restore 
  6675.           Height to which the window is restored 
  6676.  
  6677. X Minimize 
  6678.           X coordinate of the position to which the window is minimized If this 
  6679.           value is -1 the window has not been minimized 
  6680.  
  6681. Y Minimize 
  6682.           Y coordinate of the position to which the window is minimized If this 
  6683.           value is -1 the window has not been minimized 
  6684.  
  6685. Minimized 
  6686.           The window is minimized 
  6687.  
  6688. Maximized 
  6689.           The window is maximized. 
  6690.  
  6691.  
  6692. ΓòÉΓòÉΓòÉ 15.1.9. Fonts Choice ΓòÉΓòÉΓòÉ
  6693.  
  6694. Select the Fonts choice to set the font you want to use for the text that 
  6695. displays in the Window Characteristics window. 
  6696.  
  6697. When you select Fonts, a Fonts window displays. 
  6698.  
  6699.  
  6700. ΓòÉΓòÉΓòÉ 15.1.10. Save Window Positions and Sizes Choice ΓòÉΓòÉΓòÉ
  6701.  
  6702. Select the Save window positions and sizes choice to save the position of all 
  6703. debugger windows. 
  6704.  
  6705. When you select this choice, the window positions are saved and the windows 
  6706. display in the selected positions. 
  6707.  
  6708.  
  6709. ΓòÉΓòÉΓòÉ 15.1.11. Close Debugger Choice ΓòÉΓòÉΓòÉ
  6710.  
  6711. Select the Close debugger choice to close your current debugging session. 
  6712.  
  6713. When you select the Close debugger choice, a message box prompts you to confirm 
  6714. that you want to end the debugging session. 
  6715.  
  6716.  
  6717. ΓòÉΓòÉΓòÉ 15.2. Options Menu ΓòÉΓòÉΓòÉ
  6718.  
  6719. Select choices from the Options menu to control the display of bitmaps and 
  6720. desktop-object windows and to rotate the image to the center or to the default 
  6721. position. 
  6722.  
  6723. Menu Summary 
  6724.  
  6725. Bitmaps 
  6726.           Display the bitmaps on the notebook tabs. 
  6727.  
  6728. Desktop-object windows 
  6729.           Display the desktop-object windows in the Window Analysis and Parent 
  6730.           and Z-Order Tree windows. 
  6731.  
  6732. Rotate to center 
  6733.           Rotate the image on the window to the center position. 
  6734.  
  6735. Rotate to default 
  6736.           Rotate the image on the window to the default position. 
  6737.  
  6738.  
  6739. ΓòÉΓòÉΓòÉ 15.2.1. Bitmaps Choice ΓòÉΓòÉΓòÉ
  6740.  
  6741. Enable the Bitmaps choice to display bitmaps on the tabs of the notebook in the 
  6742. Window Analysis window. When bitmaps are enabled, a bitmap displays on the tab 
  6743. if the window is shown on the screen. If the window is hidden, text displays on 
  6744. the tab. (For desktop-object section, this is always the case). The text 
  6745. displays on the tabs when bitmaps are disabled. The text is the letter "D" 
  6746. (Desktop) or letter "O" (Desktop-object) concatenated with the number of a 
  6747. regular page in the section. 
  6748.  
  6749.  
  6750. ΓòÉΓòÉΓòÉ 15.2.2. Desktop-Object Windows Choice ΓòÉΓòÉΓòÉ
  6751.  
  6752. You can enable or disable the Desktop-object windows choice to include the 
  6753. desktop-object windows in the Window Analysis window. 
  6754.  
  6755.  
  6756. ΓòÉΓòÉΓòÉ 15.2.3. Rotate to Center Choice ΓòÉΓòÉΓòÉ
  6757.  
  6758. Select the Rotate to center choice to center the image on the Window Analysis 
  6759. window. 
  6760.  
  6761.  
  6762. ΓòÉΓòÉΓòÉ 15.2.4. Rotate to Default Choice ΓòÉΓòÉΓòÉ
  6763.  
  6764. Select the Rotate to default choice to rotate the image to the default position 
  6765. in the Window Analysis window 
  6766.  
  6767.  
  6768. ΓòÉΓòÉΓòÉ 15.2.5. Save Debugger Window Position Choice ΓòÉΓòÉΓòÉ
  6769.  
  6770. Select the Save window positions and sizes choice to save the position of all 
  6771. debugger windows. 
  6772.  
  6773. When you select this choice, the window positions are saved and the windows 
  6774. display in the selected positions. 
  6775.  
  6776. Note:  You do not need to save program profile for this choice to 
  6777.  
  6778.  
  6779. ΓòÉΓòÉΓòÉ 15.2.6. Control Choice ΓòÉΓòÉΓòÉ
  6780.  
  6781. Select the Control choice to display the Control window. 
  6782.  
  6783.  
  6784. ΓòÉΓòÉΓòÉ 15.3. Windows Menu ΓòÉΓòÉΓòÉ
  6785.  
  6786. Select the Windows menu to display a list of all the open debugger windows. By 
  6787. selecting a window from the Windows menu, it is brought into focus and made the 
  6788. active window. Also, if the window is minimized, it is restored. 
  6789.  
  6790.  
  6791. ΓòÉΓòÉΓòÉ 15.3.1. Windows Choices ΓòÉΓòÉΓòÉ
  6792.  
  6793. Select this choice to make the window active. By selecting this choice, the 
  6794. window is brought into focus and made the active window. Also, if the window is 
  6795. minimized, it is restored. 
  6796.  
  6797.  
  6798. ΓòÉΓòÉΓòÉ 15.4. Help Menu ΓòÉΓòÉΓòÉ
  6799.  
  6800. Select choices from the Help menu to complement the online help information 
  6801. that you can get for the debugger when you press F1 or select the Help push 
  6802. button. 
  6803.  
  6804.  Menu Summary 
  6805.  
  6806. Help index 
  6807.           An alphabetical index of all available debugger help topics. 
  6808.  
  6809. General help 
  6810.           Help information for the active window. 
  6811.  
  6812. Using help 
  6813.           How to use the help facility. 
  6814.  
  6815.  
  6816. ΓòÉΓòÉΓòÉ 15.4.1. Help Index Choice ΓòÉΓòÉΓòÉ
  6817.  
  6818. Select the Index choice display an alphabetical list of index topics for the 
  6819. debugger. Use the Find choice provided with the online help facility to locate 
  6820. topics in the index. 
  6821.  
  6822.  
  6823. ΓòÉΓòÉΓòÉ 15.4.2. General Help Choice ΓòÉΓòÉΓòÉ
  6824.  
  6825. Select the General help choice to display online help for the active debugger 
  6826. window. The online help panel displayed is the same panel that displays when 
  6827. you place your cursor inside the window and press F1. 
  6828.  
  6829.  
  6830. ΓòÉΓòÉΓòÉ 15.4.3. Using Help Choice ΓòÉΓòÉΓòÉ
  6831.  
  6832. Select the Using help choice to display online help information about the 
  6833. OS/2help facility. 
  6834.  
  6835.  
  6836. ΓòÉΓòÉΓòÉ 16. Message Queue Window ΓòÉΓòÉΓòÉ
  6837.  
  6838. Message Queue Window 
  6839.  
  6840. The Message Queue Monitor window displays Presentation Manager messages 
  6841. associated with a Presentation Manager application. It presents formatted 
  6842. messages in a list as they occur. Using the message queue monitor, you can 
  6843. control: 
  6844.  
  6845. o How the information displays for each message. 
  6846. o How message parameters are formatted. 
  6847. o Which messages are monitored. 
  6848. o Which windows have their messages monitored. 
  6849. o Which message queues have their messages monitored. 
  6850. o How the user generated messages display. 
  6851.  
  6852. Menu Bar Summary 
  6853.  
  6854. File 
  6855.           End the debugging session. 
  6856.  
  6857. Options 
  6858.           Suspend messages, clear messages, resize the columns, and access 
  6859.           various utility windows where you can set message queue options. 
  6860.           These options control how messages are monitored and displayed. 
  6861.  
  6862. Windows 
  6863.           Displays the active debugger windows. 
  6864.  
  6865. Help 
  6866.           Displays online help that compliments the information you get when 
  6867.           you press F1 or select a Help push button. 
  6868.  
  6869.  
  6870. ΓòÉΓòÉΓòÉ 16.1. File Menu ΓòÉΓòÉΓòÉ
  6871.  
  6872. Select the choice from the File menu of the Message Queue window to end the 
  6873. debugging session. 
  6874.  
  6875. Menu Summary 
  6876.  
  6877. Close debugger 
  6878.           End the debugging session. 
  6879.  
  6880.  
  6881. ΓòÉΓòÉΓòÉ 16.1.1. Close Debugger Choice ΓòÉΓòÉΓòÉ
  6882.  
  6883. Select the Close debugger choice to close your current debugging session. 
  6884.  
  6885. When you select the Close debugger choice, a message box prompts you to confirm 
  6886. that you want to end the debugging session. 
  6887.  
  6888.  
  6889. ΓòÉΓòÉΓòÉ 16.2. Options Menu ΓòÉΓòÉΓòÉ
  6890.  
  6891. Select choices from the Options menu to suspend messages, clear messages, 
  6892. resize the columns, and select what you want to monitor. 
  6893.  
  6894. Menu Summary 
  6895.  
  6896. Suspend 
  6897.           Suspends messages from being added to the Message Queue Monitor 
  6898.           window. 
  6899.  
  6900. Clear 
  6901.           Delete all the messages that display in the Message Queue Monitor 
  6902.           window. 
  6903.  
  6904. Resize column width 
  6905.           Resize the columns in the Message Queue Monitor window. 
  6906.  
  6907. Monitor messages 
  6908.           Select which Presentation Manager messages you want monitored and 
  6909.           displayed. 
  6910.  
  6911. Monitor windows 
  6912.           Select which windows have their messages monitored. 
  6913.  
  6914. Monitor queues 
  6915.           Select which message queues have their messages monitored. 
  6916.  
  6917. Format parameters 
  6918.           Select how Presentation Manager message parameters display. 
  6919.  
  6920. Define messages 
  6921.           Select user-defined messages. 
  6922.  
  6923. Display style 
  6924.           Select the information you want to display in the Message Queue 
  6925.           Monitor window. 
  6926.  
  6927. Fonts 
  6928.           Select the font you want to use for the text in the active window. 
  6929.  
  6930.  
  6931. ΓòÉΓòÉΓòÉ 16.2.1. Suspend Choice ΓòÉΓòÉΓòÉ
  6932.  
  6933. Select the Suspend choice to stop any new messages from being added to the 
  6934. Message Queue Monitor window. 
  6935.  
  6936.  
  6937. ΓòÉΓòÉΓòÉ 16.2.2. Clear Choice ΓòÉΓòÉΓòÉ
  6938.  
  6939. Select the Clear choice to clear all the messages in the Message Queue Monitor 
  6940. window. 
  6941.  
  6942.  
  6943. ΓòÉΓòÉΓòÉ 16.2.3. Resize Column Width Choice ΓòÉΓòÉΓòÉ
  6944.  
  6945. Select the Resize column width choice to recalculate the widths of the columns 
  6946. in the Message Queue Monitor window. 
  6947.  
  6948. Note:  This option is available only when the automatic column resizing choice 
  6949. is not selected in the Display Style window. 
  6950.  
  6951.  
  6952. ΓòÉΓòÉΓòÉ 16.2.4. Monitor Messages Choice ΓòÉΓòÉΓòÉ
  6953.  
  6954. The Monitor messages choice lets you select which Presentation Manager messages 
  6955. you want monitored. 
  6956.  
  6957. When you select Monitor Messages, the Monitor Messages window displays. 
  6958.  
  6959.  
  6960. ΓòÉΓòÉΓòÉ 16.2.5. Monitor Messages Window ΓòÉΓòÉΓòÉ
  6961.  
  6962. Use the Monitor Messages window to specify the messages you want monitored. 
  6963.  
  6964. The Monitor Messages window consists of the following: 
  6965.  
  6966. Defined Message IDs 
  6967.  
  6968. These are the pre-defined and user-defined messages. Each message displays as a 
  6969. name and hex number. You can select multiple messages for monitoring. 
  6970.  
  6971. Sort 
  6972.  
  6973. o Select the Name button to sort the message names  alphabetically. 
  6974. o Select the ID button to sort the message IDs numerically. 
  6975.  
  6976. Undefined Messages IDs 
  6977.  
  6978. o Select the Include WM_USER check box to include all undefined messages that 
  6979.   are in the range WM_USER and above. 
  6980. o Select the Include non WM_USER check box to include all undefined messages 
  6981.   that are in the range less than WM_USER. 
  6982.  
  6983. Include all message IDs 
  6984.  
  6985. Select the Include all message IDs check box to include all messages. When this 
  6986. check box is enabled, the defined and undefined message selections are 
  6987. disabled. 
  6988.  
  6989. Define Messages IDs 
  6990.  
  6991. Select this button and the Define Messages window displays. 
  6992.  
  6993. Monitor 
  6994.  
  6995. o Select the Messages to application check box to monitor messages that are 
  6996.   received by an application. 
  6997. o Select the Messages from application check box to monitor messages that are 
  6998.   dispatched by an application. 
  6999. o Select the Post messages check box to monitor post messages. 
  7000. o Select the Send messages check box to monitor send messages. 
  7001.  
  7002. Select the appropriate push button to continue. 
  7003.  
  7004.  
  7005. ΓòÉΓòÉΓòÉ 16.2.6. Monitor Windows Choice ΓòÉΓòÉΓòÉ
  7006.  
  7007. The monitor windows choice lets you select which windows have their messages 
  7008. monitored. 
  7009.  
  7010. When you select Monitor windows, the Monitor Windows window displays. 
  7011.  
  7012.  
  7013. ΓòÉΓòÉΓòÉ 16.2.7. Monitor Windows Window ΓòÉΓòÉΓòÉ
  7014.  
  7015. Use the Monitor Windows window to specify the windows you want monitored. 
  7016.  
  7017. You may identify specific windows you want to monitor by using the Window 
  7018. Analysis window. 
  7019.  
  7020. The Monitor Windows window consists of the following: 
  7021.  
  7022. Windows 
  7023.  
  7024. Each window displays with the class and handle. You can select multiple windows 
  7025. for monitoring. 
  7026.  
  7027. Sort 
  7028.  
  7029. o Select the Class button to sort the window names alphabetically. 
  7030. o Select the Hwnd button to sort the window handles in numerical order. 
  7031. o Select the Parent and z-order button to sort the window handles to show the 
  7032.   parent and z-order relationship of application windows. 
  7033.  
  7034. Monitor all windows 
  7035.  
  7036. Select the Monitor all windows check box to monitor all the windows. This 
  7037. disables individual selection. 
  7038.  
  7039. Select the appropriate push button to continue. 
  7040.  
  7041.  
  7042. ΓòÉΓòÉΓòÉ 16.2.8. Monitor Queues Choice ΓòÉΓòÉΓòÉ
  7043.  
  7044. The Monitor queues choice lets you select which message queues are being 
  7045. monitored. 
  7046.  
  7047. When you select Monitor windows, the Monitor Message Queue window displays. 
  7048.  
  7049.  
  7050. ΓòÉΓòÉΓòÉ 16.2.9. Monitor Message Queue Window ΓòÉΓòÉΓòÉ
  7051.  
  7052. Use the Monitor Message Queue window to specify the message queues you want 
  7053. monitored. 
  7054.  
  7055. The Monitor Message Queue window consists of the following: 
  7056.  
  7057. Message Queue 
  7058.  
  7059. This section contains a list of the message queues. You can select multiple 
  7060. queues. 
  7061.  
  7062. Sort 
  7063.  
  7064. o Select the HMQ button to sort the message queues by message queue handles. 
  7065. o Select the TID button to sort the message queues by thread id. 
  7066.  
  7067. Monitor all message queues 
  7068.  
  7069. Select the Monitor all message queues check box to monitor all the message 
  7070. queues. This disables individual selections. 
  7071.  
  7072. Select the appropriate push button to continue. 
  7073.  
  7074.  
  7075. ΓòÉΓòÉΓòÉ 16.2.10. Format Parameters Choice ΓòÉΓòÉΓòÉ
  7076.  
  7077. The Format parameters choice lets you choose how Presentation Manager message 
  7078. parameters display. 
  7079.  
  7080. When you select Format parameters, the Format Message Parameters window 
  7081. displays. 
  7082.  
  7083.  
  7084. ΓòÉΓòÉΓòÉ 16.2.11. Format Message Parameters Window ΓòÉΓòÉΓòÉ
  7085.  
  7086. Use the Format Message Parameters window to specify how message parameters 
  7087. display. 
  7088.  
  7089. The Format Message Parameters window consists of the following: 
  7090.  
  7091. Message 
  7092.  
  7093. This section contains a list of the all the defined messages. 
  7094.  
  7095. Sort 
  7096.  
  7097. o Select the Name button to sort the messages alphabetically by name. 
  7098. o Select the ID button to sort the messages numerically by ID. 
  7099.  
  7100. Parameter formatting 
  7101.  
  7102. o MP1 - Message parameter 1 Select the arrow to open the MP1 list. Select the 
  7103.   type of formatting you want from the parameter list. The formatting 
  7104.   selections are saved in program profiles. 
  7105. o MP2 - Message parameter 2 Select the arrow to open the MP2 list. Select the 
  7106.   type of formatting you want from the parameter list. The formatting 
  7107.   selections are saved in program profiles. 
  7108.  
  7109. Select the appropriate push button to continue. 
  7110.  
  7111.  
  7112. ΓòÉΓòÉΓòÉ 16.2.12. Parameter List ΓòÉΓòÉΓòÉ
  7113.  
  7114. The following is a list of parameters that may not be self-explanatory: 
  7115.  
  7116. 32-bit fixed (int, frac) 
  7117.           A 32-bit fixed number formatted by separating the integer and 
  7118.           fractional parts. 
  7119.  
  7120. 32-bit fixed (decimal rounded) 
  7121.           A 32-bit fixed number formatted as a rounded decimal number. 
  7122.  
  7123. WM_CHAR mp1 
  7124.           Parameter formatted as the message parameter 1 for a WM_CHAR message. 
  7125.  
  7126. WM_CHAR mp2 
  7127.           Parameter formatted as the message parameter 2 for a WM_CHAR message. 
  7128.  
  7129.  
  7130. ΓòÉΓòÉΓòÉ 16.2.13. Define Messages Choice ΓòÉΓòÉΓòÉ
  7131.  
  7132. The Define message choice lets you define messages that you want to have 
  7133. displayed in the Message Queue Monitor window. 
  7134.  
  7135. When you select Define message, the Define Messages window displays. 
  7136.  
  7137.  
  7138. ΓòÉΓòÉΓòÉ 16.2.14. Define Messages Window ΓòÉΓòÉΓòÉ
  7139.  
  7140. Use the Define Messages window to define messages. 
  7141.  
  7142. Message 
  7143.  
  7144. In the Name entry field, type in the name of the message that you want to 
  7145. define. 
  7146.  
  7147. In the ID entry field, type in the hex number for the message or use the spin 
  7148. button to locate the number of the message. 
  7149.  
  7150. Default parameter formatting 
  7151.  
  7152. o MP1 - Message parameter 1 Select the arrow to open the MP1 list. Select the 
  7153.   default type of formatting you want from the parameter list. The formatting 
  7154.   selections are saved in program profiles. 
  7155. o MP2 - Message parameter 2 Select the arrow to open the MP2 list. Select the 
  7156.   default type of formatting you want from the parameter list. The formatting 
  7157.   selections are saved in program profiles. 
  7158.  
  7159. Message monitored by default 
  7160.  
  7161. Select the Message monitored by default check box if you want to monitor the 
  7162. messages by default. 
  7163.  
  7164. Select the appropriate push button to continue. 
  7165.  
  7166.  
  7167. ΓòÉΓòÉΓòÉ 16.2.15. Display Style Choice ΓòÉΓòÉΓòÉ
  7168.  
  7169. Use the Display style choice to select which columns you want to display in the 
  7170. Message Queue Monitor window. 
  7171.  
  7172. When you select Display style, the Display Style window displays. 
  7173.  
  7174.  
  7175. ΓòÉΓòÉΓòÉ 16.2.16. Display Style Window ΓòÉΓòÉΓòÉ
  7176.  
  7177. Use the Display Style window to specify which columns you want to display in 
  7178. the Message Queue Monitor window. 
  7179.  
  7180. The items in this window affect system performance. You may want to experiment 
  7181. with different settings to see what works best for your system. 
  7182.  
  7183. Columns 
  7184.  
  7185. Select the columns you want to display in the Message Queue Monitor window. 
  7186. These are described in the column list. 
  7187.  
  7188. Messages count 
  7189.  
  7190. The following choices affect system performance: 
  7191.  
  7192. Maximum displayed 
  7193.  
  7194. Select the number of messages you want to display from the Maximum displayed 
  7195. entry field. You can type in a number or use the spin button to select the 
  7196. number you want. A higher maximum may cause the system to respond faster. 
  7197. However, too high a maximum may cause the system to respond slower. 
  7198.  
  7199. Note:  You may need to experiment with this setting to see what works best for 
  7200. your system. 
  7201.  
  7202. Deleted at one time 
  7203.  
  7204. Select the number of messages you want deleted at one time from the Deleted at 
  7205. one time entry field. You can type in a number or use the spin button to enter 
  7206. the number you want. The more messages deleted at once causes the system to 
  7207. respond faster. 
  7208.  
  7209. Unlimited 
  7210.  
  7211. Select Unlimited to have no maximum on the number of messages to be displayed. 
  7212. When you select unlimited, the Maximum displayed and Deleted at one time entry 
  7213. fields are disabled. This choice sets no limit on messages to have displayed 
  7214. and the system may respond slower. 
  7215.  
  7216. Automatic scrolling 
  7217.  
  7218. Select Automatic scrolling if you want the window to automatically scroll 
  7219. forward when the screen is filled with messages. Selecting this decreases 
  7220. system performance. 
  7221.  
  7222. Automatic column resizing 
  7223.  
  7224. Select Automatic column resizing if you want the columns to automatically 
  7225. resize. Selecting this decreases system performance. 
  7226.  
  7227. Note:  When this check box is selected, the Resize Column Width choice is not 
  7228. available. 
  7229.  
  7230. Display titles 
  7231.  
  7232. Select Display titles if you want titles to be displayed in the window. This 
  7233. does not affect system performance. 
  7234.  
  7235. Select the appropriate push button to continue. 
  7236.  
  7237.  
  7238. ΓòÉΓòÉΓòÉ 16.2.17. Column List ΓòÉΓòÉΓòÉ
  7239.  
  7240. The following is a list of column titles that are available: 
  7241.  
  7242.  Class 
  7243.           Window class of the window handle the message is being directed to. 
  7244.  
  7245.           Note:  Some messages do not have a window handle (for example, 
  7246.           WinPostQueueMsg). 
  7247.  
  7248. Hwnd 
  7249.           Window handle the message is being directed to. 
  7250.  
  7251.           Note:  Some messages do not have a window handle (for example, 
  7252.           WinPostQueueMsg). 
  7253.  
  7254. Queue 
  7255.           Message queue the message is being directed to. 
  7256.  
  7257. Message 
  7258.           Message name. 
  7259.  
  7260. Msg ID 
  7261.           Message formatted as 32-bit signed integer. 
  7262.  
  7263. Msg-hex 
  7264.           Message formatted as 32-bit hex number. 
  7265.  
  7266. MP1 
  7267.           Message parameter 1. 
  7268.  
  7269. MP2 
  7270.           Message parameter 2. 
  7271.  
  7272. Type 
  7273.           Indicates whether the message is a post message or a send message. 
  7274.  
  7275. Time 
  7276.           Indicates the time stamp of the message was generated. The time stamp 
  7277.           is an offset from a starting time. Time style is only for Post 
  7278.           messages. 
  7279.  
  7280. Mouse 
  7281.           The mouse position when the message was generated. Mouse style is 
  7282.           only for Post messages. 
  7283.  
  7284. Options 
  7285.           Message removal options. Options style is only for Post messages. 
  7286.  
  7287. Model 
  7288.           Message identity. Model style is only for Send messages. 
  7289.  
  7290. Task 
  7291.           Whether the message was dispatched between tasks or not. Task style 
  7292.           is only for Send messages. 
  7293.  
  7294. From PID 
  7295.           Process identity of the process that dispatched the message. From PID 
  7296.           style is only for Send messages. 
  7297.  
  7298. From TID 
  7299.           Thread identity of the thread that dispatched the message. From TID 
  7300.           style is only for Send messages. 
  7301.  
  7302. To PID 
  7303.           Process identity of the process that received the message. 
  7304.  
  7305. To TID 
  7306.           Thread identity of the thread that received the message. 
  7307.  
  7308. Direction 
  7309.           Direction the message relative to the debuggee process. 
  7310.  
  7311. Dispatched 
  7312.           Debuggee process dispatched a message to another process. 
  7313.  
  7314. Received 
  7315.           Debuggee process received a message from anotherprocess. 
  7316.  
  7317. Internal 
  7318.           Debuggee process dispatched a message to itself. 
  7319.  
  7320. Processed 
  7321.           Whether the debugger processed message on behalf the debuggee. This 
  7322.           occurs when the debuggee is stopped. 
  7323.  
  7324.  
  7325. ΓòÉΓòÉΓòÉ 16.2.18. Fonts Choice ΓòÉΓòÉΓòÉ
  7326.  
  7327. Select the Fonts choice to set the font you want to use for the text that 
  7328. displays in the Message Queue window. 
  7329.  
  7330. When you select Fonts, a Fonts window displays. 
  7331.  
  7332.  
  7333. ΓòÉΓòÉΓòÉ 16.2.19. Control Choice ΓòÉΓòÉΓòÉ
  7334.  
  7335. Select the Control choice to display the Control window. 
  7336.  
  7337.  
  7338. ΓòÉΓòÉΓòÉ 16.3. Windows Menu ΓòÉΓòÉΓòÉ
  7339.  
  7340. Select the Windows menu to display a list of all the open debugger windows. By 
  7341. selecting a window from the Windows menu, it is brought into focus and made the 
  7342. active window. Also, if the window is minimized, it is restored. 
  7343.  
  7344.  
  7345. ΓòÉΓòÉΓòÉ 16.3.1. Windows Choices ΓòÉΓòÉΓòÉ
  7346.  
  7347. Select this choice to make the window active. By selecting this choice, the 
  7348. window is brought into focus and made the active window. Also, if the window is 
  7349. minimized, it is restored. 
  7350.  
  7351.  
  7352. ΓòÉΓòÉΓòÉ 16.4. Help Menu ΓòÉΓòÉΓòÉ
  7353.  
  7354. Select choices from the Help menu to complement the online help information 
  7355. that you can get for the debugger when you press F1 or select the Help push 
  7356. button. 
  7357.  
  7358.  Menu Summary 
  7359.  
  7360. Help index 
  7361.           An alphabetical index of all available debugger help topics. 
  7362.  
  7363. General help 
  7364.           Help information for the active window. 
  7365.  
  7366. Using help 
  7367.           How to use the help facility. 
  7368.  
  7369.  
  7370. ΓòÉΓòÉΓòÉ 16.4.1. Help Index Choice ΓòÉΓòÉΓòÉ
  7371.  
  7372. Select the Index choice display an alphabetical list of index topics for the 
  7373. debugger. Use the Find choice provided with the online help facility to locate 
  7374. topics in the index. 
  7375.  
  7376.  
  7377. ΓòÉΓòÉΓòÉ 16.4.2. General Help Choice ΓòÉΓòÉΓòÉ
  7378.  
  7379. Select the General help choice to display online help for the active debugger 
  7380. window. The online help panel displayed is the same panel that displays when 
  7381. you place your cursor inside the window and press F1. 
  7382.  
  7383.  
  7384. ΓòÉΓòÉΓòÉ 16.4.3. Using Help Choice ΓòÉΓòÉΓòÉ
  7385.  
  7386. Select the Using help choice to display online help information about the 
  7387. OS/2help facility. 
  7388.  
  7389.  
  7390. ΓòÉΓòÉΓòÉ 17. Exception Window ΓòÉΓòÉΓòÉ
  7391.  
  7392. Exception Window 
  7393.  
  7394. The Exception window displays whenever an OS/2 exception occurs.  The exception 
  7395. may have occurred in the application or the system code. In either case, the 
  7396. debugger displays and highlights the line where the exception occurred in the 
  7397. Source window. 
  7398.  
  7399. You can do three things from this window: 
  7400.  
  7401. Examine/Retry 
  7402.           Allows you to investigate the cause of the exception and if desired, 
  7403.           retry execution of the line that caused the original fault. The 
  7404.           debugger begins with the line causing the error and attempts to 
  7405.           continue. 
  7406.  
  7407.           This is the default. 
  7408.  
  7409. Step Exception 
  7410.           Causes the debugger to step into the first registered exception 
  7411.           handler (tracked by OS/2). Execution stops at the first executable 
  7412.           line of code in that exception handler. You control what happens 
  7413.           next. 
  7414.  
  7415. Run Exception 
  7416.           Causes the debugger to run the normal exception handlers, which are 
  7417.           registered with OS/2 to handle exception conditions. 
  7418.  
  7419. For details on the OS/2 exception definitions, refer to the Control Program 
  7420. Programming Reference (S10G-6263-00). The Software exception will not be 
  7421. listed, since this is a user-defined OS/2 exception generated by the 
  7422. DosRaiseException call. 
  7423.  
  7424.  
  7425. ΓòÉΓòÉΓòÉ 18. Overloaded Window ΓòÉΓòÉΓòÉ
  7426.  
  7427. Overloaded Window 
  7428.  
  7429. Use the Overloaded window to select the appropriate function. This window 
  7430. displays when you have an overloaded function. 
  7431.  
  7432. To use the Overloaded window: 
  7433.  
  7434.  1. Select the name of the function you want from the list. 
  7435.  
  7436.  2. Select the appropriate push button to continue. 
  7437.  
  7438. Signature 
  7439.           Displays the function name and any parameters that the function has. 
  7440.  
  7441.  
  7442. ΓòÉΓòÉΓòÉ 19. Source Filename Window ΓòÉΓòÉΓòÉ
  7443.  
  7444. Source Filename Window 
  7445.  
  7446. The Source Filename window displays when you try to open a component for which 
  7447. you have debugging data, but the debugger cannot locate the source code. 
  7448.  
  7449. To use the Source Filename window, do one of the following: 
  7450.  
  7451. o If the source code is located in another directory on the system, type in the 
  7452.   path name and select OK. 
  7453. o If you do not have the source code for this component, select Cancel. The 
  7454.   Disassembly window opens for this component. 
  7455.  
  7456.  
  7457. ΓòÉΓòÉΓòÉ 20. Program Termination Window ΓòÉΓòÉΓòÉ
  7458.  
  7459. Program Termination Window 
  7460.  
  7461. Use the Program Termination window to end the debugging session, restart the 
  7462. debugging session, or display the Program Startup window. 
  7463.  
  7464. Select the appropriate push button to continue. 
  7465.  
  7466.  
  7467. ΓòÉΓòÉΓòÉ 21. Child Process Termination Window ΓòÉΓòÉΓòÉ
  7468.  
  7469. Child Process Termination Window 
  7470.  
  7471. Use the Child Process Termination window to continue debugging child processes, 
  7472. restart the parent program, or end the debugging session. 
  7473.  
  7474. Child Process(es) Entry Field 
  7475.  
  7476. In the Child Process(es) entry field, you may modify the names of the child 
  7477. processes you want to debug. 
  7478.  
  7479. Select the appropriate push button to continue. 
  7480.  
  7481.  
  7482. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7483.  
  7484. Continue 
  7485.           Resume debugging the next child process that is listed in the Child 
  7486.           Process(es) entry field that is started by OS/2. 
  7487.  
  7488. Restart 
  7489.           Restart the parent program. 
  7490.  
  7491. Close Debugger 
  7492.           Close the debugging session. 
  7493.  
  7494. Help 
  7495.           Display help information for this window. 
  7496.  
  7497.  
  7498. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7499.  
  7500. Restart 
  7501.           Restarts the debugging session. 
  7502.  
  7503. Program startup 
  7504.           Displays the startup window. 
  7505.  
  7506. Close Debugger 
  7507.           Closes the debugging session. 
  7508.  
  7509. Help 
  7510.           Displays help information for this window. 
  7511.  
  7512.  
  7513. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7514.  
  7515. OK 
  7516.           Accepts the information you have typed and closes this window. 
  7517.  
  7518. Cancel 
  7519.           Closes the window without saving any changes. 
  7520.  
  7521. Help 
  7522.           Displays help information for this window. 
  7523.  
  7524.  
  7525. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7526.  
  7527. OK 
  7528.           Accepts the information you have typed and closes this window. 
  7529.  
  7530. Apply 
  7531.           Substitutes the file and leaves the window open. 
  7532.  
  7533. Cancel 
  7534.           Closes this window without saving any changes. 
  7535.  
  7536. File List 
  7537.           Displays a list of the files that you can select. 
  7538.  
  7539. Help 
  7540.           Displays help information for this window. 
  7541.  
  7542.  
  7543. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7544.  
  7545. OK 
  7546.           Accepts the information you have typed and closes this window. 
  7547.  
  7548. Reset 
  7549.           Changes the information to the previously saved setting. 
  7550.  
  7551. Default 
  7552.           Defaults to the default setting. 
  7553.  
  7554. Cancel 
  7555.           Closes the window without saving any changes. 
  7556.  
  7557. Help 
  7558.           Displays help information for this window. 
  7559.  
  7560.  
  7561. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7562.  
  7563. OK 
  7564.           Accepts the information you have typed and closes this window. 
  7565.  
  7566. Apply 
  7567.           Applies the change to the window. The change applies only until you 
  7568.           close the window. Select OK to close the window and keep the changes. 
  7569.  
  7570. Reset 
  7571.           Changes the information to the previously saved setting. 
  7572.  
  7573. Default 
  7574.           Replaces the current settings with the default settings. 
  7575.  
  7576. Cancel 
  7577.           Closes the window without saving any changes. 
  7578.  
  7579. Help 
  7580.           Displays help information for this window. 
  7581.  
  7582.  
  7583. ΓòÉΓòÉΓòÉ 21.1. Push Buttons ΓòÉΓòÉΓòÉ
  7584.  
  7585. OK 
  7586.           Accepts the information you have typed and closes this window. 
  7587.  
  7588. Apply 
  7589.           Applies the change to the window. The change applies only until you 
  7590.           close the window. Select OK to select the new font. 
  7591.  
  7592. Reset 
  7593.           Changes the font back to your earlier selection. 
  7594.  
  7595. Default 
  7596.           Replaces the current selection with the default. The default font is 
  7597.           System Monospaced 8x8. 
  7598.  
  7599. Cancel 
  7600.           Closes the window without saving any changes. 
  7601.  
  7602. Help 
  7603.           Displays help information for this window. 
  7604.  
  7605.  
  7606. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7607.  
  7608. OK 
  7609.           Accepts the information you have typed and closes this window. 
  7610.  
  7611. Set 
  7612.           Select Set to set a breakpoint. 
  7613.  
  7614. Default 
  7615.           Defaults to the default settings. 
  7616.  
  7617. Cancel 
  7618.           Closes the window without saving any changes. 
  7619.  
  7620. Help 
  7621.           Displays help information for this window. 
  7622.  
  7623.  
  7624. ΓòÉΓòÉΓòÉ 21.2. Push Buttons ΓòÉΓòÉΓòÉ
  7625.  
  7626. OK 
  7627.           Accepts the information you have typed and closes this window. 
  7628.  
  7629. Set 
  7630.           Select Set to set the breakpoints. 
  7631.  
  7632. Cancel 
  7633.           Closes the window without saving any changes. 
  7634.  
  7635. Default 
  7636.           Defaults to the default settings. 
  7637.  
  7638. File List 
  7639.           Displays a list of the files that you can select. 
  7640.  
  7641. Help 
  7642.           Displays help information for this window. 
  7643.  
  7644.  
  7645. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7646.  
  7647. OK 
  7648.           Select OK to set the breakpoint and close this window. 
  7649.  
  7650. Cancel 
  7651.           Closes the window without saving any changes. 
  7652.  
  7653. Help 
  7654.           Displays help information for this window. 
  7655.  
  7656. Default 
  7657.           Defaults the current window information to the debugger defaults. 
  7658.  
  7659.  
  7660. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7661.  
  7662. OK 
  7663.           Accepts the information you have typed and close this window. 
  7664.  
  7665. Delete 
  7666.           Remove the highlighted breakpoint. 
  7667.  
  7668. Delete all 
  7669.           Remove all of the breakpoints displayed in the window. 
  7670.  
  7671. Sort 
  7672.           Sort the breakpoints by different categories. 
  7673.  
  7674. Disable/Enable 
  7675.           Disable or enable the highlighted breakpoint. 
  7676.  
  7677. Modify 
  7678.           Modify the existing breakpoints. 
  7679.  
  7680. Help 
  7681.           Displays the online help for this window. 
  7682.  
  7683.  
  7684. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7685.  
  7686. Add 
  7687.           Select Add to add the new message you have defined. 
  7688.  
  7689. Update 
  7690.           Select Update to update a message that previously existed. 
  7691.  
  7692. Delete 
  7693.           Select Delete to delete a message that previously existed. 
  7694.  
  7695. Cancel 
  7696.           Select Cancel to ignore any changes that were made and close this 
  7697.           window. 
  7698.  
  7699. Help 
  7700.           Displays help information for this window. 
  7701.  
  7702.  
  7703. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7704.  
  7705. OK 
  7706.           Accepts the information you have typed and to close this window. 
  7707.  
  7708. Reset 
  7709.           Select Reset to clear any changes you have made in this session. 
  7710.  
  7711. Default 
  7712.           Select Default to replace the current default display style with 
  7713.           default display style. 
  7714.  
  7715. Cancel 
  7716.           Closes the window without saving any changes. 
  7717.  
  7718. Help 
  7719.           Displays Help information for this window. 
  7720.  
  7721.  
  7722. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7723.  
  7724. OK 
  7725.           Accepts the information you have selected in this window. 
  7726.  
  7727. Reset 
  7728.           Select Reset to clear any changes you have made in this window. 
  7729.  
  7730. Default 
  7731.           Select Default to replace the default selection in this window. 
  7732.  
  7733. Cancel 
  7734.           Closes the window without saving any changes. 
  7735.  
  7736. Help 
  7737.           Displays help information for this window. 
  7738.  
  7739.  
  7740. ΓòÉΓòÉΓòÉ <hidden> Push Buttons ΓòÉΓòÉΓòÉ
  7741.  
  7742. OK 
  7743.           Accepts the information you have typed and closes this window. 
  7744.  
  7745. Apply 
  7746.           Apply the changes to the window. 
  7747.  
  7748. Reset 
  7749.           Select Reset to change the colors back to what they were when you 
  7750.           opened this window. 
  7751.  
  7752. Default 
  7753.           Select Default to change the color back to the default color. 
  7754.  
  7755. Cancel 
  7756.           Closes the window without saving any changes. 
  7757.  
  7758. Help 
  7759.           Displays Help information for this window. 
  7760.  
  7761.  
  7762. ΓòÉΓòÉΓòÉ 22. Glossary ΓòÉΓòÉΓòÉ
  7763.  
  7764. Double-click on any term for a definition: 
  7765.  
  7766. o Asynchronous 
  7767. o Automatic variable 
  7768. o Breakpoint 
  7769. o Clock icon 
  7770. o Component 
  7771. o Context 
  7772. o Debug data 
  7773. o Debuggee 
  7774. o Desktop 
  7775. o Desktop-object 
  7776. o Disable 
  7777. o Enable 
  7778. o Event breakpoint 
  7779. o Executable files 
  7780. o Executable statement 
  7781. o Functions 
  7782. o Image 
  7783. o Include files 
  7784. o Local variables 
  7785. o Location breakpoint 
  7786. o Non-debuggee 
  7787. o Object files 
  7788. o Overloaded 
  7789. o Parent-child relationship 
  7790. o Post messages. 
  7791. o Prefix area 
  7792. o Process 
  7793. o Program generated breakpoint 
  7794. o Program profiles 
  7795. o Recursion level 
  7796. o Search path 
  7797. o Send messages 
  7798. o Session 
  7799. o Shortcut keys 
  7800. o Stopping thread 
  7801. o Storage 
  7802. o Synchronous 
  7803. o Tag word 
  7804. o Thread 
  7805. o Time stamp 
  7806. o Z-order. 
  7807.  
  7808.  
  7809. ΓòÉΓòÉΓòÉ 22.1. Asynchronous ΓòÉΓòÉΓòÉ
  7810.  
  7811. When the debugger is operating in asynchronous mode and the program you are 
  7812. debugging is stopped, the debugger immediately responds to messages that have 
  7813. been sent to the program being debugged on this program's behalf. The debugger 
  7814. answers the messages with a simple default response, freeing up other processes 
  7815. to operate while the debugger has control. When you are running the debugger in 
  7816. asynchronous mode, other Presentation Manager applications running in the 
  7817. system are not blocked when the program being debugged stops. 
  7818.  
  7819. Warning: Do not operate the debugger in asynchronous mode if the Presentation 
  7820. Manager application that you are debugging requires the appropriate response to 
  7821. its messages. For example, a dynamic data exchange (DDE) message would require 
  7822. the appropriate response. 
  7823.  
  7824.  
  7825. ΓòÉΓòÉΓòÉ 22.2. Automatic variable ΓòÉΓòÉΓòÉ
  7826.  
  7827. A variable that is allocated during the invocation of the function containing 
  7828. the variable is called an automatic variable. Every time a function is invoked, 
  7829. a new copy of the variable is placed in storage. 
  7830.  
  7831.  
  7832. ΓòÉΓòÉΓòÉ 22.3. Breakpoint ΓòÉΓòÉΓòÉ
  7833.  
  7834. A breakpoint is a defined location or condition in a program that, when it is 
  7835. met, stops the execution of the program. 
  7836.  
  7837.  
  7838. ΓòÉΓòÉΓòÉ 22.4. Clock Icon ΓòÉΓòÉΓòÉ
  7839.  
  7840. There are two wait states in the debugger. 
  7841.  
  7842. When the debugger is busy doing something, it displays a clock icon. This icon 
  7843. displays when the wait is over (for example, loading a program into the 
  7844. debugger). 
  7845.  
  7846. When your program is running, the debugger displays a clock icon with a 
  7847. rectangle behind it. This may mean that your program is waiting for input. If 
  7848. so, select your application window (if necessary) and provide it with the input 
  7849. it needs. 
  7850.  
  7851.  
  7852. ΓòÉΓòÉΓòÉ 22.5. Component ΓòÉΓòÉΓòÉ
  7853.  
  7854. Components are the executable files, source files or object files, and the 
  7855. functions that comprise a program. 
  7856.  
  7857.  
  7858. ΓòÉΓòÉΓòÉ 22.6. Context ΓòÉΓòÉΓòÉ
  7859.  
  7860. Context is the information relating to an expression or variable when it is 
  7861. valid. The information consists of the source file, line number, and thread. 
  7862.  
  7863.  
  7864. ΓòÉΓòÉΓòÉ 22.7. Debuggee ΓòÉΓòÉΓòÉ
  7865.  
  7866. Debuggee is the application that is being debugged. 
  7867.  
  7868.  
  7869. ΓòÉΓòÉΓòÉ 22.8. Debuggee window ΓòÉΓòÉΓòÉ
  7870.  
  7871. Debuggee window is a window built by the application being debugged. Every 
  7872. debuggee window is a descendent of the desktop or desktop-object window. 
  7873.  
  7874.  
  7875. ΓòÉΓòÉΓòÉ 22.9. Debugging data ΓòÉΓòÉΓòÉ
  7876.  
  7877. Debugging data is the symbolic and line number information contained in the 
  7878. executable file that exists when compiled and linked with the correct compiler 
  7879. and linker options.  See Compiling and Linking Your Program for more 
  7880. information. 
  7881.  
  7882.  
  7883. ΓòÉΓòÉΓòÉ 22.10. Disable ΓòÉΓòÉΓòÉ
  7884.  
  7885. Disable prevents a thread from executing. 
  7886.  
  7887.  
  7888. ΓòÉΓòÉΓòÉ 22.11. Desktop window ΓòÉΓòÉΓòÉ
  7889.  
  7890. Desktop window is a window automatically created by OS/2 when it starts a 
  7891. Presentation Manager interface session. The desktop window serves as a base 
  7892. (bottom-most) window for the windows which can be displayed. Whether a 
  7893. descendent window is actually seen depends on the window visibility, its 
  7894. position and size, and overlapping windows. The desktop window paints the 
  7895. background color of the screen. 
  7896.  
  7897.  
  7898. ΓòÉΓòÉΓòÉ 22.12. Desktop-Object Window ΓòÉΓòÉΓòÉ
  7899.  
  7900. Desktop-object window is a window automatically created by OS/2 when it starts 
  7901. a Presentation Manager interface session. The desktop-object window serves as a 
  7902. base (bottom-most) window for the windows that can not be displayed. This is 
  7903. irrespective for the window visibility, its position and size, and overlapping 
  7904. windows. Any descendents of the desktop-object windows are called object 
  7905. windows. Object windows provide services to other windows. 
  7906.  
  7907.  
  7908. ΓòÉΓòÉΓòÉ 22.13. Enable ΓòÉΓòÉΓòÉ
  7909.  
  7910. Enable allows a thread to execute. 
  7911.  
  7912.  
  7913. ΓòÉΓòÉΓòÉ 22.14. Event breakpoint ΓòÉΓòÉΓòÉ
  7914.  
  7915. An event breakpoint is one of the following: 
  7916.  
  7917. o A load occurrence breakpoint 
  7918. o A change address breakpoint. 
  7919.  
  7920.  
  7921. ΓòÉΓòÉΓòÉ 22.15. Executable files ΓòÉΓòÉΓòÉ
  7922.  
  7923. Executable files are the EXE or DLL files. 
  7924.  
  7925.  
  7926. ΓòÉΓòÉΓòÉ 22.16. Executable statement ΓòÉΓòÉΓòÉ
  7927.  
  7928. An executable statement is a statement where you can stop the execution of your 
  7929. program by setting breakpoints. These statements are initially displayed in 
  7930. blue. 
  7931.  
  7932.  
  7933. ΓòÉΓòÉΓòÉ 22.17. Functions ΓòÉΓòÉΓòÉ
  7934.  
  7935. A Function is a block of statements executed by a function call. Synonymous 
  7936. with procedures. 
  7937.  
  7938.  
  7939. ΓòÉΓòÉΓòÉ 22.18. Image ΓòÉΓòÉΓòÉ
  7940.  
  7941. Image is a graphical representation of a program's windows in three dimensions 
  7942. (x, y, and z). A window is represented on a plane (x and y), using its size and 
  7943. position. Window planes in the image are perpendicular to the z-axis and 
  7944. positioned in z-order. A window at the top of z-order has the largest z 
  7945. coordinate and is the top window. 
  7946.  
  7947.  
  7948. ΓòÉΓòÉΓòÉ 22.19. Include files ΓòÉΓòÉΓòÉ
  7949.  
  7950. Include files are files that are included in your source file by a compiler 
  7951. directive and are considered program source files. 
  7952.  
  7953.  
  7954. ΓòÉΓòÉΓòÉ 22.20. Load occurrence breakpoints ΓòÉΓòÉΓòÉ
  7955.  
  7956. A load occurrence breakpoint allows you to stop the execution of your program 
  7957. after the DLL that you specify is loaded. 
  7958.  
  7959.  
  7960. ΓòÉΓòÉΓòÉ 22.21. Local variables ΓòÉΓòÉΓòÉ
  7961.  
  7962. A local variable is a variable that is specific to a function. The debugger 
  7963. displays the following types of local variables: 
  7964.  
  7965. o Static 
  7966. o Automatic 
  7967. o Parameters. 
  7968.  
  7969.  
  7970. ΓòÉΓòÉΓòÉ 22.22. Location breakpoint ΓòÉΓòÉΓòÉ
  7971.  
  7972. A location breakpoint is one of the following: 
  7973.  
  7974. o A line breakpoint 
  7975. o An address breakpoint 
  7976. o A function breakpoint. 
  7977.  
  7978.  
  7979. ΓòÉΓòÉΓòÉ 22.23. Non-Debuggee ΓòÉΓòÉΓòÉ
  7980.  
  7981. Non-debuggee is an application that is not being debugged. 
  7982.  
  7983.  
  7984. ΓòÉΓòÉΓòÉ 22.24. Non-Debuggee window ΓòÉΓòÉΓòÉ
  7985.  
  7986. Non-debuggee window is a window not built by the application being debugged. 
  7987. Every non-debuggee window is a descendent of the desktop or desktop-object 
  7988. window. 
  7989.  
  7990.  
  7991. ΓòÉΓòÉΓòÉ 22.25. Object files ΓòÉΓòÉΓòÉ
  7992.  
  7993. Object files are the object (OBJ) files. 
  7994.  
  7995.  
  7996. ΓòÉΓòÉΓòÉ 22.26. Overloaded function ΓòÉΓòÉΓòÉ
  7997.  
  7998. An overloaded function in C++ is when you have two or more functions with the 
  7999. same name with different parameters. An overloaded function also occurs when 
  8000. you have the same function in different modules (EXE or DLLs). 
  8001.  
  8002.  
  8003. ΓòÉΓòÉΓòÉ 22.27. Parent-Child relationship ΓòÉΓòÉΓòÉ
  8004.  
  8005. Parent-child relationship defines the appearance of a window when it is drawn 
  8006. on the screen. A child window is drawn relative to its parent window. No part 
  8007. of a child window ever displays outside the borders of its parent window. 
  8008.  
  8009.  
  8010. ΓòÉΓòÉΓòÉ 22.28. Post messages ΓòÉΓòÉΓòÉ
  8011.  
  8012. Messages created through WinPostMsg or WinPostMsgQueu. The calls place the 
  8013. message on the Message Queue of the receiver. The message is posted on the 
  8014. Message Queue. The calls return immediately not waiting for the receiver to 
  8015. return. 
  8016.  
  8017.  
  8018. ΓòÉΓòÉΓòÉ 22.29. Prefix area ΓòÉΓòÉΓòÉ
  8019.  
  8020. Prefix area is the area within the source views where line numbers or address 
  8021. numbers are located. 
  8022.  
  8023.  
  8024. ΓòÉΓòÉΓòÉ 22.30. Process ΓòÉΓòÉΓòÉ
  8025.  
  8026. Process is the collection of one or more threads and their associated system 
  8027. resources, such as storage, open files, and devices. 
  8028.  
  8029.  
  8030. ΓòÉΓòÉΓòÉ 22.31. Program generated breakpoint ΓòÉΓòÉΓòÉ
  8031.  
  8032.  A program generated breakpoint is the trap instruction, which in the case of 
  8033. OS/2 is a CC instruction, which causes the program to stop as if a breakpoint 
  8034. has been encountered.  If this occurs, use the jump to location feature to go 
  8035. to the next instruction or source line. 
  8036.  
  8037.  
  8038. ΓòÉΓòÉΓòÉ 22.32. Program profiles ΓòÉΓòÉΓòÉ
  8039.  
  8040. Program profiles are used to restore the breakpoints, monitor expressions, and 
  8041. source windows when debugging a program more than once. They are stored 
  8042. separately for each program debugged and are saved at the end of each debugging 
  8043. process. The file extension for the files that contain this information is @4R. 
  8044.  
  8045. Note:  All breakpoints are saved.  All other information such as monitors and 
  8046. source windows is saved only for the primary thread and only for executables 
  8047. and preloaded DLLs. 
  8048.  
  8049.  
  8050. ΓòÉΓòÉΓòÉ 22.33. Recursion level ΓòÉΓòÉΓòÉ
  8051.  
  8052. The number that represents the level of recursion of a function, where the 
  8053. number 0 represents the first invocation. A recursive function is a function 
  8054. that calls itself. 
  8055.  
  8056.  
  8057. ΓòÉΓòÉΓòÉ 22.34. Search Path ΓòÉΓòÉΓòÉ
  8058.  
  8059. The search path tells the debugger where to find the source file used in the 
  8060. Source and Mixed windows. The debugger searches for the source files in the 
  8061. following order: 
  8062.  
  8063.  1. The path defined by the PMDOVERRIDE environment variable, if specified. 
  8064.  
  8065.  2. The path where the object file was compiled. 
  8066.  
  8067.  3. The path where the executable file is located. 
  8068.  
  8069.  4. The path defined by the PMDPATH environment variable, if specified. 
  8070.  
  8071.  5. The current path. 
  8072.  
  8073.  6. The path defined in the INCLUDE environment variable. 
  8074.  
  8075. Using the Environment Variables 
  8076.  
  8077. The debugger uses two environment variables: PMDOVERRIDE and PMDPATH. 
  8078.  
  8079.      Set PMDOVERRIDE=path;path
  8080.  
  8081. where, path is the location of your source files. If the source file is not 
  8082. found in the defined override path, the debugger uses the normal search order. 
  8083.  
  8084. To set the PMDPATH environment variable, do the following: 
  8085.  
  8086.      Set PMDPATH=path;path
  8087.  
  8088. where, path is the location of your source files. 
  8089.  
  8090. To override the normal search order, use the PMDOVERRIDE environment variable. 
  8091.  
  8092.  
  8093. ΓòÉΓòÉΓòÉ 22.35. Send messages ΓòÉΓòÉΓòÉ
  8094.  
  8095. Messages created through WinSendMsg call. The WinSendMsg function call does not 
  8096. complete until the message has been processed by the window procedure whose 
  8097. return value is returned. 
  8098.  
  8099. If the window receiving the message belongs to the same thread, the window 
  8100. function is called immediately as a subroutine. If the window is of another 
  8101. thread or process, the operating system switches to the appropriate thread then 
  8102. enters the necessary window procedure recursively. The message is not placed in 
  8103. the queue of the destination thread. 
  8104.  
  8105.  
  8106. ΓòÉΓòÉΓòÉ 22.36. Session ΓòÉΓòÉΓòÉ
  8107.  
  8108. Session is the collection of one or more processes associated with a virtual 
  8109. console such as keyboard, video display, or mouse. 
  8110.  
  8111.  
  8112. ΓòÉΓòÉΓòÉ 22.37. Shortcut keys ΓòÉΓòÉΓòÉ
  8113.  
  8114. Shortcut keys are the keyboard keys that you use to invoke menu choices. They 
  8115. are usually two key names joined by a plus sign (+). For example, Ctrl+S.  To 
  8116. use these keys together, hold down the first key and press the second key. 
  8117. However, some shortcut keys are single keys.  For example, F3 or Delete. 
  8118.  
  8119.  
  8120. ΓòÉΓòÉΓòÉ 22.38. Stopping thread ΓòÉΓòÉΓòÉ
  8121.  
  8122. A stopping thread is the thread that caused the program being debugged to stop. 
  8123.  
  8124.  
  8125. ΓòÉΓòÉΓòÉ 22.39. Storage ΓòÉΓòÉΓòÉ
  8126.  
  8127. The storage is the computer memory space in use during the execution of a 
  8128. program. 
  8129.  
  8130.  
  8131. ΓòÉΓòÉΓòÉ 22.40. Synchronous ΓòÉΓòÉΓòÉ
  8132.  
  8133. When the debugger is operating in synchronous mode and the debuggee is stopped, 
  8134. message handling is stopped. All processing of Presentation Manager messages is 
  8135. suspended except for the debugger which will continue to operate. The order of 
  8136. all messages is maintained, except for the debugger. No messages are lost. 
  8137.  
  8138.  
  8139. ΓòÉΓòÉΓòÉ 22.41. Synchronous ΓòÉΓòÉΓòÉ
  8140.  
  8141. When the debugger is operating in synchronous mode, the messages that are 
  8142. passed between Presentation Manager applications are answered by their target 
  8143. applications in the order that they were created. The messages that are passed 
  8144. within the debugger take priority over any other messages that are passed in 
  8145. the system. 
  8146.  
  8147. When the program being debugged is stopped and the debugger is in synchronous 
  8148. mode, other Presentation Manager applications are locked, leaving the debugger 
  8149. free to operate. In synchronous mode, you will not be able to use any other 
  8150. Presentation Manager applications that are running. 
  8151.  
  8152.  
  8153. ΓòÉΓòÉΓòÉ 22.42. Tag word ΓòÉΓòÉΓòÉ
  8154.  
  8155. The contents of a tag word tell you which registers are in use at a specific 
  8156. time. 
  8157.  
  8158.  
  8159. ΓòÉΓòÉΓòÉ 22.43. Thread ΓòÉΓòÉΓòÉ
  8160.  
  8161. A thread is the basic OS/2 unit of execution. A thread gives a program its 
  8162. context, including registers, stack, and processor mode. Multiple threads can 
  8163. be running at the same time, and any particular thread can start another 
  8164. thread. 
  8165.  
  8166.  
  8167. ΓòÉΓòÉΓòÉ 22.43.1. Time Stamp Check ΓòÉΓòÉΓòÉ
  8168.  
  8169. Information that is program profile information includes the time stamps on the 
  8170. executable files that make up the application. When you select to start a 
  8171. program with program profile, the debugger compares the time stamp in the 
  8172. executable program file (and the pre-loaded dynamic link libraries) with the 
  8173. time stamp on the program profile. If these time stamps do not match, a message 
  8174. box displays. 
  8175.  
  8176. Select Yes from the message box to start the program with program profile, 
  8177. select No to load the program without the program profile, or select Cancel to 
  8178. cancel the startup process and return to the Control window. 
  8179.  
  8180. If the source file changed but was not compiled, breakpoints might be invalid 
  8181. or display on the wrong lines. 
  8182.  
  8183.  
  8184. ΓòÉΓòÉΓòÉ 22.44. Z-Order ΓòÉΓòÉΓòÉ
  8185.  
  8186. Z-order is the order of overlapping windows. Every window, in addition to 
  8187. having a screen position, has a z-order position. This viewing order is 
  8188. oriented along an imaginary axis, the z-axis, extending outward from the 
  8189. screen. A window at the bottom of the z-order is overlapped by all sibling 
  8190. windows. 
  8191.  
  8192.  
  8193. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  8194.  
  8195. Trademark of International Business Machines