HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_LOG_FILE
AP_AUDIT_FILE
Audit log file (audit messages only).
AP_ERROR_FILE
Error log file (problem and exception messages).
AP_USAGE_FILE
Usage log file (information on current and peak usage of SNAplus2 resources).
3.127.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
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.
3.127.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_FILE_TYPE
The log_file_type parameter was not set to a valid value.
486