Start of change

URIMAP definition statistics

This section contains the following statistics:

URIMAP definitions: Global statistics

These statistics can be accessed online using the EXEC CICS® EXTRACT STATISTICS URIMAP command, and are mapped by the DFHWBGDS DSECT. For programming information about the EXEC CICS EXTRACT STATISTICS command, see the CICS System Programming Reference manual.

Table 163. URIMAP definitions: Global statistics
DFHSTUP name Field name Description
URIMAP reference count WBG_URIMAP_REFERENCE_COUNT Number of times a search for a matching URIMAP definition was made.

Reset characteristic: reset to zero

 

Disabled WBG_URIMAP_MATCH_DISABLED

Number of times a URIMAP definition with a matching host and path was found, but the URIMAP definition was disabled.

Reset characteristic: reset to zero

 

Host/Path no match count WBG_URIMAP_NO_MATCH_COUNT Number of times a search for a matching URIMAP definition was made, but no URIMAP definition with a matching host and path was found.

Reset characteristic: reset to zero

 

Host/Path match count WBG_URIMAP_MATCH_COUNT

Number of times a search for a matching URIMAP definition was made, and a URIMAP definition with a matching host and path was found.

Reset characteristic: reset to zero

 

Redirected WBG_URIMAP_MATCH_REDIRECT

Number of times a URIMAP definition with a matching host and path was found, and the request was redirected.

Reset characteristic: reset to zero

 

Analyzer used WBG_URIMAP_MATCH_ANALYZER

Number of times a URIMAP definition with a matching host and path was found, and the analyzer program associated with the TCPIPSERVICE definition was called.

Reset characteristic: reset to zero

 

Static content delivered WBG_URIMAP_STATIC_CONTENT

Number of times a URIMAP definition with a matching host and path was found, and static content (document template or HFS file) was delivered as a response.

Reset characteristic: reset to zero

 

Dynamic content delivered WBG_URIMAP_DYNAMIC_CONTENT

Number of times a URIMAP definition with a matching host and path was found, and dynamic content (produced by an application program) was delivered as a response.

Reset characteristic: reset to zero

 

PIPELINE requests WBG_URIMAP_PIPELINE_REQS

Number of times a URIMAP definition with a matching host and path was found, and the request was handled by a Web service.

Reset characteristic: reset to zero

 

Scheme (HTTP) requests WBG_URIMAP_SCHEME_HTTP

Number of times a URIMAP definition with a matching host and path was found, and the scheme was HTTP.

Reset characteristic: reset to zero

 

Scheme (HTTPS) requests WBG_URIMAP_SCHEME_HTTPS

Number of times a URIMAP definition with a matching host and path was found, and the scheme was HTTPS (HTTP with SSL).

Reset characteristic: reset to zero

 

Virtual host disabled count WBG_HOST_DISABLED_COUNT

Number of times a URIMAP definition with a matching host and path was found, but the virtual host was disabled.

Reset characteristic: reset to zero

 

URIMAP definitions: Resource statistics

These statistics can be accessed online using the EXEC CICS EXTRACT STATISTICS URIMAP() command and are mapped by the DFHWBRDS DSECT. For programming information about the EXEC CICS EXTRACT STATISTICS command, see the CICS System Programming Reference manual.

The resource information gives details of various attribute settings of each URIMAP definition.

Table 164. URIMAP definitions: Resource statistics
DFHSTUP name Field name Description
URIMAP Name WBR_URIMAP_NAME is the name of the URIMAP definition.

Reset characteristic: not reset

 

URIMAP Usage WBR_URIMAP_USAGE

The intended use of this URIMAP:

SERVER
The URIMAP definition is used to locate the resources for CICS to produce an HTTP response to the request identified by HOST and PATH.
CLIENT
The URIMAP definition is used to specify information for making an HTTP request from CICS as an HTTP client.
PIPELINE
The URIMAP definition is used to locate the resources for CICS to produce an XML response to the request identified by HOST and PATH.

Reset characteristic: not reset

 

URIMAP Scheme WBR_URIMAP_SCHEME The scheme for the HTTP request, HTTP with SSL (HTTPS) or without (HTTP).

Reset characteristic: not reset

 

URIMAP Host WBR_URIMAP_HOSTNAME

For USAGE(CLIENT), the host name of the target URL to which the HTTP request is to be sent. For any other USAGE, the host name on the incoming HTTP request that is used to select this URIMAP definition.

Reset characteristic: not reset

 

URIMAP Path WBR_URIMAP_PATH

For USAGE(CLIENT), the path of the target URL to which the HTTP request is to be sent. For any other USAGE, the path on the incoming HTTP request that is used to select this URIMAP definition. The PATH may terminate in an asterisk, meaning that it is generic, and matches any path whose characters are the same up to but excluding the asterisk.

Reset characteristic: not reset

 

TCPIPSERVICE name WBR_URIMAP_TCPIPSERVICE

The TCPIPSERVICE to which this URIMAP definition applies. Only requests received on this TCPIPSERVICE are matched to this URIMAP definition. If no TCPIPSERVICE is specified, the URIMAP definition applies to all incoming HTTP requests.

Reset characteristic: not reset

 

WEBSERVICE name WBR_URIMAP_WEBSERVICE

The name of the WEBSERVICE resource definition for the Web service that handles the incoming HTTP request.

Reset characteristic: not reset

 

PIPELINE name WBR_URIMAP_PIPELINE

The name of the PIPELINE resource definition for the Web service that handles the incoming HTTP request.

Reset characteristic: not reset

 

Templatename WBR_URIMAP_TEMPLATENAME

The name of a CICS document template whose contents are returned as the HTTP response.

Reset characteristic: not reset

 

HFS File WBR_URIMAP_HFSFILE

The name of a file in the z/OS® UNIX System Services Hierarchical File System (HFS), whose contents are returned as the HTTP response.

Reset characteristic: not reset

 

Analyzer WBR_URIMAP_ANALYZER_USE

Whether or not the analyzer associated with the TCPIPSERVICE definition is called to process the request.

Reset characteristic: not reset

 

Converter WBR_URIMAP_CONVERTER

The name of a converter program that is used to transform the HTTP request into a form suitable for the application program specified in PROGRAM.

Reset characteristic: not reset

 

Transaction ID WBR_URIMAP_TRANS_ID

The name of the alias transaction that processes the incoming HTTP request.

Reset characteristic: not reset

 

Program name WBR_URIMAP_PROGRAM_NAME

The name of the application program that processes the incoming HTTP request.

Reset characteristic: not reset

 

Redirection type WBR_URIMAP_REDIRECT_TYPE

Whether or not matching requests should be redirected, on a temporary or permanent basis.

Reset characteristic: not reset

 

Location for redirection WBR_URIMAP_LOCATION

An alternate URL to which the Web client will be redirected, if redirection is specified.

Reset characteristic: not reset

 

URIMAP reference count WBR_URIMAP_REFERENCE_COUNT

Number of times this URIMAP definition was referenced.

Reset characteristic: reset to zero

 

Disabled WBR_URIMAP_MATCH_DISABLED

Number of times this host and path were matched, but the URIMAP definition was disabled.

Reset characteristic: reset to zero

 

Redirected WBR_URIMAP_MATCH_REDIRECT

Number of times this host and path were matched, and the request was redirected.

Reset characteristic: reset to zero

 

URIMAP definitions: Summary global statistics

Summary statistics are not available online.

Table 165. URIMAP definitions: Summary global statistics
DFHSTUP name Description
URIMAP reference count Number of times a search for a matching URIMAP definition was made.

 

Disabled

Number of times a URIMAP definition with a matching host and path was found, but the URIMAP definition was disabled.

 

Redirected

Number of times a URIMAP definition with a matching host and path was found, and the request was redirected.

 

Host/Path no match count Number of times a search for a matching URIMAP definition was made, but no URIMAP definition with a matching host and path was found.

 

Host/Path match count

Number of times a search for a matching URIMAP definition was made, and a URIMAP definition with a matching host and path was found.

 

Analyzer used

Number of times a URIMAP definition with a matching host and path was found, and the analyzer program associated with the TCPIPSERVICE definition was called.

 

Static content delivered

Number of times a URIMAP definition with a matching host and path was found, and static content (document template or HFS file) was delivered as a response.

 

Dynamic content delivered

Number of times a URIMAP definition with a matching host and path was found, and dynamic content (produced by an application program) was delivered as a response.

 

PIPELINE requests

Number of times a URIMAP definition with a matching host and path was found, and the request was handled by a Web service.

 

Scheme (HTTP) requests

Number of times a URIMAP definition with a matching host and path was found, and the scheme was HTTP.

 

Scheme (HTTPS) requests

Number of times a URIMAP definition with a matching host and path was found, and the scheme was HTTPS (HTTP with SSL).

 

Virtual host disabled count

Number of times a URIMAP definition with a matching host and path was found, but the virtual host was disabled.

 

URIMAP definitions: Summary resource statistics

Summary statistics are not available online.

The resource information gives details of various attribute settings of each URIMAP definition.

Table 166. URIMAP definitions: Summary resource statistics
DFHSTUP name Description
URIMAP Name is the name of the installed URIMAP definition.

 

URIMAP Usage

The intended use of this URIMAP:

SERVER
The URIMAP definition is used to locate the resources for CICS to produce an HTTP response to the request identified by HOST and PATH.
CLIENT
The URIMAP definition is used to specify information for making an HTTP request from CICS as an HTTP client.
PIPELINE
The URIMAP definition is used to locate the resources for CICS to produce an XML response to the request identified by HOST and PATH.

 

URIMAP Scheme The scheme for the HTTP request, HTTP with SSL (HTTPS) or without (HTTP).

 

URIMAP Host

For USAGE(CLIENT), the host name of the target URL to which the HTTP request is to be sent. For any other USAGE, the host name on the incoming HTTP request that is used to select this URIMAP definition.

 

URIMAP Path

For USAGE(CLIENT), the path of the target URL to which the HTTP request is to be sent. For any other USAGE, the path on the incoming HTTP request that is used to select this URIMAP definition. The PATH may terminate in an asterisk, meaning that it is generic, and matches any path whose characters are the same up to but excluding the asterisk.

 

TCPIPSERVICE name

The TCPIPSERVICE to which this URIMAP definition applies. Only requests received on this TCPIPSERVICE are matched to this URIMAP definition. If no TCPIPSERVICE is specified, the URIMAP definition applies to all incoming HTTP requests.

 

WEBSERVICE name

The name of the WEBSERVICE resource definition for the Web service that handles the incoming HTTP request.

 

PIPELINE name

The name of the PIPELINE resource definition for the Web service that handles the incoming HTTP request.

 

Templatename

The name of a CICS document template whose contents are returned as the HTTP response.

 

HFS File

The name of a file in the z/OS UNIX System Services Hierarchical File System (HFS), whose contents are returned as the HTTP response.

 

Analyzer

Whether or not the analyzer associated with the TCPIPSERVICE definition is called to process the request.

 

Converter

The name of a converter program that is used to transform the HTTP request into a form suitable for the application program specified in PROGRAM.

 

Transaction ID

The name of the alias transaction that processes the incoming HTTP request.

 

Program name

The name of the application program that processes the incoming HTTP request.

 

Redirection type

Whether or not matching requests should be redirected, on a temporary or permanent basis.

 

Location for redirection

An alternate URL to which the Web client is redirected, if redirection is specified.

 

URIMAP reference count

Number of times this URIMAP definition was referenced.

 

Disabled

Number of times this URIMAP host and path were matched, but the URIMAP definition was disabled.

 

Redirected

Number of times this URIMAP host and path were matched, and the request was redirected.

 

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting Web and TCP/IP statistics
DFH0STAT reports for these statistics
URIMAPs Global Report
URIMAPs Report
End of change [[ Contents Previous Page | Next Page Index ]]