CL Command Reference - TRCASPBAL
CL Command List > TRCASPBAL Reference
Description:
The Trace ASP Balance (TRCASPBAL) command controls the function that gathers the auxiliary storage pool (ASP) usage statistics. The trace function monitors the frequency that data is accessed on the disk units within the specified ASP. The ¡¯high¡¯ use data and the ¡¯low¡¯ use data on the units is identified. The tracing of the usage of data on the units can be started on a specific ASP or for multiple ASPs. The trace may be started for a specific length of time. The trace can be stopped by specifying *OFF for the Trace option setting (SET) parameter. The trace can be ended at any time and restarted at a later time. The statistics that are collected are cumulative. For example, if the trace is started and ended and then restarted without clearing the statistics, the second group of statistics are added to the first collection.
After statistics have been collected the ASP may be balanced using the Start ASP Balance (STRASPBAL) command, specifying TYPE(*USAGE) or TYPE(*HSM). After the balance has run to completion, the statistics will be cleared automatically by the balance function.
The balancing of the ASP should be done shortly after the statistics have been collected. The usefulness of the balance is diminished as the trace statistics age. If the statistics are not current, the statistics may be cleared by specifying *CLEAR for the SET parameter.
A message will be sent to the system history (QHST) log when the trace function is turned on, when it is stopped, or the trace data is cleared.
Restrictions:
. You must have all object (*ALLOBJ) special authority to run this command.
Examples:
Example 1: Start Trace for ASP 1
TRCASPBAL ASP(1) SET(*ON) TIMLMT(9999)
This command allows the user to start the ASP tracing function for ASP 1. This function will run until the user ends the trace or 9999 minutes have passed.
Example 2: End Tracing for All ASPs
TRCASPBAL ASP(*ALL) SET(*OFF)
This command allows the user to end the ASP tracing function for each ASP that currently has a trace running.
Example 3: Clear the Trace Data for ASP 1
TRCASPBAL ASP(1) SET(*CLEAR)
This command allows the user to clear the trace data for ASP 1.
Example 4: End Tracing for All ASP Devices
TRCASPBAL ASPDEV(*ALLAVL) SET(*OFF)
This command allows the user to end the ASP tracing function for each ASP device that currently has a trace running.