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


Chapter 14 Introduction to the Call Level Interface : Call Level Interface Specification

Call Level Interface Specification
What Is the Module to Call?
You access all facilities of the Call Level Interface by calling the module HRNHLLTM. HRNHLLTM requires eight standard parameters, described in HRNHLLTM Module Parameters. Additional parameters are optional, and are used to convey exit information for advanced applications (refer to Chapter 17, Multiple-Session Execution Environments in Batch).
Standard operating system parameter passing and linkage conventions are used. HRNHLLTM is link-edited with the calling application program. Refer to the sample members COBCOLNK in the JCL data set distributed with TIBCO Object Service Broker for an example link-edit of a user client program with the Call Level Interface modules.
Example CALL Formats
COBOL Example
CALL 'HRNHLLTM' USING HRNHLLWA HRN-HRN-OPERATION HRN-OPERAND
HRN-PARM HRN-DATA-IN HRN-DATA-OUT HRN-RETURN-DATA HRN-RETURN-CODE.
Assembler Example
CALL HRNHLLTM,(HRNHLLWA,OPERATION,OPERAND,PARM,DATA-IN,
DATA-OUT,RETURN-DATA,RETURN-CODE),VL,MF=(E,CALLLIST)
Required Parameters
Every call to HRNHLLTM must provide a valid:
Depending on the Call Level Interface function, the other parameters are ignored.
Usage of the Parameters
The call parameters passed into HRNHLLTM are used to:
Communicate data between the client and TIBCO Object Service Broker (PARM, DATA-IN, DATA-OUT, RETURN-DATA, and RETURN-CODE)
Parameter Types
Parameters are of type IN, OUT, or IN/OUT. Storage for all parameters must be allocated by the client program.
NULL Parameters
Some Call Level Interface functions require a NULL call parameter. In this case, a dummy value must be coded in that position. The value of the dummy parameter is ignored.

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