User Guide > Objects > Alphabetical Listing > Output-Scan Tab

Output Scan Tab

The Output Scan tab determines the filters that are used to search the report of a task and/or external file plus the reaction to the provided result.

Output Scan tab actions will be processed before the Post Process tab actions.

Note that the actions will always be processed regardless of the task's end status.

For example:

The above task refers to two Filter objects. FILTER.OUTPUT searches for the word "ERROR" in an external file and "FILTER.REPORT" searches for a term that should be found in any case in the report. The report is searched first because the list is processed from bottom to top.

The following table shows the possible effects in various situations:

The report does not include the expected term The external file includes the word "ERROR" Return code Alarm object
  9  
  5 ALARM.CALL
9 ALARM.CALL

Description

The Action area includes a table with filter definitions.

In this table, you can select one or several Filter objects whose conditions should be checked. You also define here whether a certain conditions must apply or not and the return code that the affected task should obtain. Optionally, you can also specify an object that should be executed.

Note that the entries will always be processed from bottom to top.

The first entry that applies is decisive for the task's return code. Successive conditions that apply do not affect the return code. The optional object is executed in each line in which the condition applies.

Note that filter definitions are checked at runtime. For example, a task obtains the status FAULT_POST_PROCESSING if the Filter object you indicate searches a report that does not exist in the task.

Field/Element Description
Action  
Output filter The Filter object that includes the criteria that should be applied when searching reports and/or external files.
True/False

You can select whether the criteria specified in the Filter object must apply.

"true" - yes
"false" - no

Set return code The return code for the task.
Status Text

Any text that is used for the task's remote status when the filter definition applies.

The remote status of task appears in the corresponding column in the Activity Window.

Execute

The object that should be processed in reaction to the result that is supplied by the Filter object (optional).

Pass down to dynamic children

This option is available in SAP jobs and RemoteTaskManager objects. It determines whether Filter objects should also apply to child tasks.

"Yes" - The search takes place in the task and its children.
"No" - The search takes place only in the task.
"Only children" - The search takes place only in the child task.

Override host for FileScan (optional)

By default, this task's agent and Login object are used to access an external file that has been defined in the Filter object. You can change one or both entries.

In file transfers, the destination agent is used by default.

Host The name of an OS or a Java agent
Login The name of a Login object.