Dialog Statistics › Collecting and Writing Statistics

Collecting and Writing Statistics

At runtime, if dialog statistics are enabled, statistics for overhead activity are collected and written to the CA IDMS/DC or DC/UCF (DC/UCF) system log whenever overhead activity is performed, once at the beginning of the application and once at the end. The transaction statistics block identifier for overhead activity is either the application name or, for applications not defined using the application generator, $ADS@@OH.

Dialog statistics are collected each time a dialog issues a control command. These statistics are not written immediately to the system log, but are accumulated in transaction and CA ADS statistics blocks (TSBs and ASBs).

The runtime system allocates TSBs and ASBs as follows:

• If dialog statistics are enabled in the ALL DIALOGS mode, one TSB and one ASB are allocated for each dialog the first time the dialog becomes operative in the application thread. The statistics block identifier for the TSB and ASB is the dialog name.
• If dialog statistics are enabled in the SELECTED DIALOGS mode, one TSB and one ASB are allocated for each selected dialog the first time the dialog becomes operative in the application thread. Additionally, one TSB and one ASB are allocated to accumulate statistics for all nonselected dialogs; the statistics block identifier for the additional TSB and ASB is $ADS@@AO.

Dialog statistics are written to the system log each time the number of statistics accumulations equals the predefined checkpoint interval. Additionally, statistics are written to the log when the application terminates.

When dialog statistics are written to the system log, only TSBs and ASBs that contain accumulated statistics are written to the system log. The TSBs and ASBs are then initialized, and the statistics accumulations count is reset to zero.

TSBs and ASBs are freed only when the application terminates. Note, however, that during a pseudo-converse they may be written to scratch along with record buffer blocks, as directed at system generation with the FAST MODE THRESHOLD and RESOURCES parameters of the ADSO statement.