DDDriverDeprecatedCommands

Last Updated:

Deprecated Driver Commands for the Cycle, Suite, and Step drivers

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.

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:

Field #1
The "C" = DRIVER COMMAND record type specifier.
Field #2
The Driver Command keyword.

Example:

c , SetApplicationMap , "AppMap.map"

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.

Example:

c, LaunchApplication, NOTEPAD, NOTEPAD.EXE, , , "AppMap.map"

The above example shows two optional fields after NOTEPAD.EXE which are given no value(skipped).

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.

DDDriverCommands
Miscellaneous and often used Commands.
DDDriverLogCommands
Commands focused on logging test execution.
DDDriverFlowCommands
Commands focused on Error Recovery and Flow Control.
DDDriverCounterCommands
Commands focused on status tracking.
DDDriverDeprecatedCommands
Commands that are still provided for backward compatibility, but are no longer supported.
DDDriverDebugCommands
Commands focused on debugging test execution.


[How To Read This Reference]
EndRequirement
RC WR
DEPRECATED. Use StopRequirement instead.
EndTestcase
RC WR
DEPRECATED. Use StopTestCase instead.
GetVariableValueEx
RC WR
Replaced by CopyVariableValueEx
SetRequirement
RC WR
DEPRECATED. Use StartRequirement instead.
SetTestcase
RC WR
DEPRECATED. Use StartTestCase instead.

DDDriverDeprecatedCommands::EndRequirement
RC WR

DEPRECATED. Use StopRequirement instead.

Log/process the end of testing associated with a user-defined Requirement.
Currently no processing is done with this. Only a log entry occurs. Use StopRequirement which now implements the original intent of this command.


Fields: [ ]=Optional with Default Value
  1. [ RequirementID = ]
    The user-defined ID of the Requirement

    The user-defined ID of the Requirement. The last Requirement provided with the SetRequirement command will be handled by default.

Examples:
[How To Read This Reference]

DDDriverDeprecatedCommands::EndTestcase
RC WR

DEPRECATED. Use StopTestCase instead.

Log/process the end of testing associated with a user-defined Testcase.
Currently no processing is done with this. Only a log entry occurs. Use StopTestCase which now implements the original intent of this command.

In addition to the above, WRAFS will close the node created by the SETTESTCASE command in the log file.


Fields: [ ]=Optional with Default Value
  1. [ TestCaseID = ]
    The user-defined ID of the Testcase.

    The user-defined ID of the Testcase. The last TestCase provided with the SetTestcase command will be handled by default.

Examples:
[How To Read This Reference]

DDDriverDeprecatedCommands::GetVariableValueEx
RC WR

Replaced by CopyVariableValueEx


Fields: [ ]=Optional with Default Value
  1. SourceVariable
    The name of the variable to retrieve the value of


  2. DestinationVariable
    The name of the variable to hold the retrieved value


Examples:
  • C, GetVariableValueEx, srcvar, destvar
    Copy the value of variable srcvar to variable destvar (euivalent to ^destvar=^srcvar)


  • C, GetVariableValueEx, ^srcvarname, ^destvarname
    Given ^srcvarname contains "srcvar" and ^destvarname contains "destvar", this sets ^destvar to ^srcvar


  • C, GetVariableValueEx, ^basename & ^index, destvar
    Any expression that evaluates to a valid DDVariable name may be used.


[How To Read This Reference]

DDDriverDeprecatedCommands::SetRequirement
RC WR

DEPRECATED. Use StartRequirement instead.

Log/process the beginning of testing associated with a user-defined Requirement.
Currently no processing is done with this. Only a log entry occurs. Use StartRequirement which now implements the original intent of this command.


Fields: [ ]=Optional with Default Value
  1. RequirementID
    The user-defined ID of the Requirement


  2. [ Description = ]
    A description of the Requirement


Examples:
  • C SetRequirement Requirement1
    Logs the start of Requirement1 with no additional description


  • C SetRequirement Requirement1 "It Must Compile"
    Logs the start of Requirement1 with a description of Requirement1


[How To Read This Reference]

DDDriverDeprecatedCommands::SetTestcase
RC WR

DEPRECATED. Use StartTestCase instead.

Log/process the beginning of testing associated with a user-defined Testcase.
Currently no processing is done with this. Only a log entry occurs. Use StartTestCase which now implements the original intent of this command.

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.


Fields: [ ]=Optional with Default Value
  1. TestCaseID
    The user-defined ID of the Testcase.


  2. [ Description = ]
    A description of the Testcase


Examples:
  • C SetTestcase TestCase1
    Logs the start of TestCase1 with no additional description


  • C SetTestcase TestCase1 "It Must Compile"
    Logs the start of TestCase1 with a description of TestCase1


[How To Read This Reference]