URIMAP definitions: Resource statistics

You can retrieve URIMAP definition resource statistics by using the EXEC CICS EXTRACT STATISTICS URIMAP command. They are mapped by the DFHWBRDS DSECT. The resource information gives details of various attribute settings of each URIMAP resource.

Table 1. URIMAP definitions: resource statistics
DFHSTUP name	Field name	Description
URIMAP Name	WBR_URIMAP_NAME	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. ATOM The URIMAP definition is used for an incoming request for data that CICS makes available as an Atom feed. JVMSERVER The URIMAP resource is used to map an inbound request from a web client to a servlet or JSP that is running in a JVM server. Reset characteristic: not reset
URIMAP Scheme	WBR_URIMAP_SCHEME	The scheme for the HTTP/S request: HTTP An HTTP request (not using SSL) HTTPS An HTTPS request (using SSL) IIOP For remote EJB calls over the IIOP protocol JMS For MQ Series requests to the JMS protocol Reset characteristic: not reset
Authenticate	WBR_URIMAP_AUTHENTICATE	For USAGE(CLIENT), whether credentials (authentication information) are sent for outbound web requests. Reset characteristic: not reset
URIMAP Port	WBR_URIMAP_PORT	For USAGE(CLIENT), the port number used for the client connection. For USAGE(SERVER), the port number that is being used for the communication, even if PORT(NO) is specified on the URIMAP at define time. Reset characteristic: not reset
URIMAP Host	WBR_URIMAP_HOSTNAME	For the USAGE(CLIENT) option, the host name of the target URL to which the HTTP request is to be sent. For any other usage type, the host name on the incoming HTTP request that is used to select this URIMAP definition. Reset characteristic: not reset
URIMAP IP Family	WBR_URIMAP_IP_FAMILY	The address format of the IP Resolved Address. Reset characteristic: not reset
URIMAP IP Resolved Address	WBR_URIMAP_IP_ADDRESS	The IPv4 or IPv6 address of the host. Reset characteristic: not reset
URIMAP Path	WBR_URIMAP_PATH	For the USAGE(CLIENT) option, the path of the target URL to which the HTTP request is to be sent. For any other usage type, the path on the incoming HTTP request that is used to select this URIMAP definition. The path might end in an asterisk, meaning that it is generic, and matches any path with characters that are the same up to but excluding the asterisk. Reset characteristic: not reset
TCPIPSERVICE name	WBR_URIMAP_TCPIPSERVICE	The TCPIPSERVICE resource to which this URIMAP definition applies. Only requests received using this TCPIPSERVICE resource are matched to this URIMAP definition. If no TCPIPSERVICE resource 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
ATOMSERVICE name	WBR_URIMAP_ATOMSERVICE	The name of the ATOMSERVICE resource definition for the Atom document. Reset characteristic: not reset
Templatename	WBR_URIMAP_TEMPLATENAME	The name of a CICS document template, the contents of which 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), with the contents that 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 will be redirected, on a temporary or permanent basis. Reset characteristic: not reset
Location for redirection	WBR_URIMAP_LOCATION	An alternative URL to which the Web client is 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 that this host and path were matched and the request was redirected. Reset characteristic: reset to zero
Time out for pooled sockets	WBR_URIMAP_SOCKETCLOSE	The time after which CICS discards pooled client HTTP connections created using this URIMAP resource if they are not reused. Reset characteristic: not reset
Number of pooled sockets	WBR_URIMAP_SOCKPOOLSIZE	Current number of open client HTTP connections held in the pool for reuse. Reset characteristic: not reset
Peak number of pooled sockets	WBR_URIMAP_SOCKPOOLSIZE_PEAK	Peak number of open client HTTP connections held in the pool for reuse. Reset characteristic: reset to zero
Number of reclaimed sockets	WBR_URIMAP_SOCKETS_RECLAIMED	Number of pooled connections that were closed in the pool by CICS because the CICS region had reached the MAXSOCKETS limit. Reset characteristic: reset to zero
Number of timed out sockets	WBR_URIMAP_SOCKETS_TIMEDOUT	Number of pooled connections that were closed in the pool by CICS because they reached their timeout value without being reused. Reset characteristic: reset to zero
Not in DFHSTUP report	WBR_URIMAP_DEFINE_SOURCE	The source of the resource definition. Its value depends on the change agent. For more information, see Summary of the resource signature field values. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_CHANGE_TIME	The time stamp (STCK) in local time of CSD record change. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_CHANGE_USERID	The user ID that ran the change agent. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_CHANGE_AGENT	The agent that made the last change. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_INSTALL_AGENT	The agent that installed the resource. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_INSTALL_TIME	The time stamp (STCK) in local time when the resource was installed. Reset characteristic: not reset
Not in DFHSTUP report	WBR_URIMAP_INSTALL_USERID	The user ID that installed the resource. Reset characteristic: not reset

The resource statistics fields for the resource signature

The resource signature captures details about when the resource is defined, installed, and last changed. The resource statistics field names for the resource signature end in CHANGE_AGENT, CHANGE_TIME, CHANGE_USERID, DEFINE_SOURCE, INSTALL_AGENT, INSTALL_TIME, and INSTALL_USERID. For detailed information about the content of the resource signature fields, see Summary of the resource signature field values.