Responses and reason codes

Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.
An analyzer program must return one of the following values in wbra_response:
Symbolic value Numeric value Explanation
URP_OK 0 The alias transaction is started.
URP_EXCEPTION 4 The alias transaction is not started. Web attach processing writes an exception trace entry (trace point 4510), and issues a message (DFHWB0523).

If the request is an HTTP request, an error response is sent to the Web client. The default status code is 400 (Bad request), and this can be configured using the user-replaceable Web error program DFHWBEP.

If the request is not an HTTP request, no response is sent, and the socket is closed.

URP_INVALID 8 The alias transaction is not started. The server controller writes an exception trace entry (trace point 4510), and issues a message (DFHWB0523).

If the request is an HTTP request, an error response is sent to the Web client. The default status code is 400 (Bad request), and this can be configured using the user-replaceable Web error program DFHWBEP.

If the request is not an HTTP request, no response is sent, and the socket is closed.

URP_DISASTER 12 The alias transaction is not started. CICS® writes an exception trace entry (trace point 4510), and issues a message (DFHWB0523).

If the request is an HTTP request, an error response is sent to the Web client. The default status code is 400 (Bad request), and this can be configured using the user-replaceable Web error program DFHWBEP.

If the request is not an HTTP request, no response is sent, and the socket is closed.

If you return any other value in wbra_response, the server controller writes an exception trace entry (trace point 4510), and issues a message (DFHWB0523). If the request is an HTTP request, a message with status code 400 (Bad request) is sent to the Web client. If the request is not an HTTP request, no response is sent, and the socket is closed.

You may supply a 32-bit reason code in wbra_reason to provide further information in error cases. CICS Web support does not take any action on the reason code returned by an analyzer program, but the user-replaceable Web error program DFHWBEP can use it to decide how to modify the default response. The reason code is output in any trace entry that results from the invocation of an analyzer program, and in message DFHWB0523.