![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
CICS Channels and Containers in the TIBCO Object Service Broker CICS Session Environment
• TIBCO Service Gateway for CICS provides a set of tools for handling CICS Channels and containers. See the following table for the tools along with the equivalent CICS API commands.
EXEC CICS ASSIGN CHANNEL(data-area) $SHOWCHANNEL(channel_name) $SETCHANNEL(channel_name) For a detailed description of the tools, refer to the TIBCO Object Service Broker Shareable Tools manual. For general information and the rules that govern the scope of channels, see the CICS Transaction Server for z/OS CICS Application Programming Guide.
Returns the 16-character name of the session’s current channel if one exists. Otherwise, returns blanks. Lists the16-character container names and displays the count of the containers associated with the channel. This tool combines the functions of the following CICS API commands: Moves a container and its contents from one channel to another. Afterwards, the source container no longer exists. Nominates a channel for passing to a CICS routine when called in a rule or for passing to a program or transaction through the SESSIONEND action. A blank channel name cancels any previously nominated channel.
• Conversational mode (CICSPSEUDOCONVERSE=N) — In this mode, the entire session is considered one program because no EXEC CICS RETURN command is issued until at the end of the session. Therefore, the Current Channel, if one exists, and the Channels created during the session are available throughout the session.
• Pseudo-conversational mode (CICSPSEUDOCONVERSE=Y) — In this mode, a screen display results in EXEC CICS RETURN with TRANSID and a CHANNEL option. Therefore, the Current Channel, if one exists, is passed on to the next leg of the pseudo-conversation. However, the Channels created during the session are not passed and are hence out of scope.You can configure both modes with the Execution Environment parameter CICSPSEUDOCONVERSE=Y | N.Two Execution Environment parameters name the container for passing the session parameter to a TIBCO Object Service Broker session and for returning the error messages that are generated by the session, as follows:
• CICSPCONTAINER — This container passes the session parameter to an Object Service Broker session for startup. The default name is PARMCONTAINER.
• CICSECONTAINER — This container enables the Object Service Broker session to return error messages to the invoker of the session. The default name is HERRCONTAINER.For details, see the TIBCO Object Service Broker Parameters manual. You can pass user data to and from the session in separate containers with names of your choice.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |