HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
CLOSE_FILE
primary_rc
AP_CONV_FAILURE_NO_RETRY
The session limits could not be changed because of a condition that requires action (such as a
configuration mismatch or a session protocol error). Check the SNAplus2 log file for information
about the error condition, and correct it before retrying this verb.
primary_rc
AP_CNOS_PARTNER_LU_REJECT
secondary_rc
AP_CNOS_COMMAND_RACE_REJECT
The verb failed because the specified mode was being accessed by another administration program
(or internally by the SNAplus2 software) for session activation or deactivation, or for session limit
processing. The application should retry the verb, preferably after a timeout to allow the race condition
to be cleared.
3.5.8 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.6 CLOSE_FILE
An application uses this verb to release its handle to the domain configuration file, or to the sna.net file, when
it has finished issuing NOF verbs to the file. The file which the application wishes to close is identified by the
target_handle parameter on the call.
The application should always issue CLOSE_FILE for any open file handles before it exits. After the verb com-
pletes successfully, the target handle identifying the file is no longer valid.
This verb must be issued to the domain configuration fileor to the sna.net file.
3.6.1 VCB Structure
typedef struct close_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 */
} CLOSE_FILE;
3.6.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_CLOSE_FILE
97