Local environment overrides for the CICSRequest node

When you use the CICSRequest node in a message flow, you can override some of its properties with elements in the message tree.

You can dynamically override values, on a per message basis, in the local environment. You can override the CICS® Transaction Server for z/OS® program that you are calling, the COMMAREA length, mirror transactions, and the processing of the response message.

You can set the following values under LocalEnvironment.Destination.CICS.
Setting Description
CICSProgramName Overrides the Program name property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.CICSProgramName = 'progx';
You can override the location of this value by using a property on the CICSRequest node.
CICSCommareaLen Overrides the Commarea length property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.CICSCommareaLen = 100;
mirrorTran Overrides the Mirror transaction ID property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.mirrorTran = 'ATRN';
eibtrnidOnly Overrides the Set EIBTRNID only property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.eibtrnidOnly = 'TRUE';

Valid values are TRUE, FALSE, YES, or NO. Where TRUE or YES represents a selected check box for the Set EIBTRNID only property in the IBM® App Connect Enterprise Toolkit. Where FALSE or NO represents a cleared check box in the IBM App Connect Enterprise Toolkit.

You can set the following values under LocalEnvironment.Destination.CICS.Response.
Setting Description
messageDomain Overrides the Message domain property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageDomain = 'MRM';
messageSet Overrides the Message set property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageSet = '{com.test}:MyMessageSet';
messageType Overrides the Message type property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageType = 'messageA';
messageFormat Overrides the Message format property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageFormat = 'XML1';
messageCCSID Overrides the Message coded character set ID property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageCCSID = 500;
messageEncoding Overrides the Message encoding property on the node; for example:
SET OutputLocalEnvironment.Destination.CICS.Response.messageEncoding = 785;

You can also set LocalEnvironment values for CICS channels and containers. For more information, see COMMAREA or channel data structures.