The shortcut menu for each runtime instance in the Administration perspective contains a Control option for managing that instance. Submenu options are available in the Control menu based on the current status of the runtime instance.
To access the menu, right-click on the runtime instance, click and hold Control, and select the desired submenu option.
The options include:
Option |
Description |
Auto Start |
When selected, as indicated by a checkmark to the left of the menu item, causes the runtime instance to be automatically started when the Agent is launched. If not selected, the runtime instance must be started manually. Click the Auto Start menu item to select and deselect this feature. |
Start Instance |
The start command issues a request to initiate the runtime engine. |
Stop Instance |
The stop command issues a shutdown request to the runtime engine. All threads must report a shutdown status before the engine exits. Note: Depending on the activity level, this can take several minutes. |
Pause Instance |
The pause command issues a suspend request to the runtime engine. Note: All resource connections are terminated. No processing occurs until the engine resumes. |
Resume Instance |
The resume command issues a request to continue the runtime engine. It follows a pause request to begin reprocessing events. Note: All resource connections are re-established. |
Abort Instance
|
The abort command instructs all threads to quit after completing the current unit-of-work. The engine then waits ten seconds for the threads to respond. If all threads respond within this time frame, the engine shuts down normally. If the threads do not respond, the application exits abnormally, resulting in a pop-up message (code 9) to the workstation. |
Ping Instance |
The ping command verifies whether the engine threads are in an operational state. All threads are “pinged” except the main thread. The results supply the following type of thread information: Ping Results for <instance>. Timer.0964 alive. |
Statistics |
The statistics command opens the Server Instance Management Monitoring view. This view displays statistics for the selected runtime instance, including the number of active, failed and completed business processes. Users can also manage business processes by viewing error information for failed business processes and choosing to remove or recover them. |
Show Instance Log |
The show instance log command displays the Show Instance Log dialog which allows the NNSYMessageLog.nml and other log files for the selected runtime instance to be viewed. See Viewing Instance Logs for procedures or Message Log Contents for log content information. |
Command and control of runtime instances can also be performed using the Agent Command Line Utility (clagent).