About this task
If you need to combine queries about
jobs running on multiple distributed and z/OS engines, you can use Monitor Jobs on Multiple Engines. For
example, it might be useful to run a query to find all the jobs in
error in your environment by running a single task.
To create
this task, perform the following steps.
Note: For all the details about options and fields displayed
in the panels, see the online help by clicking the question mark located
at the top-right corner of each panel.
Procedure
- In the navigation bar,
click System Status and Health > All Configured Tasks > New.
- In the Create Task panel, select Monitor Jobs on Multiple Engines > Monitor Jobs and
click Next.
- In the Enter Task Information panel, specify
a name for the task you are creating (a default name is provided)
and define the HCL Workload Automation engines
where you want to run the task. The task is run following the specified
engine sequence. In this panel, you can also specify whether to share
the task with others, to allow them to see and run the task, but not
to modify it.
- Click Next to proceed with task creation or click Finish to
complete the creation using the default values and exit without proceeding
to the following steps. If you are editing an existing task, properties
are organized in tabs.
- In the General Filter section, specify some broad filtering
criteria to limit the results retrieved by your query. Here you start
refining the scope of your query by also considering the amount of
information you want to retrieve. Optionally, in some of the results
tables in the Periodic Refresh Options section, you can customize
how often to refresh the information by specifying the refresh interval
in seconds in hh:mm:ss format, with a minimum of 30 seconds and a
maximum of 7200 seconds. For example, 00:01:10 means 70 seconds. If
the value specified is not valid, the last valid value is automatically
used. If the periodic refresh is enabled for a task, when the task
runs, the refresh time control options are shown in the results table.
You can also set or change the periodic refresh interval directly
in the results table when the timer is in stop status. In this case,
the value specified at task creation time is temporarily overwritten. You can search
for jobs based on their identifier, on the job streams they belong
to, or on their status, scheduled time, and priority. For example,
you can look for all the jobs that did not complete successfully and
were scheduled to run within a specific time period.
- In the Columns Definition panel, select the information
you want to display in the table containing the query results. According
to the columns you choose here, the corresponding information is displayed
in the task results table. For example, for all the objects resulting
from your query, you might want to see their statuses, the job streams
they belong to, when they were scheduled to run, and the engines on
which they ran. You can then drill down into this information displayed
in the table and navigate it.
- In the
All Configured Tasks panel, you can see the main details about the
task that you have just created. You can also choose to run the task
immediately. The task is now in the list of your tasks where you can
open and modify it. You can find it in the task lists displayed by
clicking the following options: System Status
and Health > All Configured Tasks or Workload Monitoring > Monitor Jobs.
Results
You have created your task that, when run, creates a list
of jobs satisfying your filtering criteria and showing, for each job
in the list, the information contained in the columns you selected
to view.
To view connection status information and statistical
information about the engines against which the task was run, click
the statistical icon 
on the table toolbar.
A pie chart showing the number
of query results and job status is displayed for each engine on which
the task ran successfully. Click the pie sections to see further details.
If the task did not run successfully on one or more engines, you see
a message containing details about the errors.