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


Chapter 8 Using the TIBCO Service Gateway for IMS TM : Passing Data to TIBCO Object Service Broker IMS TM Sessions

Passing Data to TIBCO Object Service Broker IMS TM Sessions
Depending on the seamless/non-seamless and conversational/non-conversational style of the client, at session start your rules can read or write up to three message segments. The rules can use MAP tables or the $GETENVCOMMAREA and $SETENVCOMMAREA tools. The message segments are the SPA, the session parameter string segment, and the data segment. Every client sends the data segment to the session.
Using MAP Tables to Access Data
MAP tables are a convenient means of accessing the message segments that are passed to the session and returned by it. Use the System Interpreted Table @SESSION to obtain and manipulate the pointers to the message segments.
You can access the three input and output message segments by using the memory pointers:
@SESSION.SEGnINHANDLE
@SESSION.SEGnOUTHANDLE
where n is the segment number 0, 1, or 2. Segment 0 corresponds to the SPA, and is valid only for conversational style clients. The lengths of these message segments are in @SESSION.SEGnINLENGTH and @SESSION.SEGnOUTLENGTH.
MAP tables support FORALL, GET, and REPLACE statements. All MAP tables are parameterized by a memory address that you use to position your MAP table access to any location within the message segment.
Using the $GETENVCOMMAREA Tool to Access Data
$GETENVCOMMAREA returns all the message segment as a syntax V string, including the llzz or llzzzz components. The maximum length of the returned string is 31K. To avoid local variable storage overflow, consider increasing the values of the session parameters EXECLOCALSIZE and EXECSTACKSIZE. Setting each of these to 128K is usually more than sufficient.
The syntax is:
value = $GETENVCOMMAREA(segment#);
See Also
TIBCO Object Service Broker Managing Data about MAP tables.
TIBCO Object Service Broker Shareable Tools about the tools and System Interpreted Tables.
TIBCO Object Service Broker Parameters about parameters.

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