Creating a monitoring task query

Define a task to monitor objects in the plan by specifying a query in a query line. The objects for which you can create a monitoring task query are: jobs, critical jobs, job streams, workstations, files, resources, domains, and prompts.

1. In the navigation bar, click System Status and Health > Workload Monitoring > Monitor Workload.
2. From the Engine drop-down list, select the check box related to the engine where the task must run.

   You can specify more than one engine only if the type of object you want to monitor is job or job stream.

3. From the Object Type drop-down list, select the type of object you want to monitor. The available object types correspond to the type of engine and number of engines you selected.

   For a distributed engine, you can create a monitoring task query for: Job, Critical Job, Job Stream, Workstation, File, Resource,Domain, and Prompt.

   For a z/OS engine, you can create a monitoring task query only for: Job, Critical Job, Job Stream, Workstation, and Resource.

4. From the List Plans drop-down list, you can select the current plan or an archived plan related to the selected engine. Plans are only stored for the distributed engines, you cannot select the field for critical jobs.
5. In the Query text box, type the query that specifies the filter criteria to apply to the object type you selected. If you are familiar with the conman syntax, the query syntax is quite similar; for example, the syntax for filtering jobs is similar to conman showjobs. If you are not familiar with conman, click Edit to create your query by selecting the options from the filter criteria that are displayed (for details, see step 7).
   In general, the following rules apply to the query syntax:

   • The plus symbol (+) is used to separate filter parameters.
   • The hash key symbol (#) is used to separate the workstation name from the job stream name, for a distributed engine.
   • The exclamation mark (!) is used to separate the workstation from the job stream name, for a z/OS engine.
   • The ampersand symbol (@) replaces one or more alphanumeric characters (wild card).
   • The period (.) separates the workstation name, job stream name from the job name.
   For example, to display the status of all jobs in the acctg job stream on workstation site3 for a distributed engine, type the following string in the Query text box:

   site3#acctg.@

   or:

   site3#acctg

   For more example about queries and syntax, see Example.
6. Click Run to run the task immediately. The results are displayed in table format in a new page. From this page you can continue to edit the query in the query line or click Edit to make changes to the user interface selections. The list of results are updated with the changes you make.
7. Alternatively, click Edit to select the filter criteria from a list of options rather than specifying them in the Query text box. The Query text field is automatically populated with the appropriate syntax.
   For details about the filter criteria that apply to the object type you selected, refer to the following sections:

   • Creating a task to Monitor Jobs
   • Creating a task to Monitor Jobs on Multiple Engines
   • Creating a task to Monitor Job Streams
   • Creating a task to Monitor Job Streams on Multiple Engines
   • Creating a task to Monitor Workstations
   • Creating a task to Monitor Files
   • Creating a task to Monitor Resources
   • Creating a task to Monitor Domains
   • Creating a task to Monitor Prompts
8. Type a name for the monitoring task in the Task Name text box.
9. Click Save to save the task. Each task you create and save is included under the All Configured Tasks menu, as well as in the Query drop-down list. You can reuse or modify each saved task, as required.
10. Select a task from the Query drop-down list and click Edit. Duplicate to create a new task exactly like the one you selected. This is useful if you want to work with a task that is not your own, but is shared with you.
11. Select one or more tasks from the Query drop-down list and click Edit. Click Delete to delete them. You cannot delete tasks that are not your own.
12. Click Run to run the task. A list of results is displayed in table format in a new page. Alternatively you can view the output of the selected task in a report format in a separate HTML file. Click View as Report to view the output.