Programming CICS transactions in the distributed environment

 

CICS DPL programs and transactions can be driven through the CICS bridge when the client application resides on a workstation.

The main consideration when programming for the distributed environment is data conversion between the different encoding schemes and CCSID values of the workstation and z/OS™. Conversion is carried out by two different routines, one for the MQCIH structure and another for the vector.

We can ensure that the MQCIH is converted by specifying MQFMT_CICS in the MQMD.Format field. Vector conversion, however, requires a little more consideration.

To convert the SEND MAP and RECEIVE MAP vectors, do the following:

• Make sure that you assemble your maps specifying DSECT=ADSDL in your DFHMSD macro. Your map must be assembled under CICS Transaction Server for OS/390 V1.2 or greater for the ADSD or ADSDL to be made available. If you do not have the original mapset definition, re-create the map using the CICS DFHBMSUP utility.

• Specify a value of MQCADSD_SEND+MQCADSD_MSGFORMAT in field MQCIH.ADSDescriptor. If you are using an ADSD or ADSDL to build your RECEIVE MAP ADS, add in the value MQCADSD_RECV for this field.

• Specify a value of CSQCBDCI in field MQCIH.Format on every inbound message.

• Ensure that CONVERT=YES is specified on the channel between z/OS and the workstation.

No support is provided for conversion between workstation and mainframe formats of vectors other than SEND MAP (outbound) and RECEIVE MAP (both inbound and outbound).

 

Parent topic:

3270 applications

fg15670_