XML request processing

Stabilized feature: Service Flow Runtime and Service Flow Modeler capability in IBM Developer for z/OS 14.2.3 are stabilized. Consider exposing and orchestrating applications as API services by using z/OS Connect Enterprise Edition or CICS® web services, or by writing web applications in Java or Node.js. See also Stabilization notices and discontinued functions.

At run time, the CICS SFR interface program DFHMADPL initiates XML request processing.

When DFHMADPL determines that the request message header is in XML, the following processing occurs:
  1. DFHMADPL issues a call to the XML to COBOL Converter program DFHMAXMI.
  2. The program DFHMAXMI converts the header data from XML into a COBOL header format.

    DFHMAXMI saves the XML declaration portion of the XML and passes it back to DFHMADPL. This information is used for XML response processing.

    DFHMAXMI reports any errors it encounters to the CICS system log using the message identifier of IGZ0280S. The CICS error information is returned to the service requester.

  3. If the application data portion of the request message is also XML, DFHMADPL reads the service flow properties file for the name of a user-defined application data XML converter program that converts XML data into the COBOL data structure. This converter program is defined in the model of the service flow and is saved in the service flow properties file.

If the properties of the service flow do not include a value for an XML converter program, the application data in the request message is not converted.

If the program call issued by DFHMADPL to the user-defined converter program fails, CICS Service Flow Runtime returns an error message to the service requester.