Skip to content
CA PDSMAN® PDS Library Management - 7.7
Documentation powered by DocOps

$USESTATS Control Statement

Last update April 29, 2016

This optional control statement allows global options to be specified for the PDSMAN Usage Statistics Recording facility.

Only one $USESTATS control statement can be specified. The format of the $USESTATS control statement is as follows.

$USESTATS [RECORD=Y|N]
          [HISTORY=Y|N]
          [RETAINHIST=0|365|nnnnn]
          [DIAGLEVEL=0|n]

Contents

Parameters

The following items describes the $USESTATS control statement parameters:

RECORD

Controls how Usage Statistics Recording is started and enabled. Changes to this setting take effect the next time the PDSMAN Partitioned Resource Monitoring subtask, PDSMPMON, is started. 

Y
Usage Statistics Recording is started automatically when the Partitioned Resource Monitoring subtask is started (default). 

N
Usage statistics are not recorded and statistics reporting is not available.

HISTORY

Instructs PDSMAN to write current usage statistics to the PDSMAN database before terminating Usage Statistics Recording. This parameter is a normal part of terminating the PDSMAN Partitioned Resource monitoring subtask. 

Y
Write current usage statistics to the PDSMAN database (default).

N
Do not write the usage statistics to the database. PDSMAN issues message PDSMPUSE-04 and permanently discards the current usage statistics.

RETAINHIST
Specifies the approximate number of days that historical usage statistics for this system are to be retained in the database. The actual retention can differ slightly from this value because records are purged the next time Usage Statistics Recording is initialized. 

0
Usage statistics are retained indefinitely. 

365
Usage statistics are retained for 365 days, or approximately one year (default).

nnnnn
Usage statistics are retained for the specified number of days.  

DIAGLEVEL
Specifies a diagnostic level that is used to control PDSMAN diagnostic messages for Usage Statistics Recording. This parameter is typically specified at the direction of Technical Support.

0
No diagnostics (default).

n
Diagnostic level (1 through 9).


$USESTATS Example

The following $USESTATS control statement causes PDSMAN to record usage statistics and write historical data to the PDSMAN database where it is retained indefinitely.

$USESTATS RECORD=Y 
          HISTORY=Y 
          RETAINHIST=0
Was this helpful?

Please log in to post comments.