Skip to Main Content
Return to Navigation

Command

Use the Command step to run a command line program. The command step has one associated action Exec.

Exec

Description

Executes a command line program.

Parameters

name=&commandname

The command name as defined on the Define Configuration Options page.

See Defining Configuration Options.

timeout=&seconds

The number of seconds before the program times out.

ret=&variable

The return value.

Example

This is an example of a command line program that requires multiple parameters.

Image: Example of Command.Exec with Parameters Defined in the Value Column

This example illustrates a command line program that requires multiple parameters.

Example of Command.Exec with Parameters defined in Value Column

Example

If the command line program is used in multiple tests, you should create a library test for the command. This example shows a test library created for the FILEKILL command. The command has one parameter FILENAME.

Note: FILEKILL and FILECHECK commands are examples of possible utilities to call from PTF, they are not delivered with PTF. Customers are responsible to create their own command line programs.

Image: Example Command in a Library Test

This example illustrates the FILEKILL command.exec step, it has one parameter FILENAME. This command will look for a specific file and delete it if it exists. If the file cannot be deleted it returns a 1.

Command Defined in Library Test

This is an example of the calling test.

Image: Example of the Calling Test

This example illustrates how the command can be called from a test. This test will delete the file before running a process to create a new file.

Calling Test