Retrieve the current statistics for a single resource, or global statistics for a class of resources.
EXTRACT STATISTICS only deals with the URIMAP, PIPELINE, and WEBSERVICE resources, to COLLECT STATISTICS for other resources see COLLECT STATISTICS.
EXTRACT STATISTICS performs a function equivalent to COLLECT STATISTICS for the resources URIMAP, PIPELINE, and WEBSERVICE. These could not be provided by extending COLLECT STATISTICS due to a design limitation of that command. The syntax of EXTRACT STATISTICS is different and provides for unlimited future expansion.
Extract STATISTICS >>-EXTRACT STATISTICS--RESTYPE--(--cvda--)----------------------> >--+----------------------------------------------------------+--> '-RESID--(--data-area--)--+------------------------------+-' '-RESIDLEN--(--data-value--)---' >--SET--(--ptr-ref--)--+---------------+----------------------->< '-| last time |-'
Conditions: INVREQ, IOERR, LENGERR, NOTAUTH, NOTFND
last time: |--+-LASTRESET(data-area)----------------+----------------------| '-| hours |--| minutes |--| seconds |-' hours: |--LASTRESETHRS(data-area)--------------------------------------| minutes: |--LASTRESETMIN(data-area)--------------------------------------| seconds: |--LASTRESETSEC(data-area)--------------------------------------|
The EXTRACT STATISTICS command returns to the invoking application the current statistics for a particular resource, or overall statistics for the resources of a given type.
The statistics that CICS gives you are those that have been accumulated after the expiry of the last statistics extraction interval, end-of-day expiry, or requested reset. (Statistics already written to the SMF data set cannot be accessed.) The EXTRACT STATISTICS command does not cause the statistics counters to be reset.
CICS obtains enough storage for the data returned from this command, and returns a pointer to this area. The first two bytes of the area contain its length. This storage can be reused by subsequent EXTRACT STATISTICS commands, so you should store elsewhere any data that is required beyond the next issue of the command. CICS releases this storage at task termination.
Table 2 contains Product-sensitive Programming Interface information. See Programming interface information for an explanation of Programming Interface information.
Not all resource types provide both global and specific statistics. Table 2 tells you which statistics are available for each resource type, and gives the copybook name for each set of available statistics. The copybooks define the format of the returned statistics. Where no copybook name is given in the global statistics column, global statistics are not available for the resource type; similarly, where there is no entry in the specific statistics column, you cannot get statistics for an individual resource.
Resource type | CVDA | RESIDLEN | Statistic type | Global statistics | Specific statistics |
---|---|---|---|---|---|
PIPELINE | 1124 | Char(8) | PIPELINE | -- | DFHPIRDS |
URIMAP | 1173 | Char(8) | URIMAP | DFHWBGDS | DFHWBRDS |
WEBSERVICE | 1174 | Char(32) | WEBSERVICE | -- | DFHPIW DS |
Copybooks are provided in ASSEMBLER, COBOL, and PL/I. (There is no copybook for C.) The names of the copybooks are the same in each language. You can find them in the following libraries:
ASSEMBLER | CICSTS31.CICS.SDFHMAC |
COBOL | CICSTS31.CICS.SDFHCOB |
PL/I | CICSTS31.CICS.SDFHPL1 |
For further information about these copybooks, see the CICS® Performance Guide.
There are two formats for the reset time:
e.g.
EXEC CICS EXTRACT STATISTICS URIMAP
or
EXEC CICS EXTRACT STATISTICS RESTYPE(1173)
or
EXEC CICS EXTRACT STATISTICS RESTYPE(DFHVALUE(URIMAP))
CICS provides a sample EXTRACT STATISTICS application (DFH0STAT) that makes use of virtually all the options described in this section. This set of programs illustrates ways of using the EXTRACT STATISTICS and INQUIRE commands of CICS Transaction Server for z/OS® to produce information about a CICS system. The reports include a CICS and MVS storage analysis that can be used as an aid to specifying the DSA LIMIT parameters.
See the CICS Performance Guide for information on installing and operating the DFH0STAT application. The source code for the application can be found in CICSTS31.CICS.SDFHSAMP.