IBM Integration Bus, Version 10.0.0.0 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS


Viewing and managing an integration node in the IBM Integration API Exerciser

Use the IBM® Integration API Exerciser sample to view and manage an integration node.

About this task

To view and manage an integration node by using the IBM Integration API Exerciser, complete the following steps:

Procedure

  1. Start the IBM Integration API Exerciser:
    • Windows platformOn Windows, run the command:
      install_dir/server/sample/IntegrationAPI/StartIntegrationAPIExerciser
    • Linux platformUNIX platformz/OS platformOn other platforms:
      1. Start an integration node command environment by running mqsiprofile, or follow the guidance provided in the StartIntegrationAPIExerciser shell script to configure the correct CLASSPATH for your environment.
      2. Ensure that your user ID has write permission to the current directory. The IBM Integration API Exerciser stores its configuration settings in a file in this directory.
      3. Run the shell script:
        install_dir\server\sample\IntegrationAPI\StartIntegrationAPIExerciser
    The IBM Integration API Exerciser window opens.
  2. Connect to a running integration node by clicking either:
    • File > Connect to Local Integration Node
    • File > Connect to Remote Integration Node

    The Connect to an Integration Node dialog opens.

  3. Enter the connection parameters to the integration node, then click Submit.

    Integration node information is retrieved and displayed in the IBM Integration API Exerciser window. You have now connected to the integration node.

    The upper left of the screen contains a hierarchical representation of the integration node to which you are connected. Selecting objects in the tree causes the table on the right to change, reflecting the attributes of the object that you select. The Method column lists IBM Integration API methods that you can call in your own Java™ applications, and the Result column indicates the data that is returned by calling the IBM Integration API method on the selected object.

  4. Run an IBM Integration API method against an integration node object. IBM Integration API methods are used to manage objects in an integration node.
    1. In the navigation tree, right-click an integration node.

      A pop-up menu opens to show all the available IBM Integration API methods.

    2. Select Create integration server. The Create integration server dialog opens.
    3. Enter the name for a new integration server and click Submit. The output from the method is displayed in the log window at the bottom of the screen. For example:
      16:53:50 ----> iapi.exerciser.ExerciserAdministeredObjectListener.processActionResponse(...)
      16:53:50 affectedObject = IBNODE
      16:53:50 completionCode = success
      16:53:50 (Reference property) commsmessage.lastinbatch=true
      16:53:50 (Reference property) uuid=595e1d10-3875-11d4-a485-000629be5bf8
      16:53:50 (Reference property) child.uuid=1d8b3c5d-2001-0000-0080-c2000502e620
      16:53:50 (Reference property) configmanagerproxy.osname=Windows
      16:53:50 (Reference property) child.name=int_server2
      16:53:50 (Reference property) userid=myuserID
      16:53:50 (Reference property) configmanagerproxy.hostname=myhost
      16:53:50 (Reference property) commsmessage.configobjecttype=Broker
      16:53:50 (Reference property) type=Broker
      16:53:50 (Reference property) child.type=ExecutionGroup
      16:53:50 (Reference property) commsmessage.operationtype=createchild
      16:53:50 (Reference property) timetowaitms=30000
      16:53:50 <---- iapi.exerciser.ExerciserAdministeredObjectListener.processActionResponse()

      In this example, completionCode = success means that the request to create the integration server is successful. The lines marked (Reference property) describe the request to which the response refers.

Results

During these steps you connected to an integration node, viewed the integration node information, and performed a management task by using the IBM Integration API Exerciser.

What to do next

Continue to work with the IBM Integration API Exerciser, or run another sample.

ae33360_.htm | Last updated 2015-03-27 19:26:41