PIPELINE definitions: Resource statistics

You can retrieve PIPELINE definition resource statistics by using the EXEC CICS EXTRACT STATISTICS PIPELINE RESID system command. They are mapped by the DFHPIRDS DSECT.

The resource information gives details of various attribute settings of each PIPELINE resource. A total use count for all PIPELINE resources is also available.

Table 1. PIPELINE definitions: resource statistics
DFHSTUP name Field name Description
PIPELINE Name PIR_PIPELINE_NAME The name of the PIPELINE resource definition.

Reset characteristic: not reset

 

PIPELINE Mode PIR_PIPELINE_MODE The operating mode of the pipeline.

Reset characteristic: not reset

 

Configuration file PIR_CONFIGURATION_FILE The name of the zFS file that provides information about the message handlers and their configuration.

Reset characteristic: not reset

 

Shelf directory PIR_SHELF_DIRECTORY The fully qualified name of the shelf directory for the PIPELINE definition.

Reset characteristic: not reset

 

WSDIR pickup directory PIR_WSDIR_DIRECTORY

The fully qualified name of the web service binding directory (also known as the pickup directory).

Reset characteristic: not reset

 

PIPELINE use count PIR_PIPELINE_USE_COUNT

The number of times this PIPELINE resource definition was used to install a web service or to process a web service request.

Reset characteristic: reset to zero

 

PIPELINE JSON_JAVA_PARSER PIR_JSON_JAVA_PARSER

For a JSON PIPELINE resource, specifies if the JSON request message is parsed using Java™ or from within the CICS® pipeline.

Reset characteristic: never reset

PIR_JSON_JAVA_PARSER is expected to take 1 of 3 values:
  • pir_json_java_parser_notapplic = 0

    pir_json_java_parser_notapplic is set for a PIPELINE that is not for JSON; for example, a SOAP PIPELINE.

  • pir_json_java_parser_yes = 1

    pir_json_java_parser_yes is set when a JSON PIPELINE configuration file contains the attribute java_parser=yes. This is the default value.

  • pir_json_java_parser_no = 2

    pir_json_java_parser_no is set when a JSON PIPELINE configuration file contains the attribute java_parser=no.

 
Not in DFHSTUP report PIR_PIPELINE_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 PIR_PIPELINE_CHANGE_TIME

The time stamp (STCK) in local time of CSD record change.

Reset characteristic: not reset

 

Not in DFHSTUP report PIR_PIPELINE_CHANGE_USERID

The user ID that ran the CHANGE_AGENT.

Reset characteristic: not reset

 

Not in DFHSTUP report PIR_PIPELINE_CHANGE_AGENT

Identifies the agent that made the last change.

Reset characteristic: not reset

 

Not in DFHSTUP report PIR_PIPELINE_INSTALL_AGENT

Identifies the agent that installed the resource.

Reset characteristic: not reset

 

Not in DFHSTUP report PIR_PIPELINE_INSTALL_TIME

The time stamp (STCK) in local time when the resource was installed.

Reset characteristic: not reset

 

Not in DFHSTUP report PIR_PIPELINE_INSTALL_USERID

The user ID that installed the resource.

Reset characteristic: not reset

 

PIPELINE message format PIR_PIPELINE_MSGFORMAT

The message format processed by the PIPELINE.

Reset characteristic: not reset

Pipeline totals:

The resource statistics also include a total PIPELINE use count, which shows the total number of times a PIPELINE resource definition was used to install a web service or to process a web service request.

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.