home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vacbdbg.zip / betadbg.zip / help / derdhq1.hlp (.txt) < prev    next >
OS/2 Help File  |  1998-02-13  |  17KB  |  488 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Message Queue - Process Selection Window ΓòÉΓòÉΓòÉ
  3.  
  4. This window allows you to select the process you wish to monitor. A list of 
  5. processes currently running appears in the 'Processes to be monitored' combo 
  6. box. In parentheses next to each process name is its process id number in 
  7. decimal. 
  8.  
  9. To monitor a process, select a currently running process from the 'Processes to 
  10. be monitored' combo box and then select 'Message queue' from the Monitors menu 
  11. to start the message queue feature on the selected process. 
  12.  
  13. You can only monitor one message queue at a time. To monitor messages for a new 
  14. process, close the open message queue monitor window and select a new process 
  15. to monitor. 
  16.  
  17. Message Queue Process Selection Menus 
  18.  
  19.      File 
  20.  
  21.      Monitors 
  22.  
  23.      Options 
  24.  
  25.      Help 
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 1.1. File Menu ΓòÉΓòÉΓòÉ
  29.  
  30. The File menu contains only one choice, Close MQWA. 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 1.2. Monitors Menu ΓòÉΓòÉΓòÉ
  34.  
  35. The Monitors menu of the Message Queue - Process Selection window only one 
  36. option: 
  37.  
  38.      Message Queue 
  39.  
  40.  
  41. ΓòÉΓòÉΓòÉ 1.2.1. Message Queue ΓòÉΓòÉΓòÉ
  42.  
  43. Select Monitors->Message queue to open a Message Queue window. Here, you can 
  44. monitor or intercept OS/2 Presentation Manager or Windows messages to and from 
  45. your application. 
  46.  
  47.  
  48. ΓòÉΓòÉΓòÉ 1.2.2. Options Menu ΓòÉΓòÉΓòÉ
  49.  
  50. The Options menu of the Message Queue - Process Selection window has one 
  51. option: 
  52.  
  53.      Fonts 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 1.2.2.1. Fonts ΓòÉΓòÉΓòÉ
  57.  
  58. Select Fonts from the Options menu to change the font used to display 
  59. information in the window. 
  60.  
  61.  
  62. ΓòÉΓòÉΓòÉ 1.3. Help ΓòÉΓòÉΓòÉ
  63.  
  64. The Help menu provides help for the current window and for other help on the 
  65. message queue tool. The following choices are available: 
  66.  
  67.      Help index -- displays a list of index entries within the help file. 
  68.  
  69.      General help -- displays high-level help for the current window. 
  70.  
  71.      Using help -- displays help on how to access and use help features of the 
  72.       message queue tool. 
  73.  
  74.      Product information -- displays the logo screen for the message queue 
  75.       tool. 
  76.  
  77.  If you want to search for a string within a help file, click on Search from 
  78.  the help window, enter the search string in the entry field, select All 
  79.  sections, and click on Search 
  80.  
  81.  
  82. ΓòÉΓòÉΓòÉ 2. Message Queue Window ΓòÉΓòÉΓòÉ
  83.  
  84. The Message Queue window displays OS/2 Presentation Manager or Windows messages 
  85. associated with an application. It presents formatted messages in a list as 
  86. they occur. Using the message queue window, you can control: 
  87.  
  88.      How the information is displayed for each message 
  89.  
  90.      How message parameters are formatted 
  91.  
  92.      Which messages are monitored 
  93.  
  94.      Which windows have their messages monitored 
  95.  
  96.      Which message queues have their messages monitored (OS/2 only) 
  97.  
  98.      How the user-generated messages are displayed 
  99.  
  100.  Message Queue Menus 
  101.  
  102.      File 
  103.  
  104.      Options 
  105.  
  106.      Help 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 2.1. Close MQWA ΓòÉΓòÉΓòÉ
  110.  
  111. Select Close MQWA from the File menu to exit the MQWA tool. 
  112.  
  113.  
  114. ΓòÉΓòÉΓòÉ 2.2. Options Menu ΓòÉΓòÉΓòÉ
  115.  
  116. The Options menu of the Message Queue window contains the following choices: 
  117.  
  118.      Suspend -- Stops any new messages from being added 
  119.  
  120.      Clear -- Deletes all currently displayed messages 
  121.  
  122.      Monitor messages 
  123.  
  124.      Monitor windows 
  125.  
  126.      Monitor queues 
  127.  
  128.      Format parameters 
  129.  
  130.      Define messages -- Lets you define your own messages to be monitored 
  131.  
  132.      Display style 
  133.  
  134.      Fonts 
  135.  
  136.  
  137. ΓòÉΓòÉΓòÉ 2.2.1. Monitor Messages Window ΓòÉΓòÉΓòÉ
  138.  
  139. Use the Monitor Messages window to specify the messages you want monitored. 
  140.  
  141. The Monitor Messages window contains the following sections: 
  142.  
  143.      Defined Message Ids 
  144.  
  145.      Sort by name or ID 
  146.  
  147.      Undefined Messages IDs 
  148.  
  149.      Include all message IDs 
  150.  
  151.      Define Messages 
  152.  
  153.      Monitor 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 2.2.1.1. Defined Message IDs ΓòÉΓòÉΓòÉ
  157.  
  158. Defined Message IDs are the pre-defined and user-defined messages. Each message 
  159. is displayed as a name and as a hex number. You can select multiple messages 
  160. for monitoring. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 2.2.1.1.1. Sort ΓòÉΓòÉΓòÉ
  164.  
  165. You can sort messages in two ways: 
  166.  
  167.      Select the Name button to sort the message names alphabetically. 
  168.  
  169.      Select the ID button to sort the message IDs numerically. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 2.2.1.1.2. Undefined Messages IDs ΓòÉΓòÉΓòÉ
  173.  
  174. Select one or both of the check boxes in the Undefined Message IDs group box: 
  175.  
  176.      Select Include WM_USER to include all undefined messages that are in the 
  177.       range WM_USER and above. 
  178.  
  179.      Select Include non WM_USER to include all undefined messages that are in 
  180.       the range less than WM_USER. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ 2.2.1.1.3. Include all message IDs ΓòÉΓòÉΓòÉ
  184.  
  185. Select the Include all message IDs check box to include all messages. When this 
  186. check box is enabled, the defined and undefined message selections are 
  187. disabled. 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ 2.2.1.1.4. Monitor ΓòÉΓòÉΓòÉ
  191.  
  192. Monitor 
  193.  
  194.      Select Messages to application to monitor messages that are received by 
  195.       an application. 
  196.  
  197.      Select Messages from application to monitor messages that are dispatched 
  198.       by an application. 
  199.  
  200.      Select Post messages to monitor post messages. 
  201.  
  202.      Select Send messages to monitor send messages. 
  203.  
  204.  
  205. ΓòÉΓòÉΓòÉ 2.2.1.2. Monitor Windows Window ΓòÉΓòÉΓòÉ
  206.  
  207. Use the Monitor Windows window to specify the windows you want monitored. 
  208.  
  209. The Monitor Windows window consists of the following: 
  210.  
  211.      Windows -- Select this check box to see each window displayed with its 
  212.       class and handle. You can select multiple windows for monitoring. 
  213.  
  214.      Sort selections 
  215.  
  216.         -  Select the Class button to sort the window names alphabetically. 
  217.  
  218.         -  Select the Hwnd button to sort the window handles in numerical 
  219.            order. 
  220.  
  221.         -  Select the Parent and z-order button to sort the window handles to 
  222.            show the parent and z-order relationship of application windows. 
  223.  
  224.      Monitor all windows -- Select this check box to monitor all the windows. 
  225.       This disables individual selection. 
  226.  
  227.  
  228. ΓòÉΓòÉΓòÉ 2.2.1.3. Format Message Parameters ΓòÉΓòÉΓòÉ
  229.  
  230. Use the Format Message Parameters dialog to specify how message parameters are 
  231. displayed. 
  232.  
  233. This dialog consists of the following: 
  234.  
  235.      Message -- A list of all the defined messages. 
  236.  
  237.      Sort selections: 
  238.  
  239.         -  Select Name to sort messages alphabetically by name. 
  240.  
  241.         -  Select ID to sort messages numerically by ID. 
  242.  
  243.      Parameter formatting: For each of MP1 and MP2 (Message parameters 1 and 
  244.       2), select an arrow to open the list, and select the desired formatting. 
  245.       Your selections are saved in program profiles. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 2.2.1.4. Define Messages ΓòÉΓòÉΓòÉ
  249.  
  250. Use the Define Messages dialog to define messages. 
  251.  
  252. Message: 
  253.  
  254. In the Name entry field, type in the name of the message that you want to 
  255. define. 
  256.  
  257. In the ID entry field, type in the hex number for the message or use the spin 
  258. button to locate the number of the message. 
  259.  
  260. Default parameter formatting: 
  261.  
  262.      MP1 - Message parameter 1: Select the arrow to open the MP1 list, and 
  263.       select the default type of formatting you want from the parameter list. 
  264.       The formatting selections are saved in program profiles. 
  265.  
  266.      wParam - wParam parameter: Select the arrow to open the wParam list, and 
  267.       select the default type of formatting you want from the parameter list. 
  268.       The formatting selections are saved in program profiles. 
  269.  
  270.      MP2 - Message parameter 2: Select the arrow to open the MP2 list, and 
  271.       select the default type of formatting you want from the parameter list. 
  272.       The formatting selections are saved in program profiles. 
  273.  
  274.      lParam - lParam parameter: Select the arrow to open the lParam list, and 
  275.       select the default type of formatting you want from the parmaeter list. 
  276.       The formatting selections are saved in program profiles. 
  277.  
  278.  Message monitored by default 
  279.  
  280.  Select this check box if you want to monitor the messages by default. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 2.2.1.5. Display Style ΓòÉΓòÉΓòÉ
  284.  
  285. Use the Display Style dialog to specify which columns are displayed in the 
  286. Message Queue window. 
  287.  
  288. Note: The choices you make here will affect system performance. You may want to 
  289. experiment with different settings to see what works best for your system. 
  290.  
  291. Select the columns you want to be displayed in the Message Queue window. These 
  292. are described in the column list. 
  293.  
  294. Select items in the Message Count group box to specify the maximum number of 
  295. messages displayed or deleted at one time 
  296.  
  297. Select Automatic scrolling if you want the window to scroll forward as the 
  298. screen fills with messages. (This choice decreases system performance.) 
  299.  
  300. Select Display titles if you want titles to be displayed in the window. (This 
  301. choice does not affect system performance.) 
  302.  
  303.  
  304. ΓòÉΓòÉΓòÉ 2.2.1.5.1. Column List ΓòÉΓòÉΓòÉ
  305.  
  306. The following column titles are available: 
  307.  
  308.      Class -- Window class of the window handle the message is being directed 
  309.       to 
  310.  
  311.       Note: Some messages do not have a window handle (for example, 
  312.       WinPostQueueMsg) 
  313.  
  314.      Hwnd -- Window handle the message is being directed to 
  315.  
  316.       Note: Some messages do not have a window handle (for example, 
  317.       WinPostQueueMsg) 
  318.  
  319.      Queue -- The message queue the message is being directed to 
  320.  
  321.      Message -- Message name 
  322.  
  323.      Msg ID -- Message formatted as 32-bit signed integer 
  324.  
  325.      Msg-hex -- Message formatted as 32-bit hex number 
  326.  
  327.      MP1 -- Message parameter 1 
  328.  
  329.      wParam -- wParam parameter 
  330.  
  331.      MP2 -- Message parameter 2 
  332.  
  333.      lParam -- lParam parameter 
  334.  
  335.      Type -- Indicates whether the message is a post message or a send message 
  336.  
  337.      Time -- Indicates the time stamp of when the message was generated. The 
  338.       time stamp is an offset from a starting time. Available only for Post 
  339.       messages. 
  340.  
  341.      Mouse -- The mouse position when the message was generated. Available 
  342.       only for Post messages. 
  343.  
  344.      Options -- Message removal options. Available only for Post messages. 
  345.  
  346.      Model -- Message identity. Available only for Send messages. 
  347.  
  348.      Task -- Whether the message was dispatched between tasks or not. 
  349.       Available only for Send messages. 
  350.  
  351.      From PID -- Process identity of the process that dispatched the message. 
  352.       Available only for Send messages. 
  353.  
  354.      From TID -- Thread identity of the thread that dispatched the message. 
  355.       Available only for Send messages. 
  356.  
  357.      To PID -- Process identity of the process that received the message 
  358.  
  359.      To TID -- Thread identity of the thread that received the message 
  360.  
  361.      Direction -- Direction of the message relative to the debuggee process 
  362.  
  363.      -- Debuggee process dispatched a message to another process 
  364.  
  365.      -- Debuggee process received a message from another process 
  366.  
  367.      -- Debuggee process dispatched a message to itself 
  368.  
  369.      -- Whether the debugger processed message on behalf of the debuggee. This 
  370.       occurs when the debuggee is stopped. 
  371.  
  372.  
  373. ΓòÉΓòÉΓòÉ 2.2.1.5.2. Message Count ΓòÉΓòÉΓòÉ
  374.  
  375. Use the Message Count group box to specify how many messages should be 
  376. displayed at one time and how many should be deleted at one time. You may want 
  377. to experiment with different settings to see how they affect performance. 
  378.  
  379.  Maximum displayed Enter the maximum number of messages to display. 
  380.  
  381.  Deleted at one time Enter the number of messages to be deleted at one time. 
  382.            Whenever the message queue list becomes full, this number of 
  383.            messages will be deleted on a first in, first out basis. For optimum 
  384.            performance, use a large number. 
  385.  
  386.  Unlimited If you select unlimited, there is no limit on how many messages are 
  387.            displayed, and the Maximum displayed and Deleted at one time check 
  388.            boxes are not selectable. This choice may decrease performance. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 2.2.1.6. Monitor Message Queue Window (OS/2 Only) ΓòÉΓòÉΓòÉ
  392.  
  393. Use the Monitor Message Queue window (available on OS/2 versions of the 
  394. debugger only) to specify the message queues you want monitored. 
  395.  
  396. This window consists of the following: 
  397.  
  398.      Message Queue -- This section contains a list of the message queues. You 
  399.       can select multiple queues for monitoring. 
  400.  
  401.      Sort selections: 
  402.  
  403.         -  Select HMQ to sort the message queues by message queue handles. 
  404.  
  405.         -  Select TID to sort the message queues by thread id. 
  406.  
  407.      Monitor all message queues -- Select this check box to monitor all the 
  408.       message queues. 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ <hidden> File Menu ΓòÉΓòÉΓòÉ
  412.  
  413.  
  414. ΓòÉΓòÉΓòÉ <hidden> Close MQWA ΓòÉΓòÉΓòÉ
  415.  
  416.  
  417. ΓòÉΓòÉΓòÉ <hidden> Monitors Menu ΓòÉΓòÉΓòÉ
  418.  
  419.  
  420. ΓòÉΓòÉΓòÉ <hidden> Message Queue ΓòÉΓòÉΓòÉ
  421.  
  422.  
  423. ΓòÉΓòÉΓòÉ <hidden> Options Menu ΓòÉΓòÉΓòÉ
  424.  
  425.  
  426. ΓòÉΓòÉΓòÉ <hidden> Fonts ΓòÉΓòÉΓòÉ
  427.  
  428.  
  429. ΓòÉΓòÉΓòÉ <hidden> File Menu ΓòÉΓòÉΓòÉ
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ <hidden> Close MQWA ΓòÉΓòÉΓòÉ
  433.  
  434.  
  435. ΓòÉΓòÉΓòÉ <hidden> Options Menu ΓòÉΓòÉΓòÉ
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ <hidden> Options Menu ΓòÉΓòÉΓòÉ
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ <hidden> Options Menu ΓòÉΓòÉΓòÉ
  442.  
  443.  
  444. ΓòÉΓòÉΓòÉ <hidden> Monitor Messages Window ΓòÉΓòÉΓòÉ
  445.  
  446.  
  447. ΓòÉΓòÉΓòÉ <hidden> Monitor Windows Window ΓòÉΓòÉΓòÉ
  448.  
  449.  
  450. ΓòÉΓòÉΓòÉ <hidden> Monitor Message Queue Window (OS/2 Only) ΓòÉΓòÉΓòÉ
  451.  
  452.  
  453. ΓòÉΓòÉΓòÉ <hidden> Format Message Parameters ΓòÉΓòÉΓòÉ
  454.  
  455.  
  456. ΓòÉΓòÉΓòÉ <hidden> Define Messages ΓòÉΓòÉΓòÉ
  457.  
  458.  
  459. ΓòÉΓòÉΓòÉ <hidden> Display Style ΓòÉΓòÉΓòÉ
  460.  
  461.  
  462. ΓòÉΓòÉΓòÉ <hidden> Fonts ΓòÉΓòÉΓòÉ
  463.  
  464.  
  465. ΓòÉΓòÉΓòÉ <hidden> Message Queue - Process Selection Window ΓòÉΓòÉΓòÉ
  466.  
  467.  
  468. ΓòÉΓòÉΓòÉ <hidden> Message Queue Window ΓòÉΓòÉΓòÉ
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ <hidden> Define Messages ΓòÉΓòÉΓòÉ
  472.  
  473.  
  474. ΓòÉΓòÉΓòÉ <hidden> Display Style ΓòÉΓòÉΓòÉ
  475.  
  476.  
  477. ΓòÉΓòÉΓòÉ <hidden> Format Message Parameters ΓòÉΓòÉΓòÉ
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ <hidden> Monitor Messages Window ΓòÉΓòÉΓòÉ
  481.  
  482.  
  483. ΓòÉΓòÉΓòÉ <hidden> Monitor Message Queue Window (OS/2 Only) ΓòÉΓòÉΓòÉ
  484.  
  485.  
  486. ΓòÉΓòÉΓòÉ <hidden> Monitor Windows Window ΓòÉΓòÉΓòÉ
  487.  
  488.