HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_PROCESSING_MODE
and then reset its processing mode to one of the other options, in order to release the file so that other
NOF API applications or SNAplus2 components can access it.
Note
To obtain read/write access to the file, your NOF application must be running with a
user ID that is a member of the SNA administrators group sna. If the user ID is not
a member of this group, the only valid processing mode is AP_MODE_READ_ONLY.
3.181.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
secondary_rc
Not used.
3.181.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
Possible values are:
AP_INVALID_PROC_MODE
The mode parameter was not set to a valid value.
AP_INVALID_TARGET_MODE
The mode parameter was not valid for the selected target.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
3.181.5 Returned Parameters: State Check
If the verb does not execute because of a state check, SNAplus2 returns the following parameters.
primary_rc
AP_STATE_CHECK
secondary_rc
Possible values are:
AP_FILE_UNAVAILABLE
The application specified commit mode, but was unable to get exclusive access to the required
configuration file. This may be because another application is accessing the file in commit mode.
AP_VERB_IN_PROGRESS
The processing mode for the specified target handle cannot be changed because a previous verb issued
for this handle is still outstanding. All verbs for the target handle must be completed before attempting
to change the processing mode.
724