Version 8.1.4
 —  Utilities  —

REFRESHSTATS: Reset Statistical Values

The REFRESHSTATS function resets statistical values maintained by the Adabas nucleus for its current session. Parameters may be used to restrict the function to particular groups of statistical values.

When you invoke REFRESHSTATS, Adabas automatically writes the nucleus shutdown statistics to DD/PRINT.

Important:
Refreshing Adabas statistical values affects the corresponding Adabas Statistics Facility (ASF) field values. These values, which normally reflect the period from the start of the nucleus, will then refer to the time after the last refresh. ASF users may therefore find it useful to store the nucleus records with the appropriate ASF function before refreshing the values.

graphics/util_adadbs_refreshstats.png

This document covers the following topics:


Optional Parameters

ALL: All Statistical Values

The ALL keyword may be specified as an abbreviation for the combination of CMDUSAGE, COUNTERS, FILEUSAGE, POOLUSAGE, and THREADUSAGE.

If none of the option keywords is specified, ALL is the default option.

CMDUSAGE: Command Usage Counters

The CMDUSAGE parameter is specified to reset the counters for Adabas direct call commands such as Lx, Sx, or A1.

COUNTERS: Frequency Counters

The COUNTERS parameter is specified to reset the counter fields for local or remote calls, format translations, format overwrites, Autorestarts, protection log switches, buffer flushes, and command throw-backs.

FILEUSAGE: Count of Commands Per File

The FILEUSAGE parameter is specified to reset the count of commands for each file.

NOUSERABEND: Termination Without Abend

When an error is encountered while the function is running, the utility prints an error message and terminates with user abend 34 (with a dump) or user abend 35 (without a dump).

If NOUSERABEND is specified, the utility will not abend after printing the error message. Instead, the message "utility TERMINATED DUE TO ERROR CONDITION" is displayed and the utility terminates with condition code 20.

NUCID: Cluster Nucleus ID

Any nucleus running in an Adabas nucleus cluster is allowed to run Adabas utilities such as ADADBS. The NUCID parameter allows you to direct the ADADBS REFRESHSTATS function to a particular nucleus in the cluster for execution, just as though the command had been issued by a locally run ADADBS REFRESHSTATS operation.

If you specify NUCID=0, the statistical values are refreshed for all active nuclei in the cluster.

POOLUSAGE: High-Water Marks for Nucleus Pools

The POOLUSAGE parameter is specified to reset the high-water marks for the nucleus pools such as the work pool, the command queue, or the user queue.

THREADUSAGE: Count of Commands Per Thread

The THREADUSAGE parameter is specified to reset the count of commands for each Adabas thread.

Top of page

Example

ADADBS  REFRESHSTATS 
CMDUSAGE,POOLUSAGE,NUCID=3

After the shutdown statistics for the Adabas cluster nucleus with NUCID=3 are written to DD/PRINT, the command counters and the pool high-water marks for the nucleus are reset.

Top of page