OTMA destination descriptors

You can instruct an IMS application to route callout requests to services accessible to the IMS TM resource adapter without having to code assembler routing exits by using the OTMA destination descriptors.

You can define an IMS Connect destination (a transaction pipe, or tpipe) to where the IMS callout request messages are routed by using the OTMA destination descriptor. If no special routing is required, the tpipe name for the callout request can be specified directly in the ICAL call (for synchronous callout) or ISRT ALTPCB call (for asynchronous callout) in the IMS application.

To use the OTMA destination descriptor, your IMS system programmer must configure the descriptor in the DFSYDTx PROCLIB member. The following example demonstrates a descriptor for a destination named IMSTMRA that will route messages to the target member named HWS1 and a tpipe named HWS1TP01.

D IMSTMRA TYPE=IMSCON TMEMBER=HWS1 TPIPE=HWS1TP01

An OTMA destination descriptor is required for routing synchronous callout requests, but not required for routing asynchronous callout requests. However, the use of the OTMA destination descriptor for asynchronous callout requests is preferred because the descriptor approach is easier to use than the OTMA exit routines approach.

For more information, see the topic "OTMA descriptors" in IMS Communications and Connections information, and the DFSYDTx PROCLIB member in IMS System Definition information.