windows-server-2003/sdktools/trace/traceview/traceviewhelp/controllingtracelogsessions...

<html>

<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=Generator content="Microsoft Word 10 (filtered)">
<title>Joining Existing Trace Log Sessions</title>

<style>
<!--
 /* Font Definitions */
 @font-face
	{font-family:Verdana;
	panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
	{font-family:"MS Sans Serif";
	panose-1:0 0 0 0 0 0 0 0 0 0;}
 /* Style Definitions */
 p.MsoNormal, li.MsoNormal, div.MsoNormal
	{margin:0in;
	margin-bottom:.0001pt;
	font-size:12.0pt;
	font-family:"Times New Roman";}
h3
	{margin-right:0in;
	margin-left:0in;
	font-size:13.5pt;
	font-family:"Times New Roman";
	font-weight:bold;}
a:link, span.MsoHyperlink
	{color:blue;
	text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
	{color:purple;
	text-decoration:underline;}
p
	{margin-right:0in;
	margin-left:0in;
	font-size:12.0pt;
	font-family:"Times New Roman";}
@page Section1
	{size:8.5in 11.0in;
	margin:1.0in 1.25in 1.0in 1.25in;}
div.Section1
	{page:Section1;}
 /* List Definitions */
 ol
	{margin-bottom:0in;}
ul
	{margin-bottom:0in;}
-->
</style>

</head>

<body lang=EN-US link=blue vlink=purple>

<div class=Section1>

<p><b><span style='font-size:24.0pt'>Controlling Trace Log Sessions</span></b></p>

<p style='margin-bottom:12.0pt'>Once a trace log session has been created, as
explained in <a href="CreatingNewTraceLogSessions.htm">Creating New Trace Log
Sessions</a>, TraceView can be used to control activities of that
session.&nbsp; &nbsp;&nbsp;All control options for a given session are
available by right clicking the session�s line in the Trace Log Session List
window in TraceView as shown here:</p>

<p style='margin-bottom:12.0pt'>&nbsp;</p>

<p style='margin-bottom:12.0pt'><img border=0 width=820 height=295
src="ControllingTraceLogSessions_files/image001.jpg"></p>

<h3><span style='font-size:12.0pt;font-family:Verdana'>&nbsp;</span></h3>

<h3><span style='font-size:12.0pt;font-weight:normal'>The possible options are:</span></h3>

<ul style='margin-top:0in' type=disc>
 <li class=MsoNormal>Start Trace</li>
 <li class=MsoNormal>Stop Trace</li>
 <li class=MsoNormal>Group Sessions</li>
 <li class=MsoNormal>Ungroup Sessions</li>
 <li class=MsoNormal>Remove Log Session</li>
</ul>

<h3><span style='font-size:12.0pt'>Starting Trace Log Sessions</span></h3>

<h3><span style='font-size:12.0pt;font-weight:normal'>Newly created log
sessions are started automatically.&nbsp; But, once stopped a log session has
to be explicitly started again from the the menu above.&nbsp; Starting the log
session both starts the providers associated with the trace log session and starts
TraceView consuming events from those providers.&nbsp; Only stopped trace log
sessions will have Start Trace as an option.&nbsp; Grouped trace log sessions
all start together, and cannot be started individually while grouped.</span></h3>

<h3><span style='font-size:12.0pt'>Stoping Trace Log Sessions</span></h3>

<h3><span style='font-size:12.0pt;font-weight:normal'>Stopping a currently
active trace log session causes the providers associated with the trace log
session to stop generating events and it stops TraceView from attempting to
consume events from those providers.&nbsp; Only currently active trace log
sessions will have Stop Trace as an option.&nbsp; Grouped sessions all stop
together and cannot be individually stopped while grouped.</span></h3>

<h3><span style='font-size:12.0pt'>Grouping Trace Log Sessions</span></h3>

<h3><span style='font-size:12.0pt;font-weight:normal'>It is possible to group
multiple distinct trace log sessions together in TraceView, such that all trace
log sessions have their events displayed in a single display window.&nbsp;
Grouping is accomplished in a similar fashion to start or stop by right
clicking on the session�s line in the Trace Log Session List window and
selecting the appropriate option from the pop-up menu.&nbsp; Grouping of active
trace log sessions is only supported on .NET and later operating systems.&nbsp;
Grouping of multiple existing log file sessions is supported on all platforms
supporting TraceView.&nbsp; �Group Sessions� will only appear as a valid option
if multiple trace log sessions for real-time trace providers are selected, or
multiple existing log file sessions are selected, but not both.&nbsp; Also, for
real-time trace log sessions, the sessions must all be stopped in order for the
�Group Sessions� to be a valid option.&nbsp; Again, �Group Sessions� will not
show up as a valid option for real-time trace log sessions on any platform
prior to the .NET platforms.&nbsp; Once grouped, all trace log session trace
output will displayed to a single display window for all trace log sessions in
the group. &nbsp;Upon grouping, if any display windows end up having no trace
log sessions associated with them, they are removed.</span></h3>

<h3><span style='font-size:12.0pt'>Ungrouping Trace Log Sessions</span></h3>

<h3><span style='font-size:12.0pt;font-weight:normal'>�Ungroup Sessions� is
only a valid option for stopped trace log sessions.&nbsp; When ungrouped, all
trace log sessions are automatically restarted.&nbsp; Ungrouped sessions are
given a new display window for output.</span></h3>

<h3><span style='font-size:12.0pt'>Removing Trace Log Sessions</span></h3>

<h3 style='margin-bottom:13.5pt'><span style='font-size:12.0pt;font-weight:
normal'>Only stopped trace log sessions can be removed.&nbsp; Removal of a log session
will cause the removal of the trace log session�s information from the Trace
Log Session List window, and will cause the associated display window to be
deleted, if the trace log session is the last associated session with that
display window.</span></h3>

<p class=MsoNormal style='margin-left:.25in'>&nbsp;</p>

<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=873
 style='width:654.65pt'>
 <tr style='height:.05in'>
  <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:.05in'>
  <p class=MsoNormal style='line-height:3.6pt'><span style='font-size:2.0pt'>&nbsp;</span></p>
  </td>
 </tr>
</table>

<p><b><span style='font-size:10.0pt;font-family:"MS Sans Serif"'>� Microsoft
Corporation 2002</span></b></p>

<h3><span style='font-weight:normal'>&nbsp;</span></h3>

<p style='margin-bottom:12.0pt'>&nbsp;</p>

</div>

</body>

</html>