HP-UX SNAplus2 NOF Programmer's Guide

NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
OPEN_FILE
Chapter 3 495
file_info.role_supplied
If requested_role was set to AP_BACKUP, this
parameter indicates whether the file handle returned
is for the master configuration file or a backup file.
Possible values are:
AP_MASTER
Master configuration file.
AP_BACKUP
Backup configuration file.
For all other values of requested_role , this
parameter is undefined.
file_info.system_name
Name of the SNAplus2 computer where the file is
located.
file_info.file_name
Name of the file. This parameter is an ASCII string of
1-80 characters, followed by a null (0x00) character.
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 Possible values are:
AP_INVALID_FILE_NAME
The file_name parameter did not
specify a valid configuration file
name.
AP_INVALID_FILE_INFO
One of the parameters in the
file_info structure was not valid.
Appendix A, “Common Return Codes,” lists further secondary return
codes associated with AP_PARAMETER_CHECK, which are common to all
NOF verbs.