Monitor
The Monitor is the primary operational view in JAMS. Administrators and operators use it to watch Jobs as they execute, intervene when something goes wrong, and manage entries that are waiting to run. It is the central tool for day-to-day scheduling operations.
When a Job is submitted to run, JAMS creates an Entry for it in the Monitor. An Entry is a single instance of a Job. The Job is the definition of what should run, and the Entry is the record of a specific execution of that Job. One Job can produce many Entries over time. When you take action in the Monitor, such as canceling, holding, or rescheduling, you are acting on the Entry, not the Job Definition itself.
You can view Entries that are currently executing, waiting to execute, as well as Entries that have completed recently. By default, Entries will remain in the Monitor view for 10 minutes after completion. This keeps the Monitor focused on current and recent activity. You can configure this value in the Configuration menu or at Folder/Job level via the Retain property. To see older Entries, use the History.
Accessing the Monitor
To access the Monitor, click Monitor from the main menu.
Monitor screen
The Monitor displays all Jobs that have been submitted to run. The Jobs may be running, or they may be waiting on a dependency or time. The following information is displayed:
- Entry ID - The number assigned to the Job in the Monitor.
- Status - The current state of the Job. See Monitor Icons for more information.
- Name - The name of the Job.
- Scheduled Time UTC - The time the Job is scheduled to start to run in UTC.
- Hold Time UTC - The time when the Job will be released to run in UTC.
- Start Time UTC - The time the Job started to run in UTC.
- Completion Time UTC - The time the Job finished running in UTC.
- Execute As Name - The Credential that is used to run the Job.
- Executing Agent Name - The name of the Agent where the Job is running.
Monitor Icons
Every Job contained in the Monitor view includes an icon showing the current state of each entry as listed in the table below.
| Icon | Description |
|---|---|
| The Job completed with an Informational or Successful completion status. | |
| The Job is waiting on a dependency or the Job is held. If it is a Workflow or Sequence Job, the icon indicates user input is required before it can continue. | |
| The Job completed with a Warning completion status. | |
| The Job failed with a Stalled, Error, or Fatal completion status. | |
| The Job is currently running, or it is a File Watch Job that executes indefinitely to poll for files that are used for triggers or dependencies. | |
| The Job completed with an Informational completion status. | |
| The Job is pending or it is waiting for its designated start time. |
Working with Monitor Entries
You can manage Monitor entries directly from the Web Client without switching to the JAMS Desktop Client. Actions are available from two locations:
- The toolbar at the top of the Monitor with buttons that are enabled when a row is selected.
- The per-row Actions menu available on each individual entry row.
The following actions are available:
- Cancel - Cancel the selected Entry. The Cancel option also clears a completed Entry from the Monitor view. See Canceling a Monitor Entry for more information.
- Release - Release an Entry from one or more requirements that are preventing it from running or Release it to run again with the same Parameter values. See Releasing a Monitor Entry for more information.
- Hold - Put a manual hold on an Entry. The Entry will not start until the hold is manually released. See Holding a Monitor Entry for more information.
- Reschedule - Specify a new date and time to submit the selected Entry. See Rescheduling a Monitor Entry for more information.
- Submit - Submit a new Entry from the selected Entry's Job Definition. See Manually Submitting Jobs for more information.
- Properties - View the Job Definition for the selected Entry.
- Show Detail - View the Monitor Detail dialog to view more information on the Entry. See Monitor Detail Tabs for more information.
- Query - Filter by a Job Name to update the type of Entries that are displayed in the Monitor. Additional filter/query options are available. See Filtering the Monitor for more information.
- Refresh - Update the list of entries that are displayed.
Monitor Detail Tabs
| Job Properties | Description |
|---|---|
| Summary | Displays read-only information about the submission, including Submitted By account, current state, Execute As Credential to run the Job, Final Status, and notes. |
| Properties | Displays the Properties of the executing Entry. The values are read-only. |
| Log File | Lists all OS generated logs for the Entry, which are helpful for troubleshooting. |
| Parameters | Displays the Parameter names and values associated with the Job. |
| Job History | Displays historical Job Execution information for the selected Job. |
| Sequence | Displays the task tree for a running Sequence Job, showing the state of each task as it executes. Available only for Entries whose Job uses the Sequence execution method. See Viewing the Sequence Tab for more information. |