Skip Headers
Oracle® Application Server Adapter for Siebel User's Guide
10g Release 2 (10.1.2)
Part No. B14062-01
  Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Previous
Previous
Next
Next
 

2 Adapter Configuration Using OracleAS Adapter Application Explorer

This chapter provides the information you require to create schemas for Siebel Business Objects.

This chapter discusses the following topics:

Starting Application Explorer

Prerequisites

Before starting Application Explorer and using the OracleAS Adapter for Siebel, you must create \endorsed directories under your OracleAS_home directory and place a copy of the xalan.jar file in those directories.

  1. Navigate to the OracleAS_home\j2ee\home\connectors\jca-app-adapter\jca-app-adapter directory and copy the xalan.jar file.

  2. Create an \endorsed subdirectory in the following two directories:

    • OracleAS_home\jre\1.4.2\lib\

    • OracleAS_home\jdk\jre\1.4.2\lib\

  3. Place a copy of the xalan.jar file into the new subdirectories.

    When you are done, ensure that you have the xalan.jar file in the following two directories:

    • OracleAS_home\jre\1.4.2\lib\endorsed

    • OracleAS_home\jdk\jre\1.4.2\lib\endorsed

Launching Application Explorer

The server must be started where Application Explorer is deployed.

To start Application Explorer:

  1. Ensure the server is started where Application Explorer is deployed.

  2. On Windows, invoke iaexplorer.exe, found under OracleAS_home\adapters\application\tools or on UNIX, invoke the iwae script, iwae.sh, found under OracleAS_home/adapters/application/tools.

OracleAS_home

Is the directory where the Oracle Application Server is installed.

Application Explorer opens. You are ready to define new targets to your Enterprise Information System (EIS).

Configuring Settings for BSE or JCA

Before a repository project can be created, you must configure OracleAS Adapter Business Services Engine (BSE). You need not configure the OracleAS Adapter JCA because the ra.xml file is configured automatically during installation.

Configuring the OracleAS Adapter Business Services Engine

After the OracleAS Adapter Business Services Engine (BSE) is deployed to Oracle Application Server, you can configure it through the BSE configuration page.

To configure BSE:

  1. Open the following page in your browser:

    http://hostname:port/bse
    
hostname

Is the hostname of the Oracle Application Server.

port

Is the HTTP port for the Oracle Application Server.

For example,

http://localhost:7777/bse

Note:

The first time you access this page, it may take time to load.

  1. When prompted, log on.

    When first installed, the user ID and the password are:

    • User name: admin

    • Password: admin

The BSE configuration page opens.

Business Services Engine configuration page.
Description of the illustration bse_config.gif

  1. Ensure the Adapter Lib Directory parameter specifies the path to the lib directory, for example:

    OracleAS_home\adapters\application\lib
    
    

    After you specify the path, adapters in the lib directory are available to BSE.

  1. For security purposes, type a new password in the Admin Password field.


Note:

The Repository URL field specifies where the file system repository is located. To use a database repository, you must enter the repository connection information. For the initial verification, use a file system repository. See "Configuring an Oracle Repository" for information on switching to a database repository.

  1. Click Save.

Configuring BSE System Settings

To configure Business Services (BSE) system settings:

  1. Open the BSE configuration page by entering the following URL:

    http://hostname:port/ibse/IBSEConfig
    
hostname

Is the machine where BSE is installed.

port

Is the port number on which BSE is listening.


Note:

The server to which BSE is deployed must be running.

The BSE settings window opens.

The system settings pane in BSE.
Description of the illustration ibse_config_page.gif

  1. Configure the system settings by providing information for the parameters according to the following table.

    1. Parameter Description
      Language Specify your required language.
      Adapter Lib Directory Type the full path to the directory where the adapter jar files reside
      Encoding Specify the default encoding from one of the following options:

      UTF-8

      EBCDIC-CP-US

      ISO-88859-1

      Shift JIS

      UNICODE

      Debug Level Specify the debug level from one of the following options:

      None

      Fatal

      Error

      Warning

      Info

      Debug

      Number of Async. Processors Select the number of asynchronous processors.

The following image illustrates the Security pane of the window.

BSE security settings pane.
Description of the illustration security.gif

  1. Configure the security settings by providing information for the parameters according to the following table.

Parameter Description
Admin User Provide an BSE administrator ID.
Admin Password Type the password associated with the BSE administrator ID.
Policy Select the check box to enable policy security.

The following image illustrates the Repository pane of the window.

Repository pane
Description of the illustration ibse_config_repos_loc.gif

  1. Configure the repository settings by providing information for the parameters according to the following table.

    BSE requires a repository to store transactions and metadata required for the delivery of Web services.

    See "Configuring a File System Repository" and "Configuring an Oracle Repository" for more information.

Parameter Description
Repository Type Select one of the following repositories from the list:

Oracle

File

Repository URL Type the URL to use when opening a connection to the database.
Repository Driver Provide the driver class to use when opening a connection to the database (optional).
Repository User Type the user ID to use when opening a connection to the database.
Repository Password Type the password associated with the user ID.
Repository Pooling Select the check box to enable pooling.

  1. Click Save.

Configuring a File System Repository

If you do not have access to a database for the repository, you can store repository information in an XML file on your local machine. However, a file system repository is less secure and efficient than a database repository. When BSE is first installed, it is automatically configured to use a file system repository.

The default location for the repository on Windows is:

OracleAS_home\j2ee\OC4J_CONTAINER\applications\ws-app-adapter \ibse\ibserepo.xml

On other platforms, use the corresponding location.

If you are using a file system repository, you are not required to configure any additional BSE components.

Configuring an Oracle Repository

To configure an Oracle repository:

  1. Contact your database administrator to obtain an Oracle user ID and password to create the BSE repository.

    This user ID should have rights to create and modify tables as well as the ability to create and execute stored procedures.

  1. Open a command prompt and navigate to the setup directory. Its default location on Windows is:

    OracleAS_home\adapters\application\etc\setup
    

    For other platforms, see the corresponding location.

    This directory contains SQL to create the repository tables in the following file:

    iwse.ora
    

Note:

If Oracle is not on the same machine as the Oracle Application Server, copy the iwse.ora file to the Oracle machine. Then, from a command prompt on the Oracle machine, navigate to the directory containing the iwse.ora file.

  1. Type the following command:

    sqlplus userid/password @database @ iwse.ora
    

Creating a Repository Project

Before you use Application Explorer with the OracleAS Adapter for Siebel, you must create a repository project. You can create two kinds of repository projects, Web services and JCA, depending on the container to which the adapter is deployed. At design time, the repository is used to store metadata created when using Application Explorer to configure adapter connections, browse EIS objects, configure services, and configure listeners to listen for EIS events. The information in the repository is also referenced at runtime.

A default JCA repository is created for the default ManagedConnectionFactory. The name of this project is jca_sample.

Web services and the OracleAS Adapter Business Services Engine (BSE) refer to the same type of deployment. See "Adapter Features" for more information.

Creating a Web Service Project for the Web Service Adapter

To create a Web service project for BSE using Application Explorer, you must first define a new configuration.

Defining a New Configuration for BSE

To create a new repository project for BSE:

  1. Right-click Configurations and select New.

    The New Configuration dialog box opens.

  2. Enter a name for the new configuration (for example, SampleConfig) and click OK.

    The following opens.

    bse new configuration
    Description of the illustration app_exp_new_config_type.gif

  3. From the Service Provider list, select BSE.

  4. In the BSE URL field, accept the default URL or replace it with a different URL with the following format:

    http://hostname:port/ibse/IBSEServlet
    
hostname

Is the machine where your application server resides.

port

Is the port number where the application server is listening.

  1. Click OK.

    A node representing the new configuration appears beneath the root Configurations node.

    new configuration node
    Description of the illustration newconfig_a.gif

The Web service repository project file is stored in OracleAS_home\j2ee\home\applications\ws-app-adapter\ibse.

Creating a Repository Project for the OracleAS Adapter JCA

To create a repository project for the OracleAS Adapter JCA using Application Explorer, you must first define a new configuration.

Defining a New Configuration for JCA

To define a new configuration for JCA:

  1. Right-click Configurations and select New. select new configuration
    Description of the illustration selectnewconfig.gif

    The New Configuration dialog box opens.

  2. Enter a name for the new configuration (for example, SampleConfig) and click OK.

    JCA configuration
    Description of the illustration jcaconfig.gif

  3. From the Service Provider list, select JCA.

  4. In the Home field, enter a path to your JCA configuration directory where the repository, schemas, and other information is stored, for example:

    OracleAS_home\adapters\application
    
    
  5. Click OK.

    A node representing the new configuration appears beneath the root Configurations node.

    new configuration
    Description of the illustration newconfig_a.gif

The OracleAS Adapter JCA repository project file is stored in OracleAS_home\adapters\application\config\configuration_name

configuration_name

Is the name of the configuration you created; for example, SampleConfig.

Connecting to a New Configuration

To connect to a new configuration:

  1. Right-click the configuration to which you want to connect, for example, SampleConfig.

  2. Select Connect.

    Nodes appear for Adapters, Events, and Business Services (also known as Web services).

Sample Config node
Description of the illustration new_config.gif

  • Use the Adapters folder to create inbound interaction with Siebel. For example, you use the Siebel node in the Adapters folder to configure a service that updates Siebel.

  • Use the Events folder to configure listeners that listen for events in Siebel.

  • Use the Business Services folder to test Web services created in the Adapters folder. You can also control security settings for the Web services by using the security features of the Business Services folder.

You are now ready to define new targets to Siebel.

Establishing a Connection (Target) for Siebel

To browse the Siebel Business Services, Business Components, and Integration Objects, you must define a target to Siebel. After you define the target, the parameters are automatically saved. However, you must supply the password to Siebel every time you connect to the target.

Defining a Target to Siebel

To define a target to Siebel:

  1. In the left pane, expand the Adapters node.

    expanded adapter list
    Description of the illustration adapterexpandedpartial.gif

  2. Right-click the Siebel node and select Add Target.

    The Add Target dialog box opens.

    1. In the Name field, type a name for the new target.

    2. In the Description field, type a description (optional).

    3. From the Target Type list, select the type of target; for Siebel 6.0, choose Siebel 6.2 or lower (COM). For Siebel 6.3 or higher, choose Java Bean Data Connection.

  3. Click OK.

    • When you select Siebel 6.2 or lower (COM):

    1. In the User Agent File field, type the name of the configuration file.

    2. In the Username field, type the user name.

    3. In the Password field, type the password associated with the user name.

    4. In the Repository field, type the Siebel Repository where Application Explorer looks for metadata describing Business Services, Business Objects, and Integration Objects.

      If no repository is specified, a full list of objects from all available repositories will be returned. If a specified repository is not found, an empty list of objects will be returned.

    • When you select 6.3 or higher (JDB):

    1. In the Gateway Server field, type the name of the server.

    2. In the Enterprise Name field, type the appropriate name.

    3. In the Siebel Server field, type the name of your Siebel server.

      Do not populate this field for Siebel 7.7.1.

    4. In the User field, type the user name.

    5. In the Password field, type the password associated with the user name.

    6. Click the Advanced tab and verify the following:

      Language

      Object Manager

      For Siebel 7.0.3, the default Object Manager is EAIObjMgr. For Siebel 7.7, the default is EAIObjMgr_enu.

      Repository Manager

      If no repository is specified, a full list of objects from all available repositories will be returned. If a specified repository is not found, an empty list of objects will be returned.

      The configuration parameters supplied are those used by Siebel client applications to connect to the Siebel system. For more information about these parameters, see your Siebel documentation or ask your Siebel system administrator.

  4. Click OK.

    In the left pane, the target you create appears under the Siebel node.

Connecting to a Defined Target

To connect to a defined target:

  1. Expand the Siebel node and click the target name to which you want to connect.

  2. In the right pane, enter the password for that target.

  3. In the left pane, right-click the target name and select Connect.

    The icon changes, and a plus sign(+) next to the target icon indicates that you are connected to the Siebel system.

    You can browse available Business Objects, Business Services, and Integration Objects in the Siebel system.

Disconnecting From Siebel

Although you can maintain multiple open connections to different application systems, it is good practice to close connections when not in use.

To disconnect from Siebel:

  1. In the left pane, select the target to which you are connected.

  2. Right-click the target and select Disconnect.

    Disconnecting from the application system drops the target, but the node remains. The SiebelConnection node in the left pane changes to reflect that the target is closed.

Editing a Target

To edit a target:

  1. In the left pane, ensure the target you wish to edit is disconnected.

  2. Right-click the target and select Edit.

    The Edit pane opens on the right.

  3. Modify the target information.

  4. Click OK.

Deleting a Target to Siebel

You can delete a target, rather than just disconnecting and closing it. When you delete the target, the node disappears from the list of Siebel targets in the left pane of the explorer.

To delete a target:

  1. In the left pane, select the target.

  2. Right-click the target and select Delete.

    A confirmation dialog box opens.

  3. Click OK to delete the target you selected.

    The SiebelConnection node disappears from the left pane.

Viewing Application System Objects

Application Explorer gives you the flexibility of viewing all Siebel application system objects. One benefit of this flexibility is that you can gain an understanding of the Siebel data structure. You can review parameters, data types, and other attributes of the Siebel data in the right pane.

Viewing Metadata

To view metadata:

  1. If you have not started the explorer, start Application Explorer and connect to your Siebel system.

  2. In the left pane, expand the Business Object or Business Service containing the component for which you want to generate schema.

  3. Expand the Business Object or Business Service node.

  4. Expand the Business Component or the Business Service node to view the objects under it.

  5. In the right pane, click the ellipsis (...) in the Table row of the properties table.

    The metadata table appears in the right pane.

    Metadata table for Siebel object.
    Description of the illustration app_exp_showmetadata.gif

Creating an XML Schema

You can create service schemas for Business Services and Business Components using Application Explorer.

The following topic, "Creating an XML Schema for a Siebel Business Object or Business Service" describes how to create schemas for the adapter when you deploy the OracleAS Adapter for Siebel for use either in a JCA (J2EE Connector Architecture) environment or a Web services environment.

See "Creating a Web Service or Business Service" if you plan to deploy the OracleAS Adapter for Siebel in a Web services environment.

Creating an XML Schema for a Siebel Business Object or Business Service

You create schemas for Siebel Business Service methods (for example, the Add method) and Business Components using Application Explorer. After you create a schema, you can use it to generate service request and response schemas for the Business Service or Business Component.

Siebel Business Objects contain one or more Siebel Business Components. You can view Business Components by clicking the associated Business Object.

The following illustration shows the Account Business Object expanded to display all Business Components.

A Siebel Account Business Object expanded.
Description of the illustration account_expanded.gif

Creating an XML Schema for a Siebel Business Component or Business Service

To generate service request and response schemas for a Business Component or Business Service:

  1. If you have not started the explorer, start Application Explorer and connect to your Siebel system.

  2. In the left pane, expand the Business Object or the Business Service node.

  3. Expand the Business Component or Business Service to view the objects under it.

  4. Right-click the node and select Generate Schema.

    Application Explorer accesses the Siebel repository and builds schemas.

    Schema tabs similar to the following appear in the right pane.

    The Schemas table.
    Description of the illustration app_exp_bus-obj_schema_t.gif

  5. To view a schema, click the ellipsis tab corresponding to the schema you want to view.

    The schema appears on the right.

    An example of a schema generated by the adapter.
    Description of the illustration app_exp_sieb_acct_schema.gif

Creating a Web Service or Business Service

You can generate a business service (also known as a Web service) for Siebel objects you wish to use with your adapter after you have properly configured the servlet BSE.


Note:

In a J2EE Connector Architecture (JCA) implementation of adapters, Web services are not available. When the adapters are deployed to use the OracleAS Adapter JCA, the Common Client Interface provides integration services using the adapters.

As an example, the following procedure describes the creation of a Web service for a Business Object.

To generate a Web service for a Siebel Business Object:

  1. If you have not already connected, connect to your Siebel system.

  2. Expand a Business Object node.

  3. Expand the Business Component for which you want to create a Web service.

    The Account Business Component expanded.
    Description of the illustration app_exp_select_busobject_query.gif

  4. Expand the object and select a method for creating the Web service, for example, QueryWithView under Account.

  5. Right-click the node from which you want to create a business service and select Create Business Service.

    The Create Web Service dialog box opens.

    You can add the business object as a method for a new Web service or as a method for an existing one.

  1. Click Next.

    The License and Method dialog box opens.

    1. In the License field, select one or more license codes to assign to the Web service. To select more than one, hold down the Ctrl key and click the licenses.

    2. In the Method Name field, type a descriptive name for the method.

    3. In the Description field, type a brief description of the method.

  2. Click OK.

    Application Explorer switches the view to the Business Services node, and the new Web service appears in the left pane.

Testing a Web Service

After you create a Web service for the Siebel Business Object, test it to ensure it functions properly. Application Explorer includes a test tool for testing a Web service.

Testing a Web Service for a Business Object

  1. In the left pane of Application Explorer, expand the Business Services node.

  2. Expand the Services node.

  3. Select the name of the business service you want to test.

    New Web service added on Business Services tab.
    Description of the illustration app_exp_test_select_busobj.gif

  4. Expand the Methods node under the service and select the method you want to test.

    The test option appears in the right pane.

    If you are testing a Web service that requires XML input, an input field appears.

  5. Click Invoke.

    Application Explorer displays the results in the results pane.

    Successful test of a Web service.
    Description of the illustration app_exp_querywithview_results.gif

Testing a Web Service for a Business Service

After you create a Web service for the Siebel Business Service, test it to ensure it functions properly. Application Explorer includes a test tool for testing a Web service.

  1. If it is not expanded, expand the Business Services node.

  2. Expand the Services node.

  3. Select the name of the business service you want to test.

  4. Expand the Methods node and select the name of the method you want to test.

    The test option appears in the right pane.

    If you are testing a Web service that requires XML input, an input field appears.

  5. Provide the appropriate input.

  6. Click Invoke.

    Application Explorer displays the results in the results pane.

Configuring an Event Adapter

Events are generated as a result of a specific business condition being satisfied or triggered in the Siebel system. You can use events to trigger an action in your application. For example, an update to a database can reflect an update to customer information. If your application must perform when this happens, your application is a consumer of this event.

After you create a connection to your application system, you can add events using Application Explorer. To configure an event, you must create a port and a channel.


Note:

OC4J currently conforms to JCA 1.0, which does not call for event capabilities. When conforming to JCA 1.0, only service interactions are supported.

Creating an Event Schema for a Siebel Integration Object

You can listen for Siebel Integration Object events by configuring ports and channels. Before you create the ports and channels, you must create a schema. To create XML schemas for Siebel Integration Objects, you must first generate XDR schemas using the Siebel Tools Schema Wizard.

The XDR schema is used as input to Application Explorer when generating schemas for integration objects. After you generate the XDR schema, Application Explorer uses the XDR file to generate the XML schema.

The OracleAS Adapter for Siebel supports access to Siebel Integration Objects by using Siebel XML to handle events. Using Siebel Integration Objects through supported transports requires Siebel workflows.


Note:

For releases prior to Siebel 6.3, the Siebel Tools Schema Wizard creates only DTD schemas. You must transform these schemas manually, or by using other tools, into XDR files before Application Explorer can use them as input to create XML schemas. In addition, you must include the SiebelMessage tag reference in your XDR file.

Creating a Siebel XDR Schema for a Siebel Integration Object

To generate a Siebel XDR schema:

  1. Log on to Siebel Tools.

    Siebel log on window.
    Description of the illustration sibu_04_logon.gif

    1. Type your user ID and password.

    2. Select a database from the list.

  2. Click OK.

    The Siebel Tools window opens. Integration Objects appear in the right pane.

    Siebel Tools window.
    Description of the illustration sibu_04_integobj.gif

  3. To create a schema, select an Integration Object, for example, Sample Account.

  4. Click Generate Schema.

    The Generate XML Schema wizard opens.

    Opening window of Siebel Generate XML Schema.
    Description of the illustration sibu_genxmlschema.gif

    1. From the Select a Business Service list, select EAI XML XDR Generator.

    2. From the Select an envelope type list, select Siebel Message envelope.

    3. In the Choose the file name field, specify a file name for the XDR schema and a directory where it can be accessed by Application Explorer.


      Note:

      The XDR schema file must be saved to a directory on the same computer as Application Explorer.

  5. Click Finish.

    Now you can use Application Explorer to generate XML schemas for the Siebel Integration Object.

Creating a Schema from a Siebel XDR Schema

After you create the Siebel XDR schema for a selected Siebel Integration Object, you can create an XML schema using Application Explorer.

You must supply Application Explorer with the location of the previously created Siebel XDR schema for the particular integration object selected.


Note:

The XDR file must be on the same computer as Application Explorer or be available through a mapped connection to another drive or machine.

To create a schema from a Siebel XDR Schema:

  1. In Application Explorer, expand the Integration Objects node to browse the Integration Objects in the Siebel system.

    Siebel Integration Objects node expanded.
    Description of the illustration sampleaccount.gif

  2. Scroll down and select an integration object, for example, Sample Account.

  3. To generate event schema, right-click the object and choose Add event.

    The Add Event dialog box opens.

    1. In the Node name field, type a name for the node to be created under Sample Account.

    2. Type or browse to the location of the XDR schema where Application Explorer generates the service or event schema.

  4. Click Add.

    The Schemas pane opens.

    Schemas table for Siebel Integration Object.
    Description of the illustration app_exp_event_gen_sche.gif

  5. To view the XML for a schema, click the Event Schema tab.

    The results appear in the right pane.

    A schema generated for a Siebel Integration Object.
    Description of the illustration app_exp_sampacct_bo_schema.gif

  6. Click the browser Back button to return.

    A directory structure is created to store the schemas.

    You are now ready to configure ports and channels for Siebel Integration Objects.

Creating an Event Port

To create an event port for Siebel Integration Objects, you must first indicate the location of the XDR schema for that object.

You can create an event port from the Events node for Siebel Integration Objects. To create event ports for Siebel Business Objects and Siebel Business Services, you must use the Events node.

Creating an Event Port from the Adapters Node

For Siebel Integration Objects, you can bypass the Events node and create an event port directly from the Adapters node.

  1. Select the Integration Object event you created.

  2. Right-click the Integration Object event and select Add Port.

    The Add Port dialog box opens.

    1. Type a name for the event port and provide a brief description.

    2. From the list, select the required disposition, for example, RMI.

    3. In the URL field, type the disposition url.

  3. Click OK.

Creating an RMI Event Port From the Events Node

The following procedure describes how to create an event port from the Events node for an RMI disposition using Application Explorer.

To create an event port for Siebel Integration Objects, you must first indicate the location of the XDR schema for that object. See "Creating a Schema from a Siebel XDR Schema" for more information.

You also can create an event port directly from the Adapters node. See "Creating an Event Port from the Adapters Node" for more information.

Creating an Event Port for RMI

To create a specific event port for RMI:

  1. Click the Events node.

    Events node
    Description of the illustration eventexpandedpartial.gif

  2. Expand the Siebel node.

  3. Right-click the Ports node and select Add Port.

    The Add Port dialog box opens.

    1. Type a name for the event port and provide a brief description.

    2. From the Protocol list, select RMI.

    3. In the URL field, specify a destination file to which the event data is written using the following format:

      rmi://host:port;RemoteObject=[APPNAME];errorTo=[pre-defined port name or another disposition url]
      
      
    4. From the Disposition protocol list, select RMI.

    The following table defines the parameters for the disposition.

    Parameter Description
    host The host name or IP address from which the RMI server accepts RMI requests. If you omit this attribute, the RMI server will accept RMI requests from any host.
    port The port number on which the RMI server listens for RMI requests.
    RemoteObject A home or Enterprise JavaBeans (EJB) object.
    errorTo Predefined port name or another disposition URL to which error logs are sent.

  4. Click OK.

    The port appears under the ports node in the left pane. In the right pane, a table appears that summarizes the information associated with the event port you created.

    You are ready to associate the event port with a channel. See "Creating a Channel" for more information.

Editing an Event Port

To edit an event port:

  1. In the left pane, select the event port you want to edit.

  2. Right-click the port and select Edit.

    The Edit Port pane opens.

  3. Make the required changes and click OK.

Deleting an Event Port

To delete an event port:

  1. Select the event port you want to delete.

  2. Right-click the port and select Delete.

    A confirmation dialog box opens.

  3. To delete the event port you selected, click OK.

    The event port disappears from the list in the left pane.

Creating a Channel

The following procedure describes how to create a channel for your event. All defined event ports must be associated with a channel. Three channel types are available:

  • HTTP

  • MQ Series

  • File


Note:

OC4J currently conforms to JCA 1.0, which does not call for event capabilities. When conforming to JCA 1.0, only service interactions are supported.

Creating an HTTP Channel

To create a channel:

  1. Click the Events node.

    The Events window opens. The adapters that appear in the left pane support events.

  2. In the left pane, expand the Siebel node.

    The ports and channels nodes appear.

  3. Right-click channels and select Add channel.

    The Add Channel dialog box opens.

    1. Type a name for the channel, for example, NewChannel.

    2. Type a brief description.

    3. From the list, select HTTP Listener.

      The following image shows the Select Ports dialog box.

      Image showing ports available to a channel.
      Description of the illustration app_exp_siebel_addport.gif

    4. Select an event port from the list of current ports.

    5. To transfer the port to the list of available ports, click the double right (>>) arrow. To associate all the event ports, control-click to select each port or click one port and press Control+A. Then, click the double right (>>) arrow.

  4. Click Next.

  5. When the dialog box opens, type the system information as specified in the following table.

    Parameter Description
    Port Port on which to listen for Siebel event data.
    Server port Port on which the host database is listening.
    Synchronization Type Possible values are:
    REQUEST
    REQUEST_RESPONSE
    REQUEST_ACK
    

  6. Click OK.

    The summary pane opens.

    A summary provides the channel description, channel status, and available ports. All the information is associated with the channel you created.The channel also appears under the channels node in the left pane

    New channel added under channels node.
    Description of the illustration app_exp_new_channel_added.gif

    An X over the icon indicates that the channel is currently disconnected. You must start the channel to activate your event configuration.

  7. Right-click the channel and select Start the channel.

    The channel you created becomes active.

    The X that was over the icon in the left pane disappears.

  8. To stop the channel, right-click the channel and select Stop the channel.

Creating an MQ Series Listener

To create an MQ Series listener:

  1. Click the Events node.

    The Events window opens. The adapters that appear in the left pane support events.

  2. In the left pane, expand the Siebel node.

    The ports and channels nodes appear.

  3. Right-click the channels node and select Add channel.

    The Add a new channel pane opens.

    1. Type a name for the channel, for example, NewChannel.

    2. Type a brief description.

    3. From the list, select MQ Series Listener.

      The following image shows the Select Ports dialog box.

      The ports available to be assigned to a channel.
      Description of the illustration app_exp_siebel_addport.gif

    4. Select an event port from the list of current ports.

    5. To transfer the port to the list of available ports, click the double right (>>) arrow.To associate all the event ports, control-click to select each port or click one port and press Control+A. Then, click the double right (>>) arrow.

  4. Click Next.

  5. When the dialog box opens, type the system information as follows.

    1. In the Request tab, enter values for the following parameters:

      Parameter Description
      Queue manager name The host on which the MQ Server is located (MQ Client only).
      MQ server host for MQClient operation Port on which the host database is listening.
      MQ server port for MQClient operation The number to connect to an MQ Server queue manager (MQ client only).
      REQUEST
      REQUEST_RESPONSE
      REQUEST_ACK
      
      MQ server channel for MQClient operation The case-sensitive name of the channel that connects with the remote MQ Server queue manager (MQ client only). The default channel name for MQSeries is SYSTEM.DEF.SVRCONN.
      Document type XML Leave the default selection.
      Request queue name Queue where the message is routed and where request documents are received. The name of the queue is case-sensitive and conforms to the following format:
      Host\queue type$\qName
      

      Host

      Is the machine name where the MQ Series queuing system is running.

      queue type

      Private queues are queues that are not published in Active Directory and appear only on the local computer where they reside. Private queues are accessible only by Message Queuing applications that recognize the full path name or format name of the queue.

      qName

      Is the name of the queue where messages are placed, for example,

      iwaykxc1\Private$\siebel
      

    2. In the Response tab, enter values for the following parameters:

      Parameter Definition
      Synchronization Type Choose from three options:
      • REQUEST

      • REQUEST_RESPONSE

      • REQUEST_ACK


    3. In the Advanced tab, enter values for the following parameters.

      Parameter Definition
      Error Directory Directory to which documents with errors are written.
      Message wait interval (msec) The interval (in milliseconds) when to check for new input. The default is 3 seconds. Optional.
      Mode of operation Choose Sequential or Threaded.
      • Sequential indicates single processing of requests.

      • Threaded indicates processing of multiple requests simultaneously.

      Thread limit If you selected threaded processing, indicate the maximum number of requests that can be processed simultaneously.

  6. Click OK.

    The summary pane opens.

    A summary provides the channel description, channel status, and available ports. All the information is associated with the channel you created. The channel also appears under the channels node in the left pane

    An X over the icon indicates that the channel is currently disconnected. You must start the channel to activate your event configuration.

  7. Right-click the channel and select Start the channel.

    The channel you created becomes active.

    The X that was over the icon in the left pane disappears.

  8. To stop the channel, right-click the channel and select Stop the channel.

Creating a File Listener

  1. Click the Events node.

    The Events window opens. The adapters that appear in the left pane support events.

  2. In the left pane, expand the Siebel node.

    The ports and channels nodes appear.

  3. Right-click the channels node and select Add Channel.

    The Add Channel dialog box opens.

    1. Type a name for the channel, for example, NewChannel.

    2. Type a brief description.

    3. From the list, select File Listener.

      The following image shows the Select Ports dialog box.

      The ports available to be assigned to a channel.
      Description of the illustration app_exp_siebel_addport.gif

    4. Select an event port from the list of current ports.

    5. To transfer the port to the list of available ports, click the double right (>>) arrow button. To associate all the event ports, control-click to select each port or click one port and press Control+A. Then, click the double right (>>) arrow button.

  4. Click Next.

  5. When the dialog box opens, type the system information as follows.

    1. In the Request tab, enter values for the following parameters:

      Parameter Description
      Polling Location The target file system location for the Siebel XML file.
      File Mask The file name to be used for the output file generated as a result of this operation.

    2. In the Response tab, enter values for the following parameters:

      Parameter Definition
      Synchronization Type Choose from three options:
      • REQUEST

      • REQUEST_RESPONSE

      • REQUEST_ACK

      Response/Ack Directory Directory where responses or acknowledgments are sent.

    3. In the Advanced tab, enter values for the following parameters:

      Parameter Definition
      Error Directory Directory to which documents with errors are written.
      Poll interval (msec) The interval (in milliseconds) when to check for new input. The default is 3 seconds. Optional.
      Processing Mode Choose Sequential or Threaded.
      • Sequential indicates single processing of requests.

      • Threaded indicates processing of multiple requests simultaneously.

      Thread limit If you selected threaded processing, indicate the maximum number of requests that can be processed simultaneously.

  6. Click OK.

    The summary pane opens.

    A summary provides the channel description, channel status, and available ports. All the information is associated with the channel you created.The channel also appears under the channels node in the left pane

    An X over the icon indicates that the channel is currently disconnected. You must start the channel to activate your event configuration.

  7. Right-click the channel and select Start the channel.

    The channel you created becomes active.

    The X that was over the icon in the left pane disappears.

  8. To stop the channel, right-click the channel and select Stop the channel.

Editing a Channel

To edit a channel:

  1. In the left pane, select the channel you want to edit.

  2. Right-click the channel and select Edit.

    The Edit channels pane opens.

  3. Make the required changes to the channel configuration and click OK.

Deleting a Channel

To delete a channel:

  1. In the left pane, select the channel you want to delete.

  2. Right-click the channel and select Delete.

    A confirmation dialog box opens.

  3. To delete the channel you selected, click OK.

    The channel disappears from the list in the left pane.