RunCommand macro at system level
The RunCommand macro used to run a command on a Data source. This is an extended version
of the RunSQL macro. This macro supports commands at the system level that are not specific to
the context of a scenario. The command updates static or configuration data in SCP or external
data.
This table lists the parameters used to execute the RunCommand macro at system level:
| Parameter Name | Description |
|---|---|
| Data Source | The data source for which the command is executed. Select Database. |
| Command Text | The command to execute in the specified data source. |
| Timeout | The time (in seconds) to wait for the blocking process to complete, if
currently processing. Note: If this value is not specified, the wait period is
indefinite.
|
For executing the macro, the value for the Command
field must be specified in this format:
RunCommand (Data Source, Command Text,[Time out])Note: The optional parameters are specified in [
].
This table lists the examples of the RunCommand macro:
| Requirement | Syntax |
|---|---|
| Run the "Reset" command on the Data Source "Test". | RunCommand("Test", "Reset") |
The command is executed against/for the specified Data source on successful validation and execution of the macro.
Validation is performed when you execute the RunCommand macro. If validation fails, the macro is aborted, and the related error message is displayed.
This table lists the error messages displayed for various validation failures:
| Validation Condition | Error Message |
|---|---|
| RunCommand supports data source type 'Database' only. | The RunCommand macro requires a data source of type Database. |
| Check the data source is valid. | data source {0} cannot be found. |