CICSPlex SM provides the ability to save and view data for completed tasks, that is historical task data. When an active task completes, its data is stored in a historical data store. The data store is made up of a number of VSAM KSDS data sets. There must be a minimum of two data sets and a maximum of twenty six data sets.
Support for historical task data builds upon CICSPlex SM MAS resource monitoring. It uses all the same definitional entities, for example MONSPECs, MONDEFs and MONGROUPs. In particular it uses MTRAN type MONDEFs to specify transaction IDs for the transactions that you wish to save historical task data for. Whereas, for example, with MAS resource monitoring an MTRAN type MONDEF specifying a resource of FRED will cause data to be accumulated and totalled for multiple instances of transaction FRED into one record, historical task data support provides the ability to separately save the entire CICS monitoring data for each instance of transaction FRED.
Existing users of CICSPlex SM monitoring can easily start using historical task data support. Simply define the history VSAM data sets, and allocate them to the MAS region by means of DD cards. CICSPlex SM will then start collecting historical task data for all transaction IDs named on installed MONDEFs.
For more information on how to define the CICSPlex SM history data sets refer to the CICS® Transaction Server for z/OS® Installation Guide.
For those users who wish only to collect historical task data without collecting CICSPlex SM monitoring data as well, an EYUPARM called HISTORYONLY is provided. This should be set to a value of YES. The default is HISTORYONLY(NO) which means that both CICSPlex SM monitoring data and history data will be collected, assuming the appropriate MONDEFs have been installed and the VSAM data sets have been allocated to the MAS region.
Historical task data saved in the historical data store can be retrieved using the CICSPlex SM API on the HTASK resource table. For more information on the HTASK resource table, see the CICSPlex SM Resource Tables Reference manual. EUI views are not provided to retrieve data from the HTASK table. Similarly, the Web User Interface starter set cannot be used to retrieve data from the HTASK table. However the Web User Interface view editor can be used to create viewsets for this data.
Disabling history collection
If the EYUHISTx datasets have been allocated and history collection
within the CICS region has started due to an installed MONDEF for the MTRAN
class, you can disable history collection in one of the following ways:
The CICS region will receive one or more error messages, the final message being:
EYUNL0171I applid History Recorder has been terminated.
The MAS history long running task is not restarted in this instance.