HP 3000 Manuals HP 3000 Manuals
YEARLY
YEARLY [yyyy]
[yy ]
The YEARLY command specifies a data extraction based on a calendar year.
During execution, the command sets the start and stop dates to the proper
dates, based on the year being extracted.
The name of the output file consists of the letters RXYR followed by the
four digits of the year being extracted. Thus, data from 1991 would be
output to a file named RXYR1991.
Enter one of the following:
YEARLY To extract the current year's data.
YEARLY yy To extract a specific year's data (where yy is a
number from 00 to 99).
The specifications 00 to 60 assume the years
2000 to 2060, whereas 61 to 99 assume the years
1961 to 1999.
YEARLY yyyy To extract a specific year's data (where yyyy is
the full-year numbered 1961 to 2060).
If you do not specify the log file before executing the YEARLY command,
it defaults to the file LOGGLOB.SCOPE.SYS.
The type of data extracted and the level of summarization of that data
follow the normal rules for EXTRACT and can be set before executing the
YEARLY command. These settings are honored unless the yearly output file
already exists. If it does, data is appended to it based upon the type
of data selected originally.
The YEARLY command has a special feature. It opens the previous year's
extracted file and checks to see if it is filled--whether it contains
data extracted up to the last day of the year. If not, the YEARLY
command appends data to this file to complete the previous year's
extraction.
For example, a YEARLY command is executed on December 15, 1991. This
creates a log file named RXYR1991 that contains data from January 1, 1991
to the current date (December 15).
On January 5, 1992, another YEARLY command is executed. Before the
RXYR1992 file is created for the current year, the RXYR1991 file from the
previous year is opened. When it is found to be incomplete, data is
appended to it to complete its extraction until December 31, 1991. Then,
the RXYR1992 file is created to hold data from January 1, 1992 to the
current date (January 5).
As long as you execute the YEARLY command at least once a year, each
year's file is completed before the next year's file is created.
Whenever you see two yearly files adjacent to each other (for example,
RXYR1990 and RXYR1991), you can assume safely that the first file is
complete for that year, and it can be archived and purged.
NOTE The previous paragraph is true only if the raw log files are sized
large enough to hold one full year of data. It would be more
common to size the raw log files smaller and execute the YEARLY
command more often (such as once a month).
Sample YEARLY Task
In this task, you append to the existing yearly summary file (or create
it, if necessary).
Add application and global summary data plus disc detail only.
GLOBAL SUM
APPLICATION SUM
PROCESS OFF
DISC DETAIL
YEARLY
A file named RXYE followed by the current year is used as the output
file.