Creating a task to Monitor Job Streams

About this task

Create a Monitor Job Streams task to retrieve all job streams satisfying a number of filter criteria. For example, you might want to retrieve all job streams with a specific status, a specific priority, and by actual start or end time.

From the list of job streams displayed that satisfy your filter criteria, you can also retrieve a list of predecessors that are causing a delay of a selected job stream. Jobs in the predecessors list are in such states such as error, late, fence (for distributed systems only), suppressed (for distributed systems only) or long duration. If these jobs do not complete successfully on time, they prevent the selected job stream from completing on time. In this view, you can quickly see on which jobs you need to take appropriate recovery actions (for example, by releasing dependencies or answering prompts).

To create a Monitor Job Streams 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

  1. In the navigation bar, click System Status and Health > Workload Monitoring > Monitor Workload and follow the steps described in Creating a monitoring task query.

    If you are familiar with conman, in the Query text box specify a query based on the conman showschedules syntax. Alternatively, click Edit to select the filter criteria from the list of options that is displayed.

  2. 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 job streams based on their scheduled run time, status, or the workstation where they run. For example, you can look for all the job streams with a given priority level that remained in waiting state on a set of workstations, or you can look for all the job streams with a specific group, a given priority level, and whose most critical job has a specified duration.
  3. In the Time Data Filter panel, specify a time range to limit your search to jobs or job streams that ran within a specific time period.
    Note: If no date and time is specified, then the jobs and job streams are not filtered based on their processing time.
  4. In the Dependencies Filter section, you can filter your results based on the dependencies they have. Only job streams that have the dependencies you specify in this panel are included in the query results. Dependencies can be jobs, job streams, resources, files, or prompts.
  5. In the Columns Definition section, 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 workstations where the ran, when they ran, and when they were scheduled to run. You can then drill down into this information displayed in the table and navigate it. In the Columns Definition section, not only can you select the columns for this task results, but you can also specify the columns for secondary queries on jobs and workstations (for distributed job streams only). Starting from the Monitor Job Streams task table of result, you can start further queries on jobs and workstations associated to one of the job streams in the table; the information to be retrieved with these secondary queries is specified in this panel.

Results

After specifying all the required criteria, you can save your task or immediately run it to create a list of job streams that satisfies your filtering settings. For details, see Creating a monitoring task query.

Example