ÿþ<HTML xmlns="http://www.w3.org/TR/REC-html40"> <HEAD> <TITLE>DDDriverDeprecatedCommands</TITLE> <LINK rel="stylesheet" href="rrafs.css" type="text/css"/> </HEAD> <BODY> <DIV NAME="top" ID="top"> <H3>DDDriverDeprecatedCommands</H3> <SMALL>Last Updated:<script language="JavaScript">document.write(document.lastModified)</script></SMALL> <BR/> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Deprecated Driver Commands for the Cycle, Suite, and Step drivers </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_EndRequirement' HREF='#detail_EndRequirement' >EndRequirement</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> </TR></TABLE> </TD> <TD> DEPRECATED. Use StopRequirement instead.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_EndTestcase' HREF='#detail_EndTestcase' >EndTestcase</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> </TR></TABLE> </TD> <TD> DEPRECATED. Use StopTestCase instead.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_GetVariableValueEx' HREF='#detail_GetVariableValueEx' >GetVariableValueEx</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> </TR></TABLE> </TD> <TD> Replaced by CopyVariableValueEx</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SetRequirement' HREF='#detail_SetRequirement' >SetRequirement</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> </TR></TABLE> </TD> <TD> DEPRECATED. Use StartRequirement instead.</TD> </TR> <TR> <TD nowrap="true" width="27%"><A NAME='list_SetTestcase' HREF='#detail_SetTestcase' >SetTestcase</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> </TR></TABLE> </TD> <TD> DEPRECATED. Use StartTestCase instead.</TD> </TR> </TABLE> <HR/> </DIV> <DIV NAME="detail" ID="detail"> <H3><A NAME='detail_EndRequirement' />DDDriverDeprecatedCommands::<BIG>EndRequirement</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> DEPRECATED. Use StopRequirement instead.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log/process the end of testing associated with a user-defined Requirement.<br> Currently no processing is done with this. Only a log entry occurs. Use StopRequirement which now implements the original intent of this command. </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>RequirementID</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The user-defined ID of the Requirement</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The user-defined ID of the Requirement. The last Requirement provided with the SetRequirement command will be handled by default.</detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C EndRequirement Requirement1</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the end of Requirement1 </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C EndRequirement</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the end of the last Requirement set with SetRequirement </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_EndTestcase' />DDDriverDeprecatedCommands::<BIG>EndTestcase</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> DEPRECATED. Use StopTestCase instead.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log/process the end of testing associated with a user-defined Testcase.<br> Currently no processing is done with this. Only a log entry occurs. Use StopTestCase which now implements the original intent of this command.<br><br> In addition to the above, WRAFS will close the node created by the SETTESTCASE command in the log file. </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>TestCaseID</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The user-defined ID of the Testcase.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> The user-defined ID of the Testcase. The last TestCase provided with the SetTestcase command will be handled by default.</detailed_desc><BR/> </DIV> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C EndTestcase TestCase1</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the end of TestCase1 </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C EndTestcase</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the end of the last TestCase set with SetTestcase. </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_GetVariableValueEx' />DDDriverDeprecatedCommands::<BIG>GetVariableValueEx</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Replaced by CopyVariableValueEx</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>SourceVariable</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The name of the variable to retrieve the value of </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B>DestinationVariable</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The name of the variable to hold the retrieved value </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C, GetVariableValueEx, srcvar, destvar </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Copy the value of variable srcvar to variable destvar (euivalent to ^destvar=^srcvar) </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C, GetVariableValueEx, ^srcvarname, ^destvarname </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Given ^srcvarname contains "srcvar" and ^destvarname contains "destvar", this sets ^destvar to ^srcvar </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C, GetVariableValueEx, ^basename &amp; ^index, destvar </usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Any expression that evaluates to a valid DDVariable name may be used. </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_SetRequirement' />DDDriverDeprecatedCommands::<BIG>SetRequirement</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> DEPRECATED. Use StartRequirement instead.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log/process the beginning of testing associated with a user-defined Requirement.<br> Currently no processing is done with this. Only a log entry occurs. Use StartRequirement which now implements the original intent of this command. </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>RequirementID</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The user-defined ID of the Requirement</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Description</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A description of the Requirement</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C SetRequirement Requirement1</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the start of Requirement1 with no additional description </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C SetRequirement Requirement1 "It Must Compile"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the start of Requirement1 with a description of Requirement1 </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_SetTestcase' />DDDriverDeprecatedCommands::<BIG>SetTestcase</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> </TR></TABLE> </H3> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> DEPRECATED. Use StartTestCase instead.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"><detailed_desc xmlns=""> Log/process the beginning of testing associated with a user-defined Testcase.<br> Currently no processing is done with this. Only a log entry occurs. Use StartTestCase which now implements the original intent of this command.<br><br> In addition to the above functionality, WRAFS will create a new node in the log used by Winrunner. Care should be taken to only use one SETTESTCASE at a time, nesting these will have unpredictable results. </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>TestCaseID</B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> The user-defined ID of the Testcase.</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI>[ <B>Description</B> = ]<BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> A description of the Testcase</short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/></OL ><B>Examples:</B><BR/><UL> <LI> <B><usage xmlns="">C SetTestcase TestCase1</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the start of TestCase1 with no additional description </short_desc></DIV> <BR/> <DIV NAME="list" ID="detail_desc"/> </LI> <BR/> <LI> <B><usage xmlns="">C SetTestcase TestCase1 "It Must Compile"</usage></B> <BR/> <DIV NAME="list" ID="short_desc"><short_desc xmlns=""> Logs the start of TestCase1 with a description of TestCase1 </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>