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


Chapter 17 Multiple-Session Execution Environments in Batch : STARTSS Call

STARTSS Call
Purpose of STARTSS
You can use the Exit Descriptor in the STARTSS call to pass additional information to the environmental wait routine you specified in the STARTEE call. This additional information varies for each type of TP monitor or multiple-session environment you are implementing. As a guideline, it is likely a copy of your original save area upon entry to your client application, or some other control block that is required by the TP monitor to re-establish its environment prior to executing its own version of a wait macro.
Behavior in the Sample Programs
In the sample programs provided with TIBCO Object Service Broker, CICS is used as the TP monitor, even though a native interface exists for a CICS environment, that is, the OPERAND parameter is set to BATCH, not CICS on the STARTEE call.
In this particular environment CICS has a Control Block mapped in assembler by the DFHEISTG macro. This is the first-level save area for a user program. It also contains important pointers to other control blocks that CICS requires when you issue a CICS request (Command Level Call). In the sample, it is a copy of this Control Block that is to be passed to the environmental wait routine.
Explanation of the Possible Values
 
Indicates the environmental wait routine is to be implemented.
user program name
The address stored in this field is passed to the environmental wait routine in Register 0 (zero), when it is called.
It should be a Control Block that you use to re-establish the environment of the calling client program.

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