Web services: Resource statistics
You can retrieve web services resource statistics by using the EXEC CICS EXTRACT STATISTICS WEBSERVICE RESID system command. They are mapped by the DFHPIWDS DSECT.
The resource information gives details of various attribute settings of each WEBSERVICE resource definition. A total use count for all WEBSERVICE definitions is also available.
| DFHSTUP name | Field name | Description |
|---|---|---|
| WEBSERVICE Name | PIW_WEBSERVICE_NAME | The name of the WEBSERVICE resource definition.
Reset characteristic: not reset
|
| PIPELINE name | PIW_PIPELINE_NAME | The name of the PIPELINE resource that contains this
WEBSERVICE resource. Reset characteristic: not reset
|
| URIMAP name | PIW_URIMAP_NAME | The name of a dynamically installed URIMAP resource
definition, if there is one that is associated with this WEBSERVICE resource definition. Reset characteristic: not reset
|
| Web service description (WSDL) | PIW_WSDL_FILE | The file name of the Web service description (WSDL) file
associated with the WEBSERVICE resource. Reset characteristic: not reset
|
| Archive file | PIW_ARCHIVE_FILE | The file name of the archive file containing one or more
web service description (WSDL) files associated with the WEBSERVICE resource. Reset characteristic: not reset
|
| Web service binding file | PIW_WSBIND_FILE | The file name of the Web service binding file associated
with the WEBSERVICE resource. Reset characteristic: not reset
|
| Web service WSDL binding | PIW_WSDL_BINDING | The WSDL binding represented by the WEBSERVICE resource.
This binding is one of (potentially) many that appear in the WSDL file. Reset characteristic: not reset
|
| Endpoint | PIW_ENDPOINT_URI | The URI specifying the location on the network (or
endpoint) of the web service, as defined in the web service description. Reset characteristic: not reset
|
| Validation | PIW_MSG_VALIDATION | Indicates whether full validation of SOAP messages
against the corresponding schema in the web service description is specified. Reset characteristic: not reset
|
| Program interface | PIW_PROGRAM_INTERFACE | For a service provider, indicates whether CICS® passes data to the
target application program in a COMMAREA or a channel. Reset characteristic: not reset
|
| Program name | PIW_WEBSERVICE_PROGRAM | The name of the target application program. Reset characteristic: not reset
|
| Container | PIW_CONTAINER_NAME | When CICS passes data to the target application program in a channel,
indicates the name of the container that holds the top-level data. Reset characteristic: not reset
|
| WEBSERVICE use count | PIW_WEBSERVICE_USE_COUNT | The number of times this WEBSERVICE resource definition
was used to process a message. Reset characteristic: reset to zero
|
| Not in DFHSTUP report | PIW_WEBSERVICE_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 | PIW_WEBSERVICE_CHANGE_TIME | The time stamp (STCK) in local time of CSD record
change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PIW_WEBSERVICE_CHANGE_USERID | The user ID that ran the CHANGE_AGENT. Reset characteristic: not reset
|
| Not in DFHSTUP report | PIW_WEBSERVICE_CHANGE_AGENT | Identifies the agent that made the last
change. Reset characteristic: not reset
|
| Not in DFHSTUP report | PIW_WEBSERVICE_INSTALL_AGENT | Identifies the agent that installed the
resourcee. Reset characteristic: not reset
|
| Not in DFHSTUP report | PIW_WEBSERVICE_INSTALL_TIME | The time stamp (STCK) in local time when the resource
was installed. Reset characteristic: not reset
|
| Not in DFHSTUP report | PIW_WEBSERVICE_INSTALL_USERID | The user ID that installed the resource. Reset characteristic: not reset
|
WEBSERVICE totals: The resource statistics also include a total WEBSERVICE use count, which shows the total number of times a WEBSERVICE resource definition was used to process a message.
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.