Commands Tab

Use the Commands tab to define the steps that must be executed for each report to run successfully. These commands tell PPM precisely which steps must be executed to generate the results for the given report type.

Figure 8-7. Report Type window Commands tab

PPM commands are designed to have a similar look and feel to the UNIX operating system command structure. In fact, the specific parts of a command, the command steps, are often just command-line directives.

A report type can have many commands, and each command can have many command steps. A command may be viewed as a particular function for a report. For example, calling the ksc_run_jsp_report special command to call a report's JSP code, or running command-line SQL*Plus to call a database procedure. To perform these functions, a series of events needs to take place and these events are defined in the command steps.

On the Commands tab, select any existing command to modify its settings, or click New Cmd to create a new command.

View, specify, or modify each field of the Edit Command (shown in Figure 8-9. Edit Command window) or New Command window (shown in Figure 8-8. New Command window), as described in Commands Tab. (Similar to Report Type windows, the only difference in these two windows is whether they include data.)

Figure 8-8. New Command window

Figure 8-9. Edit Command window

Table 8-7. Command window field descriptions

Field Name

Description

Command

Specify a brief name for the command. Type any alphanumeric string.

Condition

Specify the conditions that determine whether the command steps for the command are executed or not.

See the Commands, Tokens, and Validations Guide and Reference for details on the types of conditions that can be used.

Description

Specify a brief description of the command. Type any alphanumeric string.

Timeout(s)

Specify the amount of time (in seconds) the command will be allowed to run before its process is terminated.

This mechanism allows commands that are hanging, or taking much more than the normal amount of time, to be aborted.

Enabled

Option for the command to be enabled for execution.