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


Chapter 14 Introduction to the Call Level Interface : Aspects of the Call Level Interface

Aspects of the Call Level Interface
Purpose of the Call Level Interface
The Call Level Interface provides facilities that you can code into client programs written in a third-generation language (3GL) to access a TIBCO Object Service Broker that is running in the same environment. These client programs can be running in batch, TSO, or CICS environments. Using these facilities, you can:
TIBCO Object Service Broker Software Development Kits (SDKs)
If your external program resides in a different address space from the TIBCO Object Service Broker it is accessing, you must use one of the TIBCO Object Service Broker SDKs. For more information:
External Environment
C programs,
C++ programs
SDK (C/C++)
SDK (Java)
Supported Functionality
With the Call Level Interface, you can:
Call a rule, commit or roll back table changes, and perform table access using the HLI or SQL preprocessor interface within a started transaction
All these functions provide feedback indicating the success of the operation in the form of a return code, a reason code, or a message.
Supported Connections
The Call Level Interface supports connections to the Execution Environment within the same address space (batch, TSO, or CICS environments). The interface is supported via standard z/OS calling conventions.
Shared Addressing
The user client routine can share an address space with the Execution Environment and the session. As a consequence, by using the MAP table interface:
Rules are able to address common storage of the 3GL programs, if the addresses are passed to TIBCO Object Service Broker.
Registered storage explicitly obtained by the rule as part of processing, or as data access triggered execution, are addressable by the 3GL program.
See Also
TIBCO Service Gateway for Files Installing and Operating about MAP tables.
TIBCO Object Service Broker Programming in Rules for information on rules.
Accessing Table Data Using the Host Languages Interface
If your client program is a COBOL program, you can embed TIBCO Object Service Broker access statements or SQL statements as outlined in Chapter 18, TIBCO Object Service Broker SDK (C/C++) Server to Chapter 20, Using TIBCO Object Service Broker SDK (Java).
 
Illustration of Generic User Client Using Call Level Interface
The following illustration shows how a generic user client uses the Call Level Interface:

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