HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (QUERY Verbs)
QUERY_LOG_FILE
Chapter 4724
AP_OK
secondary_rc
Not used.
file_name
Name of the log file. This parameter is an ASCII string
of 1-80 characters, followed by a null (0x00) character.
If no path is included, the file is stored in the default
directory for diagnostics files, /var/opt/sna; if a path
is included, this is either a full path (starting with a /
character) or the path relative to the default directory.
backup_file_name
Name of the backup log file. This parameter is an
ASCII string of 1-80 characters, followed by a null
(0x00) character.
When the log file reaches the size specified by
file_size
below, SNAplus2 copies the current
contents of the log file to this file and then clears the
log file. You can also request a backup at any time
using the SET_LOG_FILE verb.
If no path is included, the file is stored in the default
directory for diagnostics files, /var/opt/sna; if a path
is included, this is either a full path (starting with a /
character) or the path relative to the default directory.
file_size
The maximum size of the log file specified by
log_file_type
. When a message written to the file
causes the file size to exceed this limit, SNAplus2
clears the backup log file, copies the current contents of
the log file to the backup log file, and then clears the log
file. This means that the maximum amount of disk
space taken up by log files is approximately twice the
value of
file_size
.
Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2
returns the following parameters: