IMS 15.5 - Release planning - OTMA transaction orchestration

After an IMS Connect client submits a CM0 send-receive transaction request to IMS, the IMS Connect client waits for a response from IMS. IMS transaction A processes the request and performs an asynchronous callout via ALTPCB to an external processing system for a response. When the external processing system sends a response back to IMS via an OTMA client, IMS cannot route that response back to the waiting IMS Connect client because IMS OTMA has no way of identifying that the response from the external service is what the original IMS Connect client is looking for.

This transaction orchestration enhancement provides a remedy. If the new transaction orchestration function is activated for the original CM0 send-receive message, the response from the external processing system can be routed back to the waiting IMS Connect client.

On IMS 15.3 or later, the OTMA client descriptor can activate the OTMA transaction orchestration function after you apply PTFs UI96091 and UI96138 for APAR PH51897. To activate the OTMA transaction orchestration function, specify TRANORCH=YES in the OTMA client descriptor. To learn more, see OTMA transaction orchestration using asynchronous callout.

IMS Connect can also activate or deactivate this function. To enable this option for IMS Connect, apply PTF UI98354 for APAR PH57295 on IMS 15.3 or later.

On IMS 15.3 or later, make sure to apply PTF UO04689 for APAR PH65775 to support the multiple callout scenario when you want IMS to send multiple asynchronous callout messages with callout correlator token to the external systems.

Log record changes

There are no new or changed log records related to this enhancement.

Requirements

This enhancement has requirements. To learn more, see OTMA transaction orchestration using asynchronous callout.

Restrictions

This enhancement has restrictions. To learn more, see OTMA transaction orchestration using asynchronous callout.

Changes to installing and defining IMS

This enhancement includes changes to IMS installation and definition. To learn more, see the following topics.

Changes to administering IMS

To learn about IMS administration changes for this enhancement, see OTMA transaction orchestration using asynchronous callout.

Changes to programming for IMS

This enhancement updates INQY call MSGINFO data output. To learn more, see INQY call.

Changes to troubleshooting for IMS

New or changed messages and codes are listed in Table 1.

For a complete list of new, changed, and deleted messages and abend codes in IMS 15.5, see Message and code changes in IMS 15.5.

Changes to commands

For a list of the commands that are new or changed for this enhancement see the IMS commands row in Table 1.

Changes to exit routines

This enhancement includes changes to the OTMA User Data Formatting exit routine (DFSYDRU0). To learn more, see OTMA User Data Formatting exit routine (DFSYDRU0).

Changes to utilities

There are no changes to utilities related to this enhancement.

Documentation changes

The following table lists the publications that contain new or changed topics for the OTMA transaction orchestration enhancement.

Table 1. Links to topics that have new or changed content for this enhancement
Publication	New or changed topics
Release planning	General planning information for IMS 15.5 Command changes in IMS 15.5 New messages and codes for IMS 15.5 Changed messages and codes for IMS 15.5 IMS 15.5 enhancements IMS 15.5 Transaction Manager continuous delivery functions OTMA transaction orchestration enhancement (new) (this topic)
System definition	OTMA client descriptor syntax and parameters OTMA destination descriptor syntax and parameters DATASTORE statement HWS statement
Communications and connections	OTMA transaction orchestration using asynchronous callout Message-control information section Server-Available and Client-Bid commands Transaction and callout messages Resume output for the hold queue for tpipe
Application programming APIs	INQY call
IMS messages and codes	DFS messages DFS2385E DFS9127I
IMS commands	Command changes relevant to PH51897 CREATE OTMADESC command /DISPLAY OTMA command /DISPLAY TMEMBER command QUERY OTMADESC command UPDATE OTMADESC command Command changes relevant to PH57295 CREATE IMSCON TYPE(DATASTORE) command QUERY IMSCON TYPE(CONFIG) command QUERY IMSCON TYPE(DATASTORE) command UPDATE IMSCON TYPE(CONFIG) command UPDATE IMSCON TYPE(DATASTORE) command VIEWDS command VIEWHWS command
Exit routines	OTMA User Data Formatting exit routine (DFSYDRU0)