The EXTRACT STATISTICS is added to CICS® to supplement the function of the COLLECT STATISTICS command.
For the PIPELINE, URIMAP, and WEBSERVICE resources, use EXTRACT STATISTICS to retrieve the current statistics for a single resource, or global statistics for a class of resources. EXTRACT STATISTICS only deals with these three resources. To COLLECT STATISTICS for other resources, continue to use the COLLECT STATISTICS command.
EXTRACT STATISTICS performs a function equivalent to COLLECT STATISTICS for the resources URIMAP, PIPELINE, and WEBSERVICE, because these could not be provided by extending COLLECT STATISTICS (due to a design limitation of that command). When compared to COLLECT STATISTICS, 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)-+---------------------------------------------------------------------------+->< +-LASTRESET(data-area)------------------------------------------------------+ '-LASTRESETHRS(data-area)--LASTRESETMIN(data-area)--LASTRESETSEC(data-area)-'
Conditions: INVREQ, IOERR, LENGERR, NOTAUTH, NOTFND
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.
Not all resource types provide both global and specific statistics. Table 1 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 | -- | DFHPIWDS |
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 |