CICS® supplies
a default analyzer program, DFHWBAAX. DFHWBAAX provides an error handling
function for TCPIPSERVICE resource definitions that are used for CICS Web support.
It is suitable for use when all of the requests using a port are handled using
URIMAP definitions.
Attention: This topic contains Product-sensitive Programming Interface
and Associated Guidance Information.
CICS supplies
the source code for DFHWBAAX in Assembler only.
DFHWBAAX is the default analyzer program for a TCPIPSERVICE definition
that specifies PROTOCOL(HTTP).
DFHWBAAX receives the same input and output parameters as a standard analyzer
program, in a COMMAREA. As supplied, it does not make use of most of these
parameters, and it does not provide support for requests using the URL format
that CICS Web
support used before CICS TS 3.1. Instead, it takes simplified action as
follows:
- DFHWBAAX does not carry out further processing when a matching URIMAP
definition has been found for the request, even if the URIMAP specifies ANALYZER(YES).
It uses the wbra_urimap input parameter to test for the presence
of a URIMAP definition, and if the result is positive, returns without performing
any analysis on the request URL. This means that the settings specified in
the URIMAP definition for the alias transaction, converter program (if used),
and application program are automatically accepted and used to
determine subsequent processing stages.
- If no matching URIMAP definition is found, DFHWBAAX gives control to the
user-replaceable Web error transaction program DFHWBERX to produce an error
response. This is achieved by setting DFHWBERX as the application program
to handle the request, using the wbra_server_program output
parameter. DFHWBAAX does not make any other changes to the COMMAREA. On receiving
control, DFHWBERX provides either an HTTP response with a 404 (Not Found)
status code, or a SOAP fault response, depending on the request made by the
Web client.
DFHWBAAX uses a standard range of responses, URP_OK, URP_EXCEPTION,
and URP_INVALID. No reason values are architected for
DFHWBAAX as supplied. Note that if the response is other than URP_OK,
this indicates an error in processing, and control is passed to the user-replaceable
Web error program DFHWBEP, rather than the Web error application program DFHWBERX.