Job Filter Dialog

The Job Filter dialog displays by right-clicking in the Job Activity pane and selecting the Filter option from the context menu.

The Job Filter dialog allows you to perform these tasks:

View only the jobs that have the statuses that you want to see.

View jobs using wildcards to specify the job name.

View jobs that are running or ran on a specific agent.

View jobs that are owned by a specific user.

View jobs that are run as a specific user.

View jobs that belong to a specific job class.

View jobs that will run in a certain queue.

View jobs that run a certain comman

View only jobs, only job groups, or both.

View jobs that have specific tags.

Note: Filters only apply to jobs within groups, not to groups themselves. Groups are only displayed if at least one child within the group passes the filter criteria. If, according to the criteria, the group would be empty, the group is not displayed. If the Show Groups option is not selected, groups are ignored completely, and filters apply to the individual jobs which are now displayed outside of their group.

Status Filter

Use this filter to view only jobs with the statuses you are interested in. The default is all statuses (all selected).

The Job Filter dialog contains these status viewing options:

Aborted – Shows all jobs that were actively running and were aborted by the operator.

Active – Shows all jobs that are currently running in the production schedule. Jobs that run longer than a day are shown on the day it started.
Agent Disabled – Shows all jobs that could not launch because their assigned agent is inactive.

Agent Unavailable – Shows all jobs that cannot run because their assigned agent is either not online or not presently connected.

Cancelled – Shows all jobs that were cancelled by the operator.

Completed Abnormally – Displays all jobs that completed with an exit code outside the designated normal range of values.

Completed Normally – Displays all jobs that completed with an exit code within the designated normal range of values. This is configured on the Run tab of the job definition. The default exit code is 0 if a range of values is not specified.
Deferred – Shows all jobs that were deferred because another occurrence of the job was running when the job was launched. These jobs have their concurrency option set to Deferred in their job definition.

Error Occurred – Shows all jobs where an error occurred that prevented the job from running. Error messages can be examined in the Job Details dialog.
Externally Defined – Shows all jobs that have a completion status defined by an external program.

Held – Shows all jobs that were put on hold by an operator.

Launched – Shows all jobs that are being launched by the Queue Manager.

Orphaned – Shows all jobs where the connection between the agent and Master failed while the job was running, and thus the job’s status is unknown.
Scheduled – Shows all jobs that have been scheduled to run on future days, and jobs running today where the status has not yet been determined.
Skipped – Shows all jobs that were skipped because another occurrence of the job was running when the job was launched. These jobs have the Skip option set in the If job is currently running field on the Options tab of their job definition.
Stopped – Shows all active jobs that were stopped by an operator. Jobs can be resumed by using the Release job control menu item.
Timed Out – Shows all jobs that could not launch during their date and time window and will never run because Timeout is selected in the If not ready by end of day field on the Schedule tab of the Job Definition dialog.
Timed Out for Day – Shows all jobs that missed or could not launch during their time window and cannot run for the rest of the day. These jobs will be carried forward to the next day because the Try again tomorrow option is selected in the Schedule tab of the Job Definition dialog.
Waiting on Children – Shows all parent job groups that are waiting for their children to reach the necessary status.

Active Waiting on Children – Shows all parent job groups with resource requirements that are waiting for their children to reach the necessary status.
Waiting on Dependencies – Shows all jobs that are waiting on time, variable, file or job dependencies. You can view all the job dependency information from the Job Details dialog by double-clicking the job in the Jobs pane.

Waiting On Group – Shows all jobs that are waiting on their job group’s dependencies to be satisfied. You can view the job group dependencies information from the Job Details dialog by double-clicking the group in question in the Jobs pane.
Waiting on Operator – Shows all jobs that have passed their dependency tests, and are waiting for an operator to release it. The job can be released using the Release/Resume job control command.
Waiting on Resource – Shows all jobs or job groups that are waiting for an agent to free resources so that the job can run.

Note: When the Status column is sorted, the sort order is defined by the sort order listed in the System Configuration dialog. For more information about the System Configuration dialog, see System Configuration.

Hours

Use this section to filter for jobs that run only during certain hours. Enable the checkbox for each hour you wish to filter for.

Other Filters

Id – Shows all the job occurrences matching the specified IDs. Only numeric values a special characters such as *, [ ], ?,and % are allowed.
Job – Shows all the job occurrences matching the wildcard string specified. You can use these wildcard characters.
* (Asterisk) – The asterisk character masks any number of characters on and to the right of the location it is placed. For example, A* will match (allow in) AB, ABB, and ABBB.
? (Question Mark) – The question mark masks one character in the location it is placed. For example, A?A will match ABA and ACA, but not ABB or ABBA.
[x, , z] – The brackets with commas let you specify a set of characters to filter in to that location in the string. For example, A[X,]B accepts AXB and AYB but not AAB.
[a-z] – You can also specify ranges within brackets. For example, A[X-Z]B filters in AXB, AYB, and AZB but not AWB.
Group – In this text field, type the name of a group filter. The groups configured with this filter are displayed as well as their children.
Agent List – Shows all job occurrences associated with the agent list selected from this dropdown list. By default, all available agent lists are displayed in this field. If no agent list is selected, all available agent lists are considered.
Include indirect usage of Agent List – Shows all job occurrences associated with the agent list selected from the Agent List dropdown list and all job occurrences associated with the parent agent lists of the agent list selected from the Agent List dropdown list.
Agent – Shows all job occurrences that run on the agent selected from this dropdown list. By default, all available agents are displayed in this field. If no agent is selected, all available agents are considered.
Include indirect usage of Agent – Shows all job occurrences that run on the agent selected from the Agent dropdown list and all job occurrences associated with the agent lists that directly or indirectly contain the agent selected from the Agent dropdown list.
Owner – Shows all job occurrences that belong to the selected user or workgroup.
Runtime User – Shows jobs assigned to the selected runtime user.
Job Class – Shows jobs belonging to the selected job class.
Queue – Shows all job occurrences that run in the selected queue.
Command – Shows all jobs that execute the selected command.
Tags – Shows all job occurrences that have specific tags selected from the multi-select list. Only active tags are displayed in the list.
Calendar – Displays all jobs that use the selected calendar.
Show Jobs – Displays all jobs meeting the defined filtering criteria. No jobs display if this is not selected, though job groups display if the Show Groups option is selected.
Show Groups – Displays a job group if it meets the defined criteria. No job groups are displayed if this option is not selected.
Show Carryover – Displays any jobs that carried over from previous production dates.
Show Critical Only – Displays only the critical jobs and the jobs on the critical path of any other downstream jobs in the Job Activity pane.
Case Sensitive – This checkbox is supported by the Oracle and MS SQL databases.
Show Scheduled Only – Displays jobs that were compiled as part of the original production schedule. The Show Ad Hoc Only option cannot be selected if this option is selected.
Show Ad Hoc Only – Displays jobs that were not part of the original production schedule but were manually inserted into the schedule by an operator.The Show Scheduled Only option cannot be selected if this option is selected.

Note: Jobs that did not finish on their production dates carry over only if the Carry Over Unfinished Schedule option was selected on the Master tab of the System Configuration dialog.
Server Side Filter – Choose this option if the job filter criteria does not change very often. This option improves performance by reducing network traffic. With this option selected, only jobs meeting the defined criteria are downloaded to the TA client when the Job Activity pane is selected. Once the filter criteria is changed, jobs are filtered again according to the new criteria and downloaded again.

If the option is not selected, all jobs are downloaded first and then filtered by the TA client to meet the defined criteria. After the initial download it is quicker to re-filter the jobs from the TA client since they do not have to be downloaded again.
Defaults – Resets the job filter criteria to the default options. The defaults include all statuses, all hours, and the Show Jobs, Show Groups and Show Carryover options. The criteria in the Other Filters section is cleared.