Skip to Main Content
Return to Navigation


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



Executes a command line program.



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

See Defining Configuration Options.


The number of seconds before the program times out.


The return value.


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


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