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


Chapter 16 Call Level Interface Functions : Modifying Transactional Characteristics

Modifying Transactional Characteristics
Calling Parameters
Your client program can modify transactional characteristics by specifying the characteristics, for example UPDATE, as transaction parameters to the STARTTR operation. All other parameters, except RETURN-DATA and RETURN-CODE, are null.
What are the Transactional Characteristics?
The transactional characteristics are:
SEARCH=path
path can be one of S, I, or L, using the variable string notation (the length is one).
LIBRARY=libraryname
libraryname can be the name of a local library accessible to the TIBCO Object Service Broker user ID of the session, using the variable string notation (the maximum length is eight).
These are also session parameters. Refer to Parameters for Your Session for more information.
When Can the Modifications Be Made?
The transactional characteristics of a stream can be specified only when a transaction is started.
What is the Inheritance of Transactional Characteristics?
A stream inherits the values of the transactional characteristics from its parent. When the stream is the first stream in the session, the transactional characteristics are inherited from the session. In all other cases, the parent is the transaction at the lower transaction nesting level.
Sample Calls
COBOL Call
The following COBOL call sets the transactional characteristic defined in HRN-TRANPARM:

 
COPY HRNHLWAC
COPY HRNHLIST
.
01 HRN-TRANPARM.
05 TRANPARMLEN PIC9(4) USAGE COMP-4 VALUE 36
05 TRANPARMDAT PIC x(36)
VALUE 'LIBRAY=TEST1,UPDATE,SEARCH=L,NOTEST
.
CALL 'HRNHLLTM' USING HRNHLLWA 'STARTTR'
HRN-NULL-LIST HRN-TRANPARM HRN-NULL-LIST HRN-NULL-LIST
HRN-RETURN-DATA HRN-RETURN-CODE.
.

 
Non Re-entrant Assembler Call

 
.
CALL HRNHLLTM,(HRNHLLWA,C'STARTTR', X
0,TRANPARM,0,0,DATA,CODE),VL
.
.
PARM DC AL2(36),C'LIBRARY=TEST1,UPDATE,SEARCH=L,NOTEST'
* TRANSACTION START LIST
DATA DS REASON CODE FROM HRNHLLTM
CODE DS F RETURN CODE FROM HRNHLLTM
.

 
Returned Values
 
Return Codes

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