Common Configuration Options

Several common file management configuration options may be used when configuring log, statistics, and message dump options.

Configuration Reference

ext	The primary and secondary extent size for the file in the form: < pri-extent-size>, [ <sec-extent-size> ] The default value is 50,50.
maxextents	The maximum extents for the file. The default value is 100.
on-file-full	The action to take when the output file is full. The available options are 'rollover' and 'purgedata'. rollover - The current file is renamed according to the 'rollover-file' specification and a new file is opened. purgedata - The current file data is purged with a call to CONTROL 20 and the current file remains open. The default action is 'rollover'.
rollover-file	The file name prefix for rollover files, which may be partially or fully qualified. The file name portion of the specified file will be truncated to a maximum of 5 characters and a 3 digit sequence number will be appended. The default rollover-file name is the current output file name. Specifying a remote system file for the rollover file name is not supported.
rollover-count	The maximum number of rollover files to retain. Note that when a rollover occurs, the oldest rollover files are deleted until <rollover-count> files remain. The rollover files are then renamed such that that the rollover file sequence numbers are sequential starting from 000. The default value is 20.

Example

TEXT

; Log to a file, specifying the extents. Note that if rollover occurs on the file, the 
; rollover file names will be zzlog000, zzlog001, etc.
[log]
file=$data1.logs.zzlog
format=text
level=info
time=lct
ext=16,32
maxextents=512

TEXT

; Log to a file, specifying an alterate subvol for the "rolled over" files and limiting
; to a maximum of 10 rollover files.
[log]
file=$data1.logs.zzlog
format=text
level=info
time=lct
rollover-file=$data1.archive.log
rollover-count=10

CODE

; Log statistics to a file that is read by Prognosis, purging the statistics data when the file is full.
[stats]
file=$data1.stats.zzstats
enabled=1
on-file-full=purgedata