Handling POST requests for Atom collections
When a web client makes a POST request for an Atom collection, your service routine must create the new entry in the collection and return a copy of it to the client.
About this task
The web client supplies a complete Atom entry document in the body of their HTTP POST request, and CICS passes this request body to the service routine in the DFHREQUEST container.
If the resource that holds the data for your Atom entries has an XML binding with an associated XMLTRANSFORM resource, you can use the CICS functions for transforming XML into application data to parse the markup of the Atom entry document that the web client supplies. If an XMLTRANSFORM resource is available, CICS provides its name in the ATMP_XMLTRANSFORM parameter in the DFHATOMPARMS container. For more information about the TRANSFORM XMLTODATA command and instructions for using the data mapping functions, see Mapping and transforming application data and XML.
- If your program is written in C or Assembler, you can use the z/OS XML System Services parser to parse the markup of the entry.
- If your program is written in Enterprise COBOL, use the XML PARSE verb, as in the DFH0W2F1 COBOL sample service routine.
- If your program is written in Enterprise PL/I, use the PLISAXA library function.