Audit Trail

The Audit Trail feature from the JAMS Shortcuts menu lets you review all changes that were made within your system. This is useful for reporting purposes. You can see changes for all JAMS objects, including the JAMS Jobs, Execution Methods, Credentials, and Agents. You can view the details of the changes and revert changes to a previous version for Jobs and Folders. You can also restore deleted Jobs and Folders by using the Revert option.

The Audit Trail records are kept indefinitely by default, but they can be pruned automatically by enabling the JAMSPurgeJobAT Job. You can use the following Jobs from the JAMS Folder in the Definitions Shortcut to control the amount of Audit Trail data:

  • JAMSPurgeJobAT – This Job removes the records for changes to JAMS objects and previous versions of Job objects.
  • JAMSPurgeJobAuditTrail – This Job removes records for Trigger resets.

Accessing the Audit Trail

You can access the Audit Trail from a Job, Folder, or the Shortcuts menu. An Audit Trail is also available from the Monitor and History options in the Shortcuts menu. The Audit Trail tab in the History and Monitor views shows the actions and changes for an entry, such as a release, cancel, or hold option. See Using the Monitor for more information.

To access the Audit Trail from a Job or Folder:

  1. Click Definitions from the JAMS Shortcuts menu.
  2. Right-click a Job or Folder and select Properties.
  3. Click the Audit Trail button.

To access the Audit Trail from the Shortcuts menu:

  1. Click Audit Trail from the JAMS Shortcuts menu.
  2. Click the Refresh button to view the latest information.

Audit Trail screen

The Audit Trail screen displays the list of all changes logged within the JAMS system. It is updated whenever you refresh the screen or create a new filter to view the changes.

The Audit Trail screen has the following columns:

  • Message – This is a brief summary of the change that was made.
  • Audit Time – This is the time the change occurred.
  • User Name – This is the name of the user who made the change.
  • Object Type – This lists the type of items within JAMS that was changed, such as an Execution Method, Job, or Credential.
  • Object ID - This is the unique ID assigned to the JAMS object.

Querying the Audit Trail

  1. Click the Query button.
  2. On the JAMS Audit Trail Query dialog, enter values for one or more of the following:
    1. In the User Name field, enter a user name that made the changes.
    2. In the Object Type field, select the type of JAMS object that you want to see.
    3. In the Between fields, select a date range for when the change occurred.
  3. Click Ok.

Sorting the Audit Trail Results

You can sort any column in the Audit Trail.

To sort a column, click the column name. The Audit Trail is ordered in ascending or descending order.

Searching the Audit Trail Results

You have two options for searching within the Audit Trail: using the Search bar or a filter. The Audit Trail screen has its own search option that is separate from the Search at the top of the JAMS window.

To search the Audit Trail, do the following:

  1. Click the Refresh button to ensure the latest entries are displayed.
  2. Click the magnifying glass icon above the column headings.
  3. Enter your search term.
  4. Click Find.

To filter the Audit Trail, do the following:

  1. Click the column name.
  2. Click the funnel icon on the column.
  3. Select one or more checkboxes to filter on those values.
  4. Click Close or Clear Filter.

Comparing Versions of a Job or Folder

The Audit Trail lets you compare two versions of a Job or Folder and see the differences.

  1. Right-click an item in the Audit Trail list and select Revisions. A dialog box is displayed.
  2. Hold the Shift key or the Ctrl key and click two versions of the item.
  3. Click Compare. A screen displays the versions side by side. The changes are displayed in red. The Parameters section is also displayed in red.

Reverting to a Specific Revision of a Job or Folder

You can revert a Job or Folder to a previous revision. You can also use the Revert option to restore a deleted Job or Folder.

  1. Right-click an item in the Audit Trail list and select Revisions. A dialog box is displayed.
  2. Click the version you want to revert back to.
  3. Click Revert To.
  4. Click Yes when prompted.
  5. Close the Revision History dialog box.