Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved


Chapter 5 Configuring Adapter Services : Message Subscription Service

Message Subscription Service
When running as a Subscription Service the adapter receives messages from the TIBCO Environment and inserts the message data into a PeopleSoft database using the Integration Broker.
Configuration Options
Configure a Message Subscription Service under the following tabs in the Configuration Panel.
Configuration Tab
The Configuration tab contains the following fields:
The name of the Message stored in the PeopleSoft database. It matches the Message Name and is automatically filled in by TIBCO Designer.
TIBCO Designer automatically supplies this name when you click the Fetch Message… button and select a Message. When starting the adapter, it uses this name to find the Message in PeopleSoft. You can enter a partial string in this field to filter the Messages that are presented in the drop-down list when you click the Fetch Message… button.
For example, entering p would narrow the drop-down list to only Message names beginning with p.
Available only for the JMS transport. It can be Durable or Non Durable. See Delivery Mode for details.
Available only for the Rendezvous transport. It can be Certified, Reliable or Distributed Queue. See Quality of Service for details.
Services must use the same wire format to exchange data. It can be XML Message or ActiveEnterprise Message. See Wire Format for details.
Get Schema
Click the Get Schema button to list the fields of the fetched schema in the Schema Tab.
If you have changed any configuration, either on the service level or on the instance level, click the Get Schema button to ensure that the modification is reflected in the service at runtime.
Schema Tab
In the Schema tab you can view all elements.
 
To view schema elements, click on the folders to expand them. It is not necessary to click the Apply button.
The Schema tab contains the following fields:
Note: The values are TIBCO field-types and not PeopleSoft field-types.
SubscriberOptions Tab
The SubscriberOptions tab contains the following fields:
Available only for the JMS transport. It can be Persistent or Non-Persistent. See Delivery Mode for details.
Available only for the JMS transport. The subject on which IB subscribes for messages from the adapter. The subject name entered here should be the same as the one entered in the integrationGateway.properties file
Available only for the JMS transport. The password used to connect to the TIBCO Enterprise Message Server (EMS).
Available only for the JMS transport. The URL of the TIBCO Enterprise Message Server (EMS).
Available only for the HTTP transport. The port at which the adapter waits for HTTP messages. By default, the adapter listens at port 2002 for IB messages.
Advanced Tab
The Advanced tab contains the following fields:
By default, a dynamic destination is generated using the Domain and Deployment global variables, the adapter acronym, the adapter instance name, and the service name.
If you use this default dynamic destination, ensure that the values for Domain and Deployment are not empty. You can override the default dynamic destination by specifying the static destination in this field. The static destination must be defined on the EMS server before it can be used by the runtime adapter. See the TIBCO Enterprise Message Service User’s Guide for information about destinations.
Available only for the Rendezvous transport.
By default, a service uses a message subject that is generated using the Domain and Deployment global variables, the adapter acronym, the adapter instance name and the service name.
If you use this default subject, make sure the values for Domain and Deployment are not empty. You can type a TIBCO Rendezvous subject name different from the default in this field. See TIBCO Rendezvous Concepts for information about specifying subject names.
Configuration Task Sequence
To configure a Subscription Service, follow these steps:
1.
2.
Click Adapter Services in the project panel.
3.
Drag a Message Subscription Service icon to the Design Panel.
4.
Specify options in the Configuration tab. See Configuration Tab for more information.
5.
Click the Apply button. This generates a unique endpoint with a TIBCO Rendezvous subject name. The adapter automatically enters this information in the Advanced tab.
Rendezvous is selected as the default Transport Type. If you select JMS as the Transport Type, a unique endpoint with the destination name will be generated.
6.
Click the Get Schema button. This downloads the message schema from PeopleSoft to TIBCO Designer.
7.
Specify options in the SubscriberOptions tab. See SubscriberOptions Tab for more information.
8.
Click the Apply button.
9.

Copyright © Cloud Software Group, Inc. All Rights Reserved
Copyright © Cloud Software Group, Inc. All Rights Reserved