Process Manager Tool Bar

The Process Manager tool bar contains buttons used to monitor and control the active processes. These actions are described below. The tool bar resides in the upper right-hand corner of the Process Manager window.

ProcessManagerToolBar.jpg

Refresh Button

The refresh tool bar button RefreshButton.gif refreshes the process list by looking for newly started processes and by removing any processes that are no longer running. The process list is automatically refreshed when returning to the Process Manager tool after using a different tool in the OpenSpirit Desktop.

Stop Process Button

The stop process button StopButton.gif is enabled when one or more active processes are selected. Clicking the stop button displays a confirmation window. Answering Yes to the confirmation stops all selected processes. Answering No to the confirmation leaves the selected processes running.

Display Information Button

The display information button InformationButton.gif is enabled when a single active process is selected. Clicking the information button opens a window that displays information about the selected process. The type of information that is displayed varies according to the process type. Data connector processes display the most information of all the process type. Data connector process information includes the OpenSpirit licenses the process has checked out, the process' inactivity time-out, process memory usage, the amount of time the process has been inactive, the processes log message level, the location and name of its log file, and a list of active connections to the data connector. Process starter processes do not display license information or active connection information.

View or Edit Settings Button

The view or edit settings button SettingsButton.gif is enabled when a single active process is selected. Clicking the settings button opens a window that displays the process settings that can be modified to control some aspects of the process' behavior. The settings that can be controlled are the process inactivity time-out and the process message log level. The settings window also contains a Dump Stack Traces button. Clicking this button causes thread call stacks to be printed to the process' log file. The call stack information can sometimes be useful to OpenSpirit support personnel when investigating a problem.

Process Time Out

Process starter and data connector processes will shut themselves down after a period of inactivity. Process starter inactivity is measured based on the amount of time that has elapsed since it was last requested to start a process. Data connector inactivity is measured based on the amount of time that has elapsed since an application used the data connector to connect to its data source. The process inactivity timer does not start until all applications have disconnected from the data connector process.

Tip: Some applications may remain connected even though they are not making any data read or write requests. There is a separate activity time-out that is used to forcibly close unused but open application connections. This time out is referred to as a connection time-out. The default connection time out is 8 hours. The default time out is rather large to prevent the OpenSpirit framework from forcibly closing an application connection and possibly causing loss of work when the application user may have merely gone to lunch or to a long meeting. Applications are free to override the 8-hour default when making their connections to a data source.

The default process starter time-out and the default data connector time-out are determined by the OpenSpirit master installation's advanced settings. Speak to your local OpenSpirit administrator if you feel the default time is too short or too long.

Log Levels

The log level determines the amount of information that is written to the process' log message file. The WARN level is the default for most process types. The meaning of each log level is described in the following table.

Log Level Description

ERROR

Produces the least amount of log file output. This level should only be used if you have no interest in anything but failures.

WARN

Produces less output than INFO. Consider using this level if you are trying to keep the log file size down and are not interested in details of successful operations. Only failure information is reported. Messages about data that could not be copied or scanned are produced, but messages about successful a successful copy or scan are not produced.

INFO

The default level. This is the recommended log level. It produces a reasonably detailed amount of information about the job execution. Messages about the number of each data type copied or scanned is produced using this log level.

DEBUG

Produces a large amount of output. You typically should not use this level unless instructed by OpenSpirit support. Large numbers of program execution messages needed to diagnose problems are produced when this log level is used.

ALL

Produces a tremendous amount of output. This level should never be used unless instructed by OpenSpirit support. Volumes of very detailed program execution messages needed to diagnose difficult problems are produced when using this log level. This log level may produce multi-gigabyte log files.

Help Button

The help tool bar button HelpButton.gif is always enabled. Clicking the help button opens this help guide.