Command and Control

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.
Capture.0.1600 alive.
Cleanup.0.1628 alive.
Service.0.1852 alive.
Logger.0.1896 alive.
Analysis.0.1944 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).