Output parameters for converter program decode function
Attention: This topic contains Product-sensitive
Programming Interface and Associated Guidance Information.
The
decode function must provide the following outputs in a COMMAREA: a response
code, and the address and length of the COMMAREA.
- A response code (optionally qualified by a reason code).
If the decode function returns a response code of URP_OK, processing continues with the next step.
If the decode function returns any other value, the HTTP request is rejected with an error response. For details of the response made by CICS in this situation, see CICS web support default status codes and error responses.
- The address and length of the COMMAREA passed to the user-written application program. If no application program is called, the COMMAREA is passed unchanged to the encode function.
The decode function may also provide the following outputs:
- The name of the user-written application program that is to provide data for the request. If the analyzer program supplied a name, the converter program can change it, or specify that no application program should be called.
- An eight byte user token, used to share information between the analyzer and converter programs. See Sharing data between analyzer and converter programs.