Command Reference Guide

Administration Commands
set_log_file
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands,
occur for this command.
Other Conditions
Appendix A, Common Return Codes from snapadmin Commands, lists combinations of primary and secondary
return codes that are common to all commands.
2.189 set_log_file
The set_log_file command manages a file that SNAplus2 uses to record log messages. It enables you to do
the following:
• Specify a file used to record log messages (audit, error, or usage logs), and the backup file (to which log
information is copied).
• Specify the maximum log file size (when the log file reaches this size, SNAplus2 copies log information to the
backup file and resets the log file).
• Copy the current contents of the log file to the backup file, and optionally delete the current file.
You can record audit log and error log messages in separate files, or record both types of messages in the same file.
2.189.1 Supplied Parameters
Parameter name Type Length Default
[set_log_file]
log_file_type constant ERROR
action constant NO_FILE_ACTION
file_name character 80 (null string)
backup_file_name character 80 (null string)
file_size decimal 0
Supplied parameters are:
log_file_type
The type of log file to be used. Possible values are:
AUDIT
Audit log file (record audit messages only)
ERROR
Error log file (record problem and exception messages)
USAGE
Usage log file (record information on current and peak usage of SNAplus2 resources).
To record both audit and error messages in the same file, issue two set_log_file commands for the same
file name, specifying AUDIT for the log_file_type of one command and ERROR for the log_file_type of the
other.
action
588