Siebel eFinance Guide > Integration > AMS Connector >

Installing and Configuring IBM MQSeries AMI

The AMS Connector uses IBM MQSeries Application Messaging Interface (AMI) as the transport mechanism between Siebel eFinance and AMS ACAPS. Figure 20 illustrates this relationship.

Figure 20.  IBM MQSeries AMI as a Transport Mechanism
Click for full size image

Prior to using the AMS Connector, you need to install and configure:

For more information, contact your IBM sales representative and consult your IBM documentation.

The AMI Administration Tool allows you to configure services and policies stored in a repository file (for example, amt.xml).

Service points define where the message needs to be sent. Policies define how the messages need to be handled. It is very important to understand what a policy is and how to set different policy elements. For more information on AMI policies, consult your IBM documentation.

To configure the services and policies stored in the repository file

  1. Launch IBM MQSeries AMI Administration Tool.
  2. Create a Service Point named SIEBEL.ACAPS.SENDER using the values defined in the following table.
    Name
    Value
    Comments
    Queue Name
    ACAPS.SIEBELDEV7.XML.REQUEST
    The queue on this Queue Manager to which Siebel eFinance sends requests.
    Queue Manager Name
    SIEBEL
    SIEBEL is the Queue Manager on the AMS server to which Siebel eFinance is connecting.
  3. Create a Service Point named SIEBEL.ACAPS.RECEIVER using the values defined in the following table.
    Name
    Value
    Comments
    Queue Name
    ACAPS.SIEBELDEV7.XML.REPLY
    The queue on this Queue Manager where AMS posts its responses to requests from Siebel eFinance.
    Queue Manager Name
    SIEBEL
    SIEBEL is the Queue Manager on the AMS server to which Siebel eFinance is connecting.
  4. Create a Policy named SIEBEL.ACAPS.POLICY using the values defined in the following table.
    Name
    Value
    Comments
    Connection Name
    SIEBEL
    SIEBEL is the Queue Manager on the AMS server to which Siebel eFinance is connecting.
    Connection Type
    Client
    Siebel eFinance is connecting to the AMS server as a client.
    Clients Channel Name
     
    The name of client channel on the AMS MQSeries server that allows connections to this Queue Manager.
    Client TCP Server Address
     
    The IP address on the AMS server to which Siebel eFinance is connecting. This is also the server on which the Queue Manager resides.

After defining the AMI policy and AMI service points, you should verify certain enterprise parameters in the Siebel Client, as shown in Table 12. These parameters are preset in the Application Administration, System Preferences view, and are used by the AMS Application Service business service, AMS Send Receive method.

Table 12. MQSeries AMI Transport Specific Parameters 
Argument
Display Name
System Preference Name
Description
MqReceiverServiceName
Policy Name
AMS AMI Receiver Service Name
The name of the service point you defined as the receiver in the AMI Administration Tool.
Set MqReceiverServiceName to SIEBEL.ACAPS.RECEIVER for your workflow process step or business service method.
MqPolicyName
Policy Name
AMS AMI Policy Name
The name of the policy you define in the AMI Administration Tool. The AMI policy defines properties such as Connection Type and Mode, Message Type, Send and Receive parameters, and many others. The policy is stored in the AMI Repository, which is an XML document.
Set MqPolicyName parameter to SIEBEL.ACAPS.POLICY for your workflow process step or business service method.
MqSenderServiceName
Sender Service Name
AMS AMI Sender Service Name
The name of the service point you defined as the sender in the AMI Administration Tool.
Set MqSenderServiceName parameter to SIEBEL.ACAPS.SENDER for your workflow process step or business service method.

 Siebel eFinance Guide 
 Published: 20 October 2003