Monitoring your items in the plan

Define a query to monitor items in the plan. The items for which you can create a monitoring query are: jobs, job streams, and workstations.

About this task

To monitor items in the plan, 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 toolbar, click Monitoring & Reporting > Orchestration Monitor.
From the Engine drop-down list, select the check box related to the engine where the task must run.
From the item drop-down list, select the type of item you want to monitor.

For a distributed engine, you can create a monitoring task query for: Job, Job Stream, Workstation.
From the List Plans drop-down list, you can select the current plan or an archived plan related to the selected engine.
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.
The following rules apply to the query syntax:
- To separate filter parameters, use the plus symbol (+).
- To separate the workstation name from the job stream name, use the hash key symbol (#) for a distributed engine or the exclamation mark (!) for a z/OS engine.
- To replace one or more alphanumeric characters, use the at sign symbol (@).
  Note: For a z/OS engine, when you use special characters you must enclose the whole string between single quotation marks (').
- To separate the workstation name, job stream name from the job name, use the period (.) .
- To separate the folders, use the slash (/) .
For a distributed engine, to display the status of all the jobs in the acctg job stream on workstation site3, type the following string in the Query text box:
```
site3#/foo/acctg.@
```
or:
```
site3#/foo/acctg
```
For a z/OS engine, to display the status of all the jobs in the acctg job stream on workstation site3, type the following string in the Query text box:
```
'site3!/foo/acctg.@'
```
For more example about queries and syntax, see Example.
Press Enter to run the query immediately.
The results are displayed in table format. You can click Advanced Query to specify further information regarding the query.
Click Save.
Type a name for the monitoring query in the Insert query name text box.
Optionally, check the Share with box and select the users you want to share the query with.
Click Save to save the query.

Results

You have created your query that, when selected, creates a list of results satisfying your filtering criteria and showing, for each item in the list, the information contained in the columns you selected to view.

Example

The following examples show the syntax used to create some specific queries:

Job query in a distributed environment

To query for all jobs, in all job streams and on all workstations on a specific distributed engine, with the following characteristics:

Having a dependency on a workstation with a name beginning with FTA_1
Beginning with Job_A in a job stream beginning with JS_A
in FOLDERA folder
Scheduled to run at 10 a.m. on October 31, 2015
Currently in Waiting state with a priority in the range of 1 - 50

specify the following query in the query line:

/@/@#/@/@.@+follows=/@/FTA_1#/FOLDERA/JS_A@(1000 10/31/2015).JOB_A@+state=#Waiting,#Ready+priority=1,50

Job query in a z/OS environment

To query for all jobs in a job stream ending in 001, on all workstations beginning with HR in a z/OS environment, with the following characteristics:

Having an internal status of Interrupted and Error
Having a priority of 1

specify the following query in the query line:

HR@!@001.@+jsfrom=1000 10/10/2015+state=E,I+priority=1