HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
OPEN_FILE
typedef struct config_file
{
unsigned char requested_role; /* config file requested */
unsigned char role_supplied; /* config file returned */
unsigned char system_name[128]; /* computer name where file */
/* located */
unsigned char file_name[81]; /* file name */
} CONFIG_FILE;
3.85.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_OPEN_FILE
file_info.requested_role
The type of file to be opened. Possible values are:
AP_MASTER
Open the master copy of the domain configuration file. This value must be used if the application
intends to issue verbs that modify the configuration of domain resources.
AP_BACKUP
Open the master copy of the domain configuration file if available, otherwise a backup copy. This
value may be used if the application intends to issue only QUERY_* verbs; if it needs to modify the
configuration, it must use AP_MASTER, because it will not be able to obtain write access to a backup
configuration file.
AP_SNA_NET
Open the sna.net file on the master server.
AP_TP_LOAD_INFO
Open a connection to the file on the local machine that contains information about how to load transaction
programs (TPs).
3.85.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
target_handle
Returned value for use on subsequent verbs directed to this file.
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.
327