Skip to main content

History

The History screen provides detailed information for all Job executions that have completed in the Monitor. For each Job, you can review its run history, duration, the Agent it ran on, and whether it completed successfully or resulted in a failure.

You can also:

  • Submit a Job to run in the Monitor.
  • View the Properties of an Entry.
  • View the execution details and log file of an Entry to get more information for troubleshooting.
  • Query and filter the listed Entries based on your preferences.

Maintaining the History​

By default, a JAMS runs the JAMSPurgeHistory Job in the JAMS folder to clean up and remove history entries older than 30 days from the JAMS database. The Job runs on Sundays at 2:00 AM. It has three Parameters that you can modify:

  • MINROWS - The minimum number of rows per Job to keep. This ensures you always have the most recent record of a Job. The default is 1.
  • MAXROWS - The maximum number of rows per Job to keep. The default is 30.
  • DAYS - The maximum number of days of history to keep. The default is 30.

You may want to adjust the values if a Job is running multiple times a day or if you have a high-volume environment. For example, if you have a Job running 3 times a day and you want 30 days of data, you need to update the MAXROWS to 90. (Number of times the Jobs runs per day multiplied by the required days.)

Accessing the History screen​

Click History from the Shortcuts menu. The JAMS History Query dialog is displayed with the Filters tab open. You can configure options on both the Filters and Tags tabs to control what Entries are displayed in the History.

Configuring the Filters Tab​

When you open the History screen or click the Query button, the JAMS History Query dialog is displayed with the Filters tab open. Select the appropriate options to filter the Entries as needed. The screen below shows the default options.

  • Folder – In the Folder field, enter the JAMS folder path to search. (The default \ searches from the root.)

  • Job – In the Job field, enter a Job name or a wildcard pattern (* matches all Jobs).

  • Clear Current List – Select Clear Current List to replace any currently displayed results with the new query. Leave it unchecked to append new results to the existing list.

  • Search Recursively – Select Search Recursively to include all subfolders of the value in Folder field.

  • Show Related – Select Show Related to change how related Jobs are displayed in the results. When unchecked, the specified filter criteria are applied to Jobs at all levels, so only Jobs that match the filter appear, including their children. When Show Related is enabled, the filter criteria are applied only to top-level Jobs. All children of a matching top-level Job are then shown, even if they do not meet the filter criteria themselves. Children can be expanded to any depth using the dropdown arrow. This applies to Workflow, Sequence, Notification, Precheck, and Recovery Jobs.

    • Example: If you filter by Folder X, and Parent Job A (in Folder X) has Child Job B (in Folder X) and Child Job C (in Folder Y), and an unrelated Job D (in Folder Y):

      • With Show Related unchecked: Only Job A and Job B appear, since both are in Folder X.
      • With Show Related checked: Job A, Job B, and Job C all appear, since Job A matches the filter and all its children are included regardless of folder. Standalone Jobs that have no relationship to a matching top-level Job (such as Job D) are not shown.

  • Additional Search Criteria – Use the two Additional Search Criteria rows to filter on specific Job properties. Each row has three fields: a property selector (default None), a comparison operator (default Like), and a value (default *). Leave the rows at their defaults if you don't need extra criteria.

  • Time Range – In the Time Range panel, select one or more of Scheduled At, Scheduled For, Started, and Completed to choose which timestamps the range applies to.

    • Between — pick a start date/time and end date/time.
    • Or within the past — enter a relative duration (for example, the last several hours).

  • Final Severity – In the Final Severity panel, select any combination of Successful, Informational, Warning, Error, and Fatal. All five are selected by default.

Configuring the Tags Tab​

The Tags tab lets you filter Entries by Job attributes, such as if it is a FileWatch or MailWatch Job.

History screen​

The History screen lets you the details of each completed Entry, including the following information:

  • Status –The final state of the Job. See Monitor for a table listing the various status icons.
  • Job Name – The name of the Job.
  • Entry – The number assigned to the Job in the Monitor.
  • Final Severity – The severity level of the Job.
  • Final Status Code – The internal code for the final status.
  • Scheduled Time – The time the Job is scheduled to start to run in UTC.
  • Hold Time – The time when the Job will be released to run.
  • Start Time – The time the Job started to run.
  • Completion Time – The time the Job finished running.
  • Elapsed Time – The time the Job ran.
  • Tags – The identifiers for the Job to use with the Filter tab.
  • Execute As Name – The Credential that is used to run the Job.
  • Executing Agent Name – The name of the Agent where the Job.

Viewing the Properties of an Entry​

You can view the Properties on the Job Definition for a selected Entry. This includes the Job Source, Schedule Items, Properties, Parameters, and any permissions.

  1. From the History screen, click an Entry from the list.
  2. Click Properties.
  3. View the contents of the tabs. You can make edits and save them directly to the Job Definition.
  4. Click Save to save any edits.

Viewing the Execution Details and Log File of an Entry​

You can view the log file for an Entry in the History. This is helpful if you want to see any details from the last run of the Job. You can also view the Properties, Parameters, and Schedule Items that were used when the Job ran. The values are read-only.

  1. From the History screen, click an Entry from the list.
  2. Click Show Detail.
  3. On the General tab, view the Submitted By name, Agent, Final Status, and Completion Severity.
  4. Click the Log File tab to view the execution log for the Entry.
  5. Click the Properties tab to view the properties used to run the Job.
  6. Click the Parameters tab to view the Parameters that were used.
  7. Click the Schedule tab to view the Schedule items used to submit/run the Job.

Manually Submitting a Job to Run​

You can manually submit a Job to run from the History screen. You have two options: Submit and Resubmit.

  1. From the History screen, click an Entry from the list.
  2. Do one of the following:
  • Click Submit to select new parameter values.
  • Click Resubmit to use the same Parameter values as the select Entry.
  1. If prompted, enter any Parameter values.
  2. Click Submit Run Request.