HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_LOG_FILE
3.179.1 VCB Structure
typedef struct set_log_file
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char log_file_type; /* type of log file */
unsigned char action; /* reset and/or backup existing */
unsigned char file_name[81]; /* file name */
unsigned char backup_file_name[81]; /* backup file */
AP_UINT32 file_size; /* log file size */
unsigned char succinct; /* reserved */
unsigned char reserv3[3]; /* reserved */
} SET_LOG_FILE;
3.179.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_SET_LOG_FILE
log_file_type
The type of log file being managed. Possible values are:
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).
To record both audit and error messages in the same file, issue two SET_LOG_FILE verbs for the same file
name, specifying AP_AUDIT_FILE on one verb and AP_ERROR_FILE on the other.
action
The action to be taken on the log file. Specify one of the following values:
AP_NO_FILE_ACTION
Use the file specified in the file_name parameter as the log file, and the file specified in the
backup_file_name parameter as the backup file. After this verb completes successfully, all log messages
of the type defined by log_file_type are written to the new log file. The log file that was used before
this verb is issued, if any, is left unchanged.
AP_DELETE_FILE
Delete the contents of the current log file.
AP_BACKUP_FILE
Copy the contents of the current log file to the backup file, and then delete the contents of the current
file.
file_name
718