ÿþ<HTML xmlns="http://www.w3.org/TR/REC-html40"> <HEAD> <TITLE>DDDriverLogCommands</TITLE> <LINK rel="stylesheet" href="rrafs.css" type="text/css"/> </HEAD> <BODY> <DIV NAME="top" ID="top"> <H3>DDDriverLogCommands</H3> <SMALL>Last Updated:<script language="JavaScript">document.write(document.lastModified)</script></SMALL> <BR/> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Driver Commands for Logging </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""><p> This keyword library provides Driver Commands that can be used by all three DDE Drivers--CycleDriver, SuiteDriver, and StepDriver. That means they can be used in any keyword driven test tables regardless of the test tables level--Cycle, Suite, or Step.</p><p> Each different driver command has different parameters as described in its documentation. For reference, the first fields of ALL Driver Command test records are defined below:</p><dl><dd>Field #1</dd><dt>The "C" = DRIVER COMMAND record type specifier.</dt><dd>Field #2</dd><dt>The Driver Command keyword.</dt></dl><p> Example:</p><code>c , SetApplicationMap , "AppMap.map"</code><p> Driver Command parameters must be placed in the test record in the field position specified in the documentation. Some parameters are optional. However, the field associated with that parameter must be honored. If you wish to skip an optional parameter you must still provide an empty field for that parameter.</p><p> Example:</p><code>c, LaunchApplication, NOTEPAD, NOTEPAD.EXE, , , "AppMap.map"</code><p> The above example shows two optional fields after NOTEPAD.EXE which are given no value(skipped).</p><p> Note that the full availablility of all Driver Commands is now spread across several files. Together, all of these files provide all the Driver Commands available to the core framework.</p><dl><dd><a href="DDDriverCommands.htm" target="_blank">DDDriverCommands</a></dd><dt>Miscellaneous and often used Commands.</dt><dd><a href="DDDriverLogCommands.htm" target="_blank">DDDriverLogCommands</a></dd><dt>Commands focused on logging test execution.</dt><dd><a href="DDDriverFlowCommands.htm" target="_blank">DDDriverFlowCommands</a></dd><dt>Commands focused on Error Recovery and Flow Control.</dt><dd><a href="DDDriverCounterCommands.htm" target="_blank">DDDriverCounterCommands</a></dd><dt>Commands focused on status tracking.</dt><dd><a href="DDDriverDeprecatedCommands.htm" target="_blank">DDDriverDeprecatedCommands</a></dd><dt>Commands that are still provided for backward compatibility, but are no longer supported.</dt><dd><a href="DDDriverDebugCommands.htm" target="_blank">DDDriverDebugCommands</a></dd><dt>Commands focused on debugging test execution.</dt></dl></detailed_desc><BR/> </DIV> </DIV> <BR/> <DIV NAME="list" ID="list"> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <TABLE cellspacing="3" border="1" cellpadding="2"> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogFailureOK' HREF='#detail_LogFailureOK' >LogFailureOK</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log an EXPECTED failure message.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogMessage' HREF='#detail_LogMessage' >LogMessage</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log a generic message</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogTestFailure' HREF='#detail_LogTestFailure' >LogTestFailure</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log a FAILURE message. Also increments appropriate counters.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogTestSuccess' HREF='#detail_LogTestSuccess' >LogTestSuccess</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log a SUCCESS/OK message. Also increments appropriate counters.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogTestWarning' HREF='#detail_LogTestWarning' >LogTestWarning</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log a WARNING message. Also increments appropriate counters.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_LogWarningOK' HREF='#detail_LogWarningOK' >LogWarningOK</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Log an EXPECTED WARNING message.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_ResumeLogging' HREF='#detail_ResumeLogging' >ResumeLogging</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Resume suspended logging. </TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SuspendLogging' HREF='#detail_SuspendLogging' >SuspendLogging</A></TD><TD width="12%" align="CENTER"> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </TD> <TD> Suspend all logging. </TD> </TR> </TABLE> <HR/> </DIV> <DIV NAME="detail" ID="detail"> <H3><A NAME='detail_LogFailureOK' />DDDriverLogCommands::<BIG>LogFailureOK</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log an EXPECTED failure message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log that a failure was expected and, as such, is OK.<br> You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogFailureOK "Values should not match."</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A FAILED OK message logged with no additional detail. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogFailureOK "Throw exception." "Data is out of bounds."</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A FAILED OK message logged with addional details. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_LogMessage' />DDDriverLogCommands::<BIG>LogMessage</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log a generic message</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log a generic message. You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogMessage "Starting Test 1"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A message logged with no additional detail </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogMessage "Starting Test 1" "Start Login Tests"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A message logged with detail added </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_LogTestFailure' />DDDriverLogCommands::<BIG>LogTestFailure</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log a FAILURE message. Also increments appropriate counters.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log a FAILURE message. Also increments appropriate counters.<br> You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogTestFailure "Failed Test 1"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A FAILED message logged with no additional detail </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogTestFailure "Failed Test 1" "Failed Login Tests"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A FAILED message logged with detail added </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_LogTestSuccess' />DDDriverLogCommands::<BIG>LogTestSuccess</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log a SUCCESS/OK message. Also increments appropriate counters.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log a SUCCESS/OK message. Also increments appropriate counters.<br> You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogTestSuccess "Test 1 Passed"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A test success message logged with no additional detail </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogTestSuccess "Test 1 Passed" "Test 1 is good"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A test success message logged with detail added </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_LogTestWarning' />DDDriverLogCommands::<BIG>LogTestWarning</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log a WARNING message. Also increments appropriate counters.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log a WARNING message. Also increments appropriate counters.<br> You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogTestWarning "Test 1 may have problems"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A WARNING message logged with no additional detail </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogTestWarning "Test 1 may have problems" "Test 1 did not complete"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A WARNING message logged with detail added </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_LogWarningOK' />DDDriverLogCommands::<BIG>LogWarningOK</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='WR.GIF' ALT='Mercury Interactive WinRunner'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Log an EXPECTED WARNING message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log that a WARNING was expected and, as such, is OK.<br> You can optionally add an additional details description that follows the message. </detailed_desc><BR/> </DIV> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI> <B>Message</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The message to log.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Details</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Additional detail to add to the message.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C LogWarningOK "No value specified."</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> An expected WARNING message logged with no additional detail. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C LogWarningOK "No value specified" "Using default value."</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> An expected WARNING message logged with additional detail. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_ResumeLogging' />DDDriverLogCommands::<BIG>ResumeLogging</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Resume suspended logging. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI>[ <B>logName</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The name of a Log Facility, other than the "current" one, to resume. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Normally, this parameter would NOT be specified, and thus ALL logging would be resumed. However, there may be the case that a test is using multiple different logs and the tester is trying to resume a specific one. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C, ResumeLogging</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Resumes all suspended logging. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C, ResumeLogging, MainLog</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Resume only the log opened as "MainLog". </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> <H3><A NAME='detail_SuspendLogging' />DDDriverLogCommands::<BIG>SuspendLogging</BIG> <TABLE><TR> <TD class="borderStyle"><IMG SRC='RC.GIF' ALT='Rational Robot Classic'/></TD> <TD class="borderStyle"><IMG SRC='TID.GIF' ALT='SAFS TID Commands'/></TD> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Suspend all logging. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> <BR/> <DIV NAME="list" ID="other"> <B>Fields: [ ]</B>=<SMALL>Optional with Default Value</SMALL><BR/> <OL start="3" ><LI>[ <B>logName</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The name of a Log Facility if other than the "current" one. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Normally, this parameter would NOT be specified, and thus ALL logging would be suspended. However, there may be the case that a test is using multiple different logs and the tester is trying to suspend a specific one. </detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C, SuspendLogging</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Suspend all logging. </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C, SuspendLogging, MainLog</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Suspend only the log opened as "MainLog". </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> </UL> <A href="SAFSReferenceKey.htm" alt="Reference Legend or Key"> <SMALL><B>[How To Read This Reference]</B></SMALL> </A> <HR/></DIV> </DIV> </BODY> </HTML>