Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel
Table of Contents

Overview

For some Agent-based task instances where output has been generated (see Task Instance Output, below), you can choose to have the output retrieved automatically or manually.

Anchor
Task Instance Output
Task Instance Output
Task Instance Output

The following table identifies the types of Agent-based tasks whose task instances generate output, and the type of output they generate:

Task Type

Standard Output

Standard Error

z/OS Job Log

Linux/UNIX

(tick)

(tick)


Windows

(tick)

(tick)


z/OS



(tick)

Universal Command

(tick)

(tick)


SAP

(tick)

(tick)


PeopleSoft

(tick)

(tick)


File Transfer

(tick)

(tick)


Remote File Monitor

(tick)

(tick)


Universal

(tick)

(tick)



Note
titleNote

For File Transfer tasks, you cannot choose to select automatic or manual output retrieval. The Controller always retrieves its output automatically.

Similarly, although Web Service tasks are not Agent-based tasks, Web Service task instances always produce output, which the Controller always retrieves automatically.

Anchor
Retrieving Output Automatically
Retrieving Output Automatically
Retrieving Output Automatically

You can specify that Universal Controller automatically retrieves output from an Agent-based task instance after it has completed running.

Step 1

Specify Automatic Output Retrieval for a task (in its Automatic Output Retrieval field).

Step 2

Run the task; the Controller automatically retrieves that type of output for the task instance.

Step 3

From the Automation Center navigation pane, select Task Instances > Activity or Task Instances > Task Instances to display the Activity Monitor or Task Instances list.

Step 4

Open the task instance. The Output tab displays a green icon, indicating that output has been retrieved automatically.
 

Step 5

Click the Output tab to view the output that you specified to be automatically retrieved.
 

 

Step 6

You can click the Retrieve Output... button to display the Retrieve Output dialog, which lets you select different, or additional, output to retrieve.
 

 
If the selected task is a z/OS task, the Retrieve Output dialog contains a single Output Type selection:
 

Step 7

Using the field descriptions below as a guide, make your selection. Positioning can be accomplished by using Start Line or Scan Text fields to see the Number of Lines both before and after the first match of text.
 

Note
titleNote

If you want to retrieve data starting at the end of a file, enter -1 in the Start Line field and the number of lines to retrieve in the Number of Lines field.


Anchor
Retrieving Output Manually
Retrieving Output Manually
Retrieving Output Manually

You can choose to retrieve output manually from a task instance while it is running or after it has completed running.

Step 1

From the Automation Center navigation pane, select Task Instances > Activity or Task Instances > Task Instances to display the Activity Monitor or Task Instances list.

Step 2

Open the task instance from which you want to retrieve output. The Output tab displays a gray icon, indicating that output has not been retrieved automatically.
 

Step 3

Click the Retrieve Output button to display the Retrieve Output dialog.
 

 
If the selected task is a z/OS task, the Retrieve Output dialog contains a single Output Type selection:
 

Step 4

Using the field descriptions below as a guide, make your selection. Positioning can be accomplished by using Start Line or Scan Text fields to see the Number of Lines both before and after the first match of text.
 

Note
titleNote

If you want to retrieve data starting at the end of a file, enter -1 in the Start Line field and the number of lines to retrieve in the Number of Lines field.


Step 5

Click the Submit button. The Controller retrieves the output you specified and displays a Retrieve Output list containing the requested type of output.
 
(It also writes the output to the Output tab of the task instance.)
 

Step 6

If you now click the Output tab with the gray icon on the task instance Details, the icon becomes green, and the retrieved output displays.
 

Step 7

You can again click the Retrieve Output... button to display the Retrieve Output dialog, which lets you select different, or additional, output to retrieve.

Anchor
Retrieve Output Dialog Field Descriptions
Retrieve Output Dialog Field Descriptions
Retrieve Output Field Descriptions

Field Name

Description

Standard Output and Standard Error

Retrieve both standard output and standard error information returned by the program.

Standard Output

Retrieve standard output only.

Standard Error

Retrieve standard error output only.

z/OS Job Log

z/OS tasks only; Retrieve information from the z/OS Job Log.

Anchor
Start Line
Start Line
Start Line

Retrieve data beginning at the line indicated.

  • If a Start Line value is not specified in the task instance Details, the default is 1.
  • If the Start Line value is -1, data will be retrieved starting at the end of the file.

Anchor
Number of lines
Number of lines
Number of Lines

Limit the retrieved data to the Number of Lines value in the task instance Details. If a Number of Lines value is not specified, default is the value of the Retrieve Output Default Number Of Lines Universal Controller system property.

Anchor
Scan Text
Scan Text
Scan Text:

Regex pattern that the Controller will search for a match for in STDOUT/STDERR (or z/OS Job Log). The Controller will include the Number of Lines above and below the first line matched.
 
if the Regex pattern is not found, the following message is returned: OPSWISE WARNING - Scan text string not found.