Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 12 Using the Interface to TIBCO Enterprise Message Service : Configuration

Configuration
Initializing the EMS Interface
The Execution Environment establishes a special LE Enclave to run EMS calls and Execution Environment parameters exist to manage the environment. The TASKPOSIXNUM Execution Environment parameter determines if the enclave is started. By default the parameter is set to 0 and the LE Enclave is not started.
To enable EMS support for the Execution Environment set the TASKPOSIXNUM parameter to 1. The first call to EMS by a rule initializes the environment to run EMS and loads code related to invoking EMS.
Multi-threaded Environment
The LE Enclave used to run EMS calls is a multi-threaded USS environment. A thread is used to call EMS for any blocking call. Examples of such calls are tibemsConnection_Create and tibemsMsgConsumer_Receive.
Thread Processing
The THREADPOSIXNUM Execution Environment parameter defines the number of threads that will be started to handle blocking EMS calls. In effect it controls the number of concurrent EMS requests for an Execution Environment. If a thread is not available for an EMS call from a rule then the request is put on a wait queue until a thread is available. While a rule is waiting for an EMS call to complete, unless the session holds external resources, no Execution Environment interpreter tasks are blocked. The waiting session is rescheduled for execution when EMS completes the request.
Code Page Support
TIBCO Object Service Broker uses a single EBCDIC code page as defined in the @NLS1 table. Non-unicode text data is stored in this code page in the Data Object Broker table store. By default this code page is set to IBM-037. The host code page is automatically set to that specified in the @NLS1 table when EMS support in the Execution Environment is initialized.
The wire code page for EMS can be set using the EMSWIRECODEPAGE Execution Environment parameter (default is ISO8859-1). The wire code page is the same for all sessions running under an Execution Environment.
See Also
TIBCO Object Service Broker Parameters for more information about the TASKPOSIXNUM, THREADPOSIXNUM, and EMSWIRECODEPAGE Execution Environment parameters.
TIBCO Object Service Broker National Language Support for more information on code pages and the @NLS1 table.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved