Samples for the callout function

The IVP sets up an environment in its system definition and provides samples in assembly, Java™, and COBOL languages, and two related XML converters, for the asynchronous and synchronous callout functions. These samples demonstrate how an IMS application can send outbound messages to request services or data from an external web service or Java applications, and, optionally, receive responses in either the same or a different transaction.

The samples are provided in the S series of jobs and tasks, with introduction information in IV_S001T.

Parts DFSACALO and DFSSCALO provide user-supplied IMS Connect client application samples in assembly language. Compile and bind the samples by running the job IV_E206J. Run job IV_S222J to start the asynchronous sample and job IV_S225J to start the synchronous sample.

Two Java samples, available in parts DFSJASMP and DFSJSSMP, provide sample user-supplied IMS Connect client applications in Java for the asynchronous and synchronous callout functions. These samples can run on either distributed or z/OS® platforms.

Two COBOL samples, available in parts DFSASCBL and DFSSSCBL, demonstrate the asynchronous and synchronous callout functions as supported by the IMS TM resource adapter. DFSASCBL is located in the SDFSISRC data set. Compile and bind the samples before running the samples through job IV_S227J (for asynchronous) and job IV_S228J (for synchronous).

Two XML converters, DFSACCBL and DFSSCCBL, are provided when the callout requests are routed through the IMS Enterprise Suite SOAP Gateway. DFSACCBL is located in the SDFSISRC data set. Compile and bind the samples before running the samples through job IV_S230J (for asynchronous) and job IV_S231J (for synchronous).

The web service or Java applications that these samples call out to can be downloaded from the IMS TM Resource Adapter and IMS Enterprise Suite SOAP Gateway web pages. Each sample package contains detailed instructions.