Calling more than one CICS® application program

Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.
Sometimes, the data you need to construct the response to an HTTP request comes from more than one application program. If this is the case, you can repeat the following sequence as necessary:
  • The converter's decode function
  • The application program
  • The converter's encode function
Do this by setting the response to URP_OK_LOOP in the encode function. When the HTTP response is complete, set the response to URP_OK.
When the decode function is called on the second and subsequent occasions, the following input parameters are not available:
  • The HTTP version
  • The method
  • The path component of the URL
  • The request headers
  • The entity body
However, you can use a WEB EXTRACT command to retrieve the same information.

Use the user_data pointer and the user token to share data between the decode and encode functions — see Sharing data between analyzer and converter programs for more information. When the encode function is called for the last time, you must make sure that the user_data pointer addresses a valid HTTP response — see Output parameters for the encode function for more information.