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


Chapter 16 Call Level Interface Functions : Starting the Session – STARTSS

Starting the Session – STARTSS
Syntax
For the syntax of all Call Level Interface functions, see Call Level Interface Specification and HRNHLLTM Module Parameters.
Calling Parameters
After an Execution Environment is started or located, your client program starts the session by specifying STARTSS as the OPERATION parameter. The OPERAND parameter is ignored. Overrides to the session parameters are supplied through the variable length PARM parameter.
Sample Calls
COBOL Call

 
.
COPY HRNHLWAC
COPY HRNHLIST
.
.
CALL 'HRNHLLTM' USING HRNHLLWA 'STARTSS'
HRN-NULL-LIST HRN-SESSPARM HRN-NULL-LIST HRN-NULL-LIST
HRN-RETURN-DATA HRN-RETURN-CODE.
.

 
Non Re-entrant Assembler Call

 
.
CALL HRNHLLTM,(HRNHLLWA,C'STARTSS', X
0,PARM,0,0,DATA,CODE),VL
.
.
PARM DC AL2(15),C'U=UUUUU,P=PPPPP'
DATA DS L159 REASON CODE FROM HRNHLLTM
CODE DS F RETURN CODE FROM HRNHLLTM
.

 
Returned Values
 
Return Codes
STARTSS request succeeded. The first eight bytes of the RETURN-DATA parameter are set to the name of the TIBCO Object Service Broker user ID (in the assembler example, it is set to ‘UUUUU’).
Advanced STARTSS BATCH Usage
To interface with certain kinds of third-party environments, you can create a multi-session non-blocking batch Execution Environment by specifying an environmental wait routine specific to the third-party environment. Using the assembler interface, you can pass the address of a session context work area to the environmental wait routine by specifying an exit descriptor as the ninth parameter to HRNHLLTM. The exit descriptor is mapped by the assembler DSECT called HRNXD and distributed in the MACRO data set. It is of type SESHANDL.
Additional Information
For an example of setting up an environmental wait routine, refer to “Driver for testing Call Level Interface in Batch or TSO (Assembler)” in the member S6BCAPID in the ASM data set distributed with TIBCO Object Service Broker. For a complete description of this facility, refer to Chapter 17, Multiple-Session Execution Environments in Batch.

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