Start of change

Web error program

When a request error or an abend occurs in the CICS® Web support process, a user-replaceable Web error program provides an error response to the Web client.

Attention: This topic contains Product-sensitive Programming Interface and Associated Guidance Information.
A Web error program is used in the following situations:
A Web error program is not used in the following situations:

If there is a persistent connection with the client, CICS keeps the connection open after an error response is sent through a Web error program. The exception is where CICS selects the 501 (Method Not Implemented) status code for the response, in which case the connection is closed by CICS.

Two user-replaceable Web error programs are provided with CICS:
DFHWBERX (Web error application program)
DFHWBERX can be specified as an application program to handle a request, by an analyzer program or in a URIMAP definition. It is used when the CICS-supplied default analyzer DFHWBAAX is specified as the analyzer program on the TCPIPSERVICE definition, and no matching URIMAP definition is found for a request. The EXEC CICS WEB and DOCUMENT application programming interfaces are available from DFHWBERX. It uses the EXEC CICS commands to obtain information about the Web client's request and create and send the error response.
DFHWBEP (Web error program)
DFHWBEP is used in all other situations where a Web error program is required, that is, when CICS detects an error in request processing. Start of changeCICS provides DFHWBEP with a parameter list giving information about the error situation, and a default error response in a block of storage. DFHWBEP can use the EXEC CICS WEB and DOCUMENT API commands to create its own error response and send it to the Web client, or it can amend or accept the default error response provided by CICS.End of change

For more information about writing user-replaceable programs, see the CICS Customization Guide.

End of change