![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
1. Prepare the Tuxedo environment. See Preparing Tuxedo for details.
2. Start TIBCO Designer and open a multi-file project. See the TIBCO Designer documentation for details.
3. Drag and drop the TuxedoAdapterConfiguration icon from the palette panel to the design panel. This creates an adapter named, by default, TuxedoAdapterConfiguration.
4. Configure the adapter instance. See Adapter Instance Tabs for more information.
5. Add one or more services to the adapter instance by dragging a service icon from the palettes panel and dropping it in the design panel.
6. After configuring the adapter, create the runtime adapter property file and add the project name and the adapter instance name.Multithreading allows the adapter to process multiple messages concurrently to ensure better performance. TIBCO ActiveMatrix Adapter for Tuxedo supports multithreading for the publication, subscription, request-response invocation, and synchronous request-response services. Multithreading is not supported for asynchronous request-response services.You can configure the number of threads for each session in the Multithreading tab at instance level. By default, only one thread is available for the adapter instance. There are no dispatchers for the individual sessions. For high volume messaging environments, you can improve the performance by spawning the dispatchers (threads) for individual sessions. The number of dispatchers depends on how Tuxedo responds to the dispatchers and the machine on which Tuxedo runs. While configuring the adapter services, ensure that both inbound (subscription or request-response) and outbound (publication and request-response invocation) services are not configured under the same session. See MultiThreading Tab for more information.TIBCO ActiveMatrix Adapter for Tuxedo enables multiple connections to interface with the Tuxedo application. This feature is supported only by the Tuxedo application version 7.1 or higher. Every thread creates its own connection with the Tuxedo application, allowing one to one association between threads and connections. The thread maintains this connection throughout the lifetime of the adapter till the connection is lost with the Tuxedo application.If the adapter has to establish multiple connections with the Tuxedo server, you need to modify the default server settings. For details on modifying the server settings, see Create Tuxedo Configuration Files.When configuring multithreading for the publication and request-response invocation services, you should note the following situations:
• For the publication service, when the Event-based, Queue-based, or Rendezvous Adapter Agent-based communication paradigms is used, only the number of threads configured in the DefaultRVSession session is valid. When the communication is based on JMS adapter agent, the number of the threads configured in the DefaultJmsTopicSession or DefaultJmsQueueSession session is valid.
• For the request-response invocation service, when the communication is based on the Rendezvous adapter agent, only the number of threads configured in the DefaultRVSession session is valid.An application or connection error may cause a loss of the connection between TIBCO ActiveMatrix Adapter for Tuxedo and Tuxedo application.
• If the loss is caused by a connection error, the adapter will attempt to reconnect to the Tuxedo application. The maximum number of reconnect attempts can be specified.You can specify the parameters for connection management in the Run-time Connection Tab at the instance level.See TIBCO ActiveMatrix Adapter for Tuxedo Concepts for an introduction to internationalization and how adapters handle it. See General Tab for setting encoding options for an adapter instance.Before running the TIBCO ActiveMatrix Adapter for Tuxedo in Unicode mode, you must perform the following steps:
1. Make sure that the appropriate locales exist and are valid on your operating system. To verify, do the following.
2. Copy the locale files for the relevant code page to the appropriate directory. For Microsoft Windows, the directory is WINDOWS\system32.
3. When configuring an adapter, specify the locale in the Adapter Encoding drop-down list in the General tab for the adapter instance. If the locale is not specified correctly, the adapter will not process the character data correctly.
− For Microsoft Windows, an input locale must exist on the operating system and the correct code page file must exist in the \WINDOWS\system32 directory. To view the set of possible input locales, refer to the Regional Setting Properties available from the Control Panel.
− For Solaris 8, verify locale files in the /usr/lib/locale directory.Configuration information for an adapter and all other parameter settings related to the adapter are saved as a project. At any time while configuring the adapter, you can save the associated project. Each time you save a project, any configuration information you have entered is saved as a project.For detailed steps and more information about exporting or importing projects to different formats (such as .dat), see the TIBCO Designer User’s Guide.You can use the Adapter Tester to verify that an adapter instance is configured correctly. The tester is invoked from the TIBCO Designer Tools menu and is documented in TIBCO Designer Palette Reference.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |