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

  1. In the navigation toolbar, click Monitoring & Reporting > Orchestration Monitor.
  2. From the Engine drop-down list, select the check box related to the engine where the task must run.
  3. 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.

  4. From the List Plans drop-down list, you can select the current plan or an archived plan related to the selected engine.
  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.
    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.
    • The slash (/) separates the folders.
    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#/foo/acctg.@
    or: 
    site3#/foo/acctg
    For more example about queries and syntax, see Example.
  6. 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.
  7. Click Save
  8. Type a name for the monitoring query in the Insert query name text box.
  9. Optionally, check the Share with box and select the users you want to share the query with.
  10. 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