This section provides an overview of the Console, and describes the Console's functions. This section covers the following topics:
Setting authorities for the Console
Managing the server using the Console
Managing connector agents using the Console
Managing ODAs using the Console
Starting, stopping, and refreshing connector agents and ODAs using the Console
Refreshing and rebuilding components using the Console
Viewing and using Console Logs
The Console tool for WebSphere Business Integration Server Express is used to administer remote i5/OS components. The Console runs on a Windows operating system and connects remotely to an i5/OS system. The Console tool is used only for WebSphere Business Integration Server Express version 4.4 on an i5/OS system. The tool is installed with administrative tools via the i5/OS Launchpad.
The Console provides a Graphical User Interface for the functionality of the i5/OS administration scripts included with the product. The Console tool's design makes it easier to perform the administrative functions of Server Express.
To start the Console:
Click Start>Programs>IBM WebSphere Business Integration Server Express>Toolset Express>Administrative>Console
To perform all of the Console functions, the i5/OS profile of the user executing the tool must have these special authorities: *ALLOBJ and *JOBCTL.
The Console help text in the Help menu lists the specific authorities required to run the tool.
You can use the Console to create, configure, and delete server instances on an i5/OS system.
You can use the Console to create InterChange Server Express instances on an i5/OS system. To do this:
To configure advanced properties for an instance on the Create Instance panel, click the Advanced tab.
You can set the new server to use a specific repository name; the server name defaults as the repository. You can also enter a new or existing queue manager for the server; the default is <INSTANCENAME>. QUEUE.MANAGER. You can enable Role Based Access Control (RBAC) and set the server to have a remote database.
During the creation process, status messages are displayed on the screen. To view the server instance creation log, click View Log.
You can delete a server instance from the i5/OS system using the Console:
You can set a server to start automatically by setting the Autostart option. To do this:
The Console tool enables you to conveniently start and stop InterChange Server Express.
To start the server, click the green arrow icon to the right of the server name, as shown in the example above. To stop the server, click the red box icon. To see the current status of the server, click Refresh.
The Console enables you to view the InterChange System log file (InterChangeSystem.log) for a server instance. The Console opens the Toolset Express program LogViewer to display a snapshot of the server log file. You can set a property to allow LogViewer to refresh the log file from the i5/OS system. No default exists for this property; so to refresh the log, you must map a drive on the PC to the i5/OS system.
wbi.remote.dir=Z\:/QIBM/UserData/WBIServer44
The Console can configure queue managers for a specific server instance. Follow these steps to configure the queue manager:
Using the Console, you can add and remove connector agents.
You can add connector agents to the Console view. These connectors can either be custom connector agents or a connector agent that was removed previously from the Console view.
Prerequisites: You must create the job description on the i5/OS system prior to adding the connector agent.
Use the following steps to add a connector agent:
The connector agent you add only appears in the Console view. No changes occur on the i5/OS system.
When you remove a connector agent, it no longer appears in the Console. You can, however, use the Add connector agent or Rebuild list options to add it back to the Console. To remove a connector agent:
You can easily set a connector agent to start automatically with its server. To do this:
Use the Console to add and remove ODAs from an i5/OS system.
You can add a new or previously removed ODA to the Console view. To do this:
When you remove an ODA, it no longer appears in the Console view, but no change occurs to the i5/OS system.
The process for starting, stopping, and refreshing connector agents and ODAs is similar to the process for server instances.
Connector agents are listed in the Console view under their associated server.
ODAs are listed separately under the ODA tab.
The Configuration menu in the Console enables you to refresh the status of the components in the Console. The Refresh All Components option retrieves the current status of the components from the i5/OS system.
The Automatic Refresh option enables you to set a specific time interval for the Console to refresh the status of all components. The default time interval is 30 seconds.
From the Configuration menu, you can also choose the Rebuild Console Components option. This option adds all components previously removed back in the Console view. It also adds any newly installed features to the Console view.
The Console log can be used for troubleshooting. You can find the Console Log, called wbi-console-xx.log, in the following directory:
C:\IBM\WebSphereServer\log
To see more details in the log, set the Logging Level in the properties file to Finest. To do this: