TRANSFER Installation and Management Guide

Configuring Parameters for Statistics Collection
Using ADMIN to Administer TRANSFER
9–14 13198 Tandem Computers Incorporated
Configuring the
Parameters for
Statistics Collection
TRANSFER permits three ways of configuring the parameters for collecting depot
storage statistics:
A configuration program, CDTRDEF, allows these parameters to be entered
through the Base TRANSFER define file, DEFINETR. You configure the depot
statistics facility with this program only when you initialize a TRANSFER system.
CDTRDEF is discussed with Base TRANSFER in Sections 2 and 5 of this manual.
The ADMIN program provides a DEPOT STATISTICS CONFIGURATION screen
on which a system manager with administrative write privileges can set
parameters for the next configuration of statistics.
The configuration screen is discussed later in this section.
A user application can call UOWs to set or change the parameters. The
TRANSFER Programming Guide discusses these UOWs.
Whenever the TRANSFER system is restarted, using XCOOL, the previous
configuration parameters are used except where you have specified changes in
ADMIN or through a UOW. Changes to the configuration parameters through either
ADMIN or the UOW interface take effect only after TRANSFER has been stopped and
restarted.
You can configure six parameters for the depot statistics facility. The first of these
always applies to collection, whether you are saving statistics or not:
COUNT ITEMS WHEN EXAMINED indicates that items are counted when the
recipient examines them, rather than when they arrive at the depot. TRANSFER
delivers all items to the INBOX of a depot. If this parameter is set to NO, an item
is accounted for statistically as soon as it arrives in the INBOX. The TRDFLTS
default is NO (count when delivered to INBOX).
The five remaining parameters apply only if you want the facility to keep previous
samples.
BASE TIME for collecting depot storage statistics is the time of day—the time of the
snapshot—that statistics are collected, using a twenty-four hour clock. The
TRDFLTS default is 00:00 (midnight).
SAMPLE INTERVAL for depot storage statistics is the period of time that elapses
before the collection of the next set of depot statistics.
The sample interval can range from 1 to 9999, at intervals of minutes (M), hours
(H), or days (D). The TRDFLTS default is one day.
NUMBER OF SAMPLES (PER AVERAGE) is the number of samples recorded in
the DEPSTAT file for each depot.
For example, if you want to record depot storage statistics on a weekly basis for
ten weeks, you set the SAMPLE INTERVAL to seven days and the NUMBER OF
SAMPLES to 10. After ten or more weeks, you have depot storage statistics for
each depot for each of the previous ten weeks. Each statistic equals the total byte
count for a depot at the end of one specific week.