home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cset21v1.zip / IBMCPP / HELP / DDE4XTR2.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-10-06  |  7KB  |  211 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Special Notices ΓòÉΓòÉΓòÉ
  3.  
  4. References in this help to IBM products, programs, or services do not imply 
  5. that IBM intends to make these available in all countries in which IBM 
  6. operates. 
  7.  
  8. Any reference to an IBM licensed program in this help is not intended to state 
  9. or imply that only IBM's licensed program may be used.  Any functionally 
  10. equivalent product, program, or service that does not infringe on any of IBM's 
  11. intellectual property rights may be used instead of the IBM product, program, 
  12. or service. 
  13.  
  14. Evaluation and verification of operation in conjunction with other products, 
  15. except those expressly designated by IBM, is the user's responsibility. 
  16.  
  17. IBM may have patents or pending patent applications covering subject matter in 
  18. this help.  The furnishing of this help does not give you any license to these 
  19. patents. 
  20.  
  21. The following terms, denoted by an asterisk (*) in this help, are trademarks of 
  22. the IBM corporation in the United States and/or other countries: 
  23.  
  24.  IBM 
  25.  OS/2 
  26.  Operating System/2 
  27.  Presentation Manager 
  28.  WorkFrame/2. 
  29.  
  30.  
  31. ΓòÉΓòÉΓòÉ 2. EXTRA Options ΓòÉΓòÉΓòÉ
  32.  
  33. Use the EXTRA Options notebook to specify the parameters to be passed to the 
  34. IBM* C/C++ Tools Execution Trace Analyzer (EXTRA) when you start it from the 
  35. WorkFrame/2 environment. 
  36.  
  37. In this notebook, you can: 
  38.  
  39. o Specify any parameters you want to pass to the program to be traced 
  40.  
  41. o Specify whether you would like EXTRA to prompt you for parameters to pass to 
  42.   your program when it starts up. 
  43.  
  44.  
  45. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  46.  
  47. Click on the OK push button save the EXTRA options settings and close the 
  48. Browser Options notebook. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  52.  
  53. Click on the Cancel push button to remove the EXTRA Options notebook from the 
  54. screen without saving any changes. 
  55.  
  56.  
  57. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  58.  
  59. Click on the Help push button to get help on the EXTRA Options notebook. 
  60.  
  61.  
  62. ΓòÉΓòÉΓòÉ 2.1. Program Parameters ΓòÉΓòÉΓòÉ
  63.  
  64. In the Program Parameters entry field, type any parameters you want to pass to 
  65. your program. 
  66.  
  67. You can also specify program parameters when EXTRA starts up by selecting the 
  68. Prompt required checkbox. 
  69.  
  70.  
  71. ΓòÉΓòÉΓòÉ 2.2. Prompt ΓòÉΓòÉΓòÉ
  72.  
  73. Use the Prompt group box to specify whether you would like EXTRA to display the 
  74. Startup Information action window when it starts up.  The Startup Information 
  75. window prompts you for the parameters you want to pass to your program during 
  76. the profiling run. 
  77.  
  78. For a detailed explanation of each field, select its name from the list below: 
  79.  
  80. o Prompt required 
  81. o Title 
  82.  
  83.  
  84. ΓòÉΓòÉΓòÉ 2.2.1. Prompt Required ΓòÉΓòÉΓòÉ
  85.  
  86. Select Prompt required checkbox to have the Startup Information window 
  87. displayed when EXTRA starts up. 
  88.  
  89.  
  90. ΓòÉΓòÉΓòÉ 2.2.2. Title ΓòÉΓòÉΓòÉ
  91.  
  92. In the Title entry field, type any description or title that relates to your 
  93. program or project.  The title you specify will be displayed in the Startup 
  94. Information action window when EXTRA starts up. 
  95.  
  96. This option is unavailable when the Prompt required checkbox is not selected. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ <hidden> Reset Page ΓòÉΓòÉΓòÉ
  100.  
  101. Click on the Reset Page push button to update the EXTRA options settings in 
  102. this page with their initial values. 
  103.  
  104.  
  105. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  106.  
  107. Click on the Default push button to update the EXTRA options with their default 
  108. values. 
  109.  
  110.  
  111. ΓòÉΓòÉΓòÉ <hidden> Invocation Parameters ΓòÉΓòÉΓòÉ
  112.  
  113. In the Invocation Parameters entry field, type any parameters you want to pass 
  114. to your program. 
  115.  
  116. Initially, this field contains the parameters you entered in the Program 
  117. Parameters field of the EXTRA Options notebook.  To change the parameters to 
  118. pass to your program, type the new parameters in the field. 
  119.  
  120. Any parameters you specify in this field override any parameters specified in 
  121. the Program Parameters field in the EXTRA Options notebook. 
  122.  
  123. If you leave this field blank, no parameters are passed to your program. 
  124.  
  125.  
  126. ΓòÉΓòÉΓòÉ <hidden> OK ΓòÉΓòÉΓòÉ
  127.  
  128. Click on the OK push button to pass any specified invocation parameters to your 
  129. program and run your program under the control of EXTRA. 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ <hidden> Reset ΓòÉΓòÉΓòÉ
  133.  
  134. Click on the Reset push button to update the Invocation Parameters field with 
  135. its initial value. 
  136.  
  137.  
  138. ΓòÉΓòÉΓòÉ <hidden> Default ΓòÉΓòÉΓòÉ
  139.  
  140. Click on the Default push button to update the Invocation Parameters field with 
  141. the system default value, that is, a blank field. 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ <hidden> Cancel ΓòÉΓòÉΓòÉ
  145.  
  146. Click on the Cancel push button to close the EXTRA Options notebook without 
  147. saving any changes. 
  148.  
  149.  
  150. ΓòÉΓòÉΓòÉ <hidden> Help ΓòÉΓòÉΓòÉ
  151.  
  152. Click on the Help push button to get help on the Startup Information window. 
  153.  
  154.  
  155. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  156.  
  157. Explanation: 
  158.  
  159. You have chosen to discard any changes you made to the EXTRA options settings. 
  160.  
  161. Recovery 
  162.  
  163. Select Yes to discard the changes and close the EXTRA Options notebook.  Select 
  164. No to retain the changes and return to the previous page without exiting from 
  165. the notebook. 
  166.  
  167.  
  168. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  169.  
  170. Explanation: 
  171.  
  172. An error occurred while trying to allocate memory.  There may be insufficient 
  173. memory to complete the task. 
  174.  
  175. Recovery: 
  176.  
  177. Close one or more other tasks, and retry the command. 
  178.  
  179.  
  180. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  181.  
  182. Explanation: 
  183.  
  184. The options file for your project has been corrupted. 
  185.  
  186. Recovery: 
  187.  
  188. Select the Default pushbutton to use the default options, then reset them to 
  189. your preferred settings. 
  190.  
  191.  
  192. ΓòÉΓòÉΓòÉ <hidden> Message Help ΓòÉΓòÉΓòÉ
  193.  
  194. Explanation: 
  195.  
  196. You are using the incorrect version of the options file for your project. 
  197.  
  198. Recovery: 
  199.  
  200. Select Yes to map your option settings to the current version. 
  201.  
  202. Note:  Because options have changed between versions, the mapping will not be 
  203.        complete.  Settings for options that have been added since the previous 
  204.        version will be set to the default. 
  205.  
  206. Select No to use the default settings. 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  210.  
  211. Trademark of the IBM Corporation