Job Run History Tool Bar

The Job Run History window provides a tool bar containing buttons that can be used to control the job history display and to operate on jobs that are still running and on jobs that are no longer running. Some tool bar buttons are not enabled until one or more job histories are selected.

toolbar.jpg

Refresh Button

The refresh tool bar button refreshbutton.gif refreshes the entire job execution table by re-reading the information from the OpenSpirit master installation's database.

Additional Columns Button

The show additional columns button showadditionalcolumnsbutton.gif toggles on and off the display of additional columns in the table of job executions. The additional columns are displayed on the far right, which may require the table to be scrolled to the right to see them. The additional columns are the Host and PID columns.

Filter Button

The filter button filterbutton.gif opens the job run history query filter window, which provides several options to filter job execution rows from being displayed in the table. This can be useful when you have a very large number of job run histories.

JobFilterDialog.jpg

Check one or more filter options by clicking checkboxes along the left edge of the options window. Jobs matching all selected filter options are shown in the job history table.

The Time Window option provides a few common time intervals to use as filter criteria. The time Windows or intervals are Yesterday, Last Week, Last Month, and Last Year. The time window filter is applied based on the begin date of the jobs. Choose one of these options to filter out all jobs that did not begin running during the selected time window.

The Earliest Begin Date and Latest Begin Date options provide a way to filter jobs based on a specific interval of time. These options are not available if the Time Window option is enabled. Specify only a first begin date to filter out jobs older than the specified date. Specify only a latest begin date to filter out jobs newer than the specified date. Specify both an earliest and latest begin date to filter all jobs except those started during the specified time interval.

The Job Type option is used restrict the job histories to only a specific type of jog (for example, only copy jobs or only scan jobs).

The Status option is used to restrict the job histories to only those histories having a specified job status.

The User option is used to restrict the job histories to only show jobs run by a specified OpenSpirit user. This option is only useful if you are a Copy or Scan job administrator or the OpenSpirit administrator. Regular users can only see their own jobs anyway.

Press the OkButton.gif button at the bottom of the filter window to dismiss the window and apply the filter to the job run history table.

The word Filtered appears next to the Current Job Executions title above the table of job histories to indicate when a filter is in effect. A filter icon filterbutton.gif also appears in the column heading of the columns that are being used to filter.

JobHistoryFilterIndicators.jpg

Cancel Button

The cancel button cancelbutton.gif is enabled when at least one running job is selected. Pressing the cancel button sends a cancel request to the running jobs that have been selected. The job should cleanly end at the next opportunity. The job's status column indicates that a cancel has been requested. The job should end at the next opportunity.

Abort Button

The abort button abortbutton.gif is enabled when a job with a Cancel Requested status is selected. Pressing the abort button initiates an attempt to forcibly kill the running job's process. An abort can only be performed when the job is running on the same machine as the OpenSpirit Desktop and is running under the same account.

Note: The abort button should only be used as a last resort. It can cause the running job to exit in a way that could potentially cause corruption of the job's message log or possibly corrupt the database that it is writing its output to.

Delete Button

The delete button deleteicon.gif is enabled when one or more completed jobs are selected. Pressing the delete button deletes the history record and job output of all selected jobs. The history cannot be recovered after deletion, so make sure that the history is no longer needed before performing a delete.

Tip: Job run histories are maintained in the OpenSpirit master installation's database. Histories can be quite large and can accumulate over time consuming significant storage space in the OpenSpirit master installation. Large numbers of histories can also slow down performance of the Job Run History tool. Consider deleting old histories that are no longer needed for audit trail purposes.

Send to Support Button

The send to support button EmailToSupportIcon.gif is enabled when a single job is selected. Pressing the send to support button causes a zip file to be created that contains files that helpful when entering a support issue about problems running the job. A window appears that shows where the zip file was created. The zip file is not automatically sent to TIBCO OpenSpirit Support. The user is responsible for attaching the zip file to a support request entered using the TIBCO online support portal.

Help Button

Pressing the help button helpicon.gif opens this help document.