5
Runtime Management

This chapter describes how to manage Oracle Applications InterConnect components using the Oracle Enterprise Manager Console.

This chapter discusses the following topics:

• Introduction to Runtime Management

• Features

Introduction to Runtime Management

The Runtime Management Console is an Oracle Enterprise Manager based tool that allows you to manage your integration components at runtime. The Oracle Applications InterConnect components that can be managed through the Console are as follows:

• Adapters

• Repository Server

To be able to manage your integration components, you must

• Install the Enterprise Manager Server on your hub machine (instructions in the install guide). When the management server is started it detects the repository in the hub and all associated adapters.

• Install the Enterprise Manager Console on the machine you wish to manage your integration components from (instructions in the install guide).

For more information on installation, see the Oracle Applications InterConnect Installation Guide.

Starting the Enterprise Manager Console

To start the Enterprise Manager console:

1. Start Enterprise Manager Console. The following dialog displays:

   

2. Enter the management server you want to connect to, the username, and the password. Click OK. The console comes up:

   

   If you expand the Oracle Application InterConnect subtree, you see a list of adapters and the repository associated with the particular Oracle Applications InterConnect hub.

   

To utilize any of the features, right click on the adapter or repository that you would like to manage.

Features

The following are runtime features for adapters and the repository.

Common Features for Adapters and the Repository

The following features are provided for both adapters and repository.

• Get State--Shows the component's state. Red indicates the component is stopped. Green indicates the component is running. Yellow indicates the component state is unknown.

• Start--Start the component.

• Stop--Stop the component.

• Alert On Shutdown--Allows you to send a page or email if that particular component goes down. Refer to the Oracle Enterprise Manager Guide for setting up the alert.

• Get Ini File--Allows you to browse and modify the .ini file for that particular component. If you make changes, the tool prompts you to restart the component. You must restart the component for the changes to take effect.

• Get Log File--Allows you to browse the log files for a particular component. Repositories have one log file each. Adapters have multiple log files. This feature allows you to select the log file you want to look at.

• Get Alive Time--Gets the duration that the component has been up for since it was last started.

• Remove--Removes the component from the list of manageable components for this session of the Oracle Enterprise Manager Console.

Repository Specific Features

• Get Repo Sessions--Gets a list of all components connected to the repository -- adapters and iStudio.

Adapter Specific Features

• Get Throughput--Monitor the adapter throughput in terms of messages/second. The steps to get throughput information are as follows:
  1. Right-click on the adapter that you would like to get throughput information for. Select Get Throughput on the context menu.

  2. On the dialog that pops us, click Get Throughput. Throughput information is displayed for inbound and outbound message separately. At startup time the adapter starts recording throughput information by default. If you want to record throughput information in a particular interval, click on disable timer and then click on enable timer. This restarts the recording process. Now you can get fresh throughput information by clicking Get Throughput.

• Track Messages--This allows you to track particular messages at runtime. During design time, in iStudio, you have the ability to specify fields in the application view for publish event or invoke procedure, that you would like to track the message with. For example, a customer related message could be tracked by an application view field -- social security number. To utilize this functionality in the runtime management console:
  1. Right-click on any adapter that is attached to the application that is publishing the event or invoking the procedure that you want to track. On the context menu, select Track Messages.

  2. A list of trackable events and procedures is displayed. Select the event or procedure you want to track.

  3. A dialog pops us asking you for the value(s) of the tracking field(s) that you selected for that particular event or procedure in iStudio. So, in our customer related message example, the dialog would ask for the social security number.

• Get Errors--Get Errors: Shows you all the errors associated with the adapter. Certain errors have a message payload associated with them. These errors are marked with a yes in the Editable column. To modify and resubmit a message:
  1. Double-click the description field for such an error. A window pops up with an XML message in the application or common view depending upon the processing stage at which the error occurred.

  2. You can edit the message if you need to. Or you can skip this step.

  3. Click Resubmit. The message now re-enters the integration system for reprocessing.