Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

276 lines
11 KiB

  1. <html>
  2. <head>
  3. <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
  4. <meta name=Generator content="Microsoft Word 10 (filtered)">
  5. <title>Creating Trace Log Sessions</title>
  6. <style>
  7. <!--
  8. /* Font Definitions */
  9. @font-face
  10. {font-family:Verdana;
  11. panose-1:2 11 6 4 3 5 4 4 2 4;}
  12. @font-face
  13. {font-family:"MS Sans Serif";
  14. panose-1:0 0 0 0 0 0 0 0 0 0;}
  15. /* Style Definitions */
  16. p.MsoNormal, li.MsoNormal, div.MsoNormal
  17. {margin:0in;
  18. margin-bottom:.0001pt;
  19. font-size:12.0pt;
  20. font-family:"Times New Roman";}
  21. h1
  22. {margin-top:12.0pt;
  23. margin-right:0in;
  24. margin-bottom:3.0pt;
  25. margin-left:0in;
  26. page-break-after:avoid;
  27. font-size:16.0pt;
  28. font-family:Arial;
  29. font-weight:bold;}
  30. h3
  31. {margin-right:0in;
  32. margin-left:0in;
  33. font-size:13.5pt;
  34. font-family:"Times New Roman";
  35. font-weight:bold;}
  36. h4
  37. {margin-top:12.0pt;
  38. margin-right:0in;
  39. margin-bottom:3.0pt;
  40. margin-left:0in;
  41. page-break-after:avoid;
  42. font-size:14.0pt;
  43. font-family:"Times New Roman";
  44. font-weight:bold;}
  45. a:link, span.MsoHyperlink
  46. {color:blue;
  47. text-decoration:underline;}
  48. a:visited, span.MsoHyperlinkFollowed
  49. {color:blue;
  50. text-decoration:underline;}
  51. p
  52. {margin-right:0in;
  53. margin-left:0in;
  54. font-size:12.0pt;
  55. font-family:"Times New Roman";}
  56. @page Section1
  57. {size:8.5in 11.0in;
  58. margin:1.0in 1.25in 1.0in 1.25in;}
  59. div.Section1
  60. {page:Section1;}
  61. /* List Definitions */
  62. ol
  63. {margin-bottom:0in;}
  64. ul
  65. {margin-bottom:0in;}
  66. -->
  67. </style>
  68. </head>
  69. <body lang=EN-US link=blue vlink=blue>
  70. <div class=Section1>
  71. <h1><span style='font-size:24.0pt;font-family:"Times New Roman"'>Opening
  72. Existing Log Files</span></h1>
  73. <h4><span style='font-size:12.0pt'>Using TraceView To Open An Existing Log File</span></h4>
  74. <p style='margin-bottom:12.0pt'>TraceView can be started by running it from the
  75. command-line with no options, or double clicking its icon in Windows Explorer.
  76. &nbsp;A new trace logging session may be started by selecting &quot;File&quot;
  77. and then &quot;Create New Log Session&quot;. &nbsp;Alternatively, right
  78. clicking any blank area of the Log Session window causes a pop-up menu to appear
  79. from which appropriate action can be selected.</p>
  80. <p style='margin-bottom:12.0pt'><br>
  81. <img width=764 height=209 src="OpeningExistingLogFiles_files/image001.jpg"></p>
  82. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  83. normal'><br>
  84. Selecting �Open Existing Log File� pops up the </span><span style='font-size:
  85. 12.0pt'>Log File Selection</span><span style='font-size:12.0pt;font-weight:
  86. normal'> window.&nbsp; The �Log File Name� edit box is where the name of the log
  87. file (.etl file) to be opened is specified.� The box is initially blank, as no
  88. log file is specified.� The other options let the user specify whether or not
  89. to create listing and/or summary output files, and to name those files.</span></h3>
  90. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt'>&nbsp;</span></h3>
  91. <h3><span style='font-weight:normal'><img width=431 height=328
  92. src="OpeningExistingLogFiles_files/image002.jpg"></span></h3>
  93. <h3>&nbsp;</h3>
  94. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  95. normal'>The ��� button to the right of the �Log File Name� edit box is a browse
  96. button that brings up a file open dialog allowing the user to browse the system
  97. for the appropriate log file as shown below:</span></h3>
  98. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  99. normal'>&nbsp;</span></h3>
  100. <h3 style='margin-bottom:13.5pt'><img width=428 height=273
  101. src="OpeningExistingLogFiles_files/image003.jpg"></h3>
  102. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  103. normal'>&nbsp;</span></h3>
  104. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  105. normal'>Clicking the �Open� button will cause TraceView to open the log file
  106. for reading.� The log file must exist, and a warning will be displayed if it
  107. does not.� Once a valid log file is selected, and the �Open� button selected,
  108. the </span><span style='font-size:12.0pt'>Log File Selection </span><span
  109. style='font-size:12.0pt;font-weight:normal'>window is updated with the new log
  110. file name:</span></h3>
  111. <h3 style='margin-bottom:13.5pt'><img width=431 height=328
  112. src="OpeningExistingLogFiles_files/image004.jpg"></h3>
  113. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  114. normal'><br>
  115. Click the �OK� button to bring up the </span><span style='font-size:12.0pt'>Format
  116. Information Setup</span><span style='font-size:12.0pt;font-weight:normal'>
  117. window.� </span></h3>
  118. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt'>&nbsp;</span></h3>
  119. <h3 style='margin-bottom:13.5pt'><span style='font-weight:normal'><img
  120. width=438 height=302 src="OpeningExistingLogFiles_files/image005.jpg"></span></h3>
  121. <h3 style='margin-bottom:13.5pt'>&nbsp;</h3>
  122. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  123. normal'>Two options are available for providing trace event format information
  124. to TraceView.</span></h3>
  125. <h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:13.5pt;margin-left:
  126. .75in;text-indent:-.25in'><span style='font-size:12.0pt;font-weight:normal'>1.)<span
  127. style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp; </span></span><span
  128. style='font-size:12.0pt;font-weight:normal'>A PDB file which contains the
  129. format GUID information internally.</span></h3>
  130. <h3 style='margin-top:5.0pt;margin-right:0in;margin-bottom:13.5pt;margin-left:
  131. .75in;text-indent:-.25in'><span style='font-size:12.0pt;font-weight:normal'>2.)<span
  132. style='font:7.0pt "Times New Roman"'>&nbsp;&nbsp;&nbsp; </span></span><span
  133. style='font-size:12.0pt;font-weight:normal'>TMF file(s) which have the format
  134. GUID information for the trace events.</span></h3>
  135. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  136. normal'>A PDB file can be entered directly into the PDB edit box in the window
  137. above, or the ��� button can be used to browse for a suitable PDB file. �If a valid
  138. PDB file is selected, the previously specified log file is opened and the trace
  139. event data displayed:</span></h3>
  140. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  141. normal'>&nbsp;</span></h3>
  142. <h3 style='margin-bottom:13.5pt'><img width=885 height=315
  143. src="OpeningExistingLogFiles_files/image006.jpg"></h3>
  144. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  145. normal'>&nbsp;</span></h3>
  146. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  147. normal'>Notice that the �State� column in the </span><span style='font-size:
  148. 12.0pt'>Trace Log Session List</span><span style='font-size:12.0pt;font-weight:
  149. normal'> window shows the session as �Existing�.� This is always the state of
  150. an existing log file opened in TraceView.</span></h3>
  151. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  152. normal'>If the user selected the TMF file(s) option back in the </span><span
  153. style='font-size:12.0pt'>Format Information Setup </span><span
  154. style='font-size:12.0pt;font-weight:normal'>window, then when the �OK� button
  155. is clicked, the </span><span style='font-size:12.0pt'>Format Information Source
  156. Select</span><span style='font-size:12.0pt;font-weight:normal'> window appears.</span></h3>
  157. <h3 style='margin-bottom:13.5pt'><img width=287 height=186
  158. src="OpeningExistingLogFiles_files/image007.jpg"></h3>
  159. <h3 style='margin-bottom:13.5pt'><span style='font-weight:normal'>The TMF
  160. location can be specified in two ways.� Either the TMF files can be specified directly,
  161. or a TMF path can be specified which tells TraceView the location of the files,
  162. but lets TraceView determine which files at that location are needed.� If the �Select
  163. TMF Files� radio button is selected, and the user subsequently clicks �OK�, the
  164. following Trace Format Information Setup window is displayed:</span></h3>
  165. <h3 style='margin-bottom:13.5pt'><img width=413 height=294
  166. src="OpeningExistingLogFiles_files/image008.jpg"></h3>
  167. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  168. normal'>The �Trace Format and Display Information� list control lists all TMF
  169. files selected for the given log file.� The list is blank in the screenshot
  170. above as no TMF files have been selected.� To add a TMF file or files to the
  171. list the user clicks the �Add� button and a file open dialog appears:</span></h3>
  172. <h3 style='margin-bottom:13.5pt'><img width=428 height=273
  173. src="OpeningExistingLogFiles_files/image009.jpg"></h3>
  174. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  175. normal'>&nbsp;</span></h3>
  176. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  177. normal'>Multiple TMF files can be selected from this dialog.� Whenever all
  178. files have been selected, clicking �Open� returns back to the previous window.�
  179. The window is updated with the new TMF information:</span></h3>
  180. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  181. normal'>&nbsp;</span></h3>
  182. <h3 style='margin-bottom:13.5pt'><img width=413 height=294
  183. src="OpeningExistingLogFiles_files/image010.jpg"></h3>
  184. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  185. normal'>&nbsp;</span></h3>
  186. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  187. normal'>Once all desired TMFs have been listed clicking �Done� causes TraceView
  188. to open the log file and display the trace event data.</span></h3>
  189. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  190. normal'>If the user specifed the �Set TMF Search Path� option in the </span><span
  191. style='font-size:12.0pt'>Format Information Source Select </span><span
  192. style='font-size:12.0pt;font-weight:normal'>window, then the </span><span
  193. style='font-size:12.0pt'>Select Directory</span><span style='font-size:12.0pt;
  194. font-weight:normal'> window would appear when �OK� is clicked:</span></h3>
  195. <h3 style='margin-bottom:13.5pt'><img width=254 height=250
  196. src="OpeningExistingLogFiles_files/image011.jpg"></h3>
  197. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  198. normal'>This window allows the user to select the path to the TMF file(s).�
  199. Only one path can be used for a given log file.� When �OK� is clicked from this
  200. window, TraceView will open the log file and display the trace event
  201. information.</span></h3>
  202. <h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
  203. normal'>&nbsp;</span></h3>
  204. <p align=center style='margin-bottom:12.0pt;text-align:center'><b><span
  205. style='font-size:10.0pt;font-family:Verdana'><a
  206. href="CreatingNewTraceLogSessions.htm">Top of page</a></span></b></p>
  207. <p align=center style='margin-bottom:12.0pt;text-align:center'>&nbsp;</p>
  208. <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=873
  209. style='width:654.65pt'>
  210. <tr style='height:.05in'>
  211. <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:.05in'>
  212. <p class=MsoNormal style='line-height:3.6pt'><span style='font-size:2.0pt'>&nbsp;</span></p>
  213. </td>
  214. </tr>
  215. </table>
  216. <p><b><span style='font-size:11.0pt;font-family:"MS Sans Serif"'>� Microsoft
  217. Corporation 2002</span></b></p>
  218. <h3><span style='font-weight:normal'>&nbsp;</span></h3>
  219. </div>
  220. </body>
  221. </html>