HP-UX SNAplus2 NOF Programmer's Guide

Writing NOF Applications
Target For NOF Verbs
Chapter 2 107
This is the default mode when the target handle is first
assigned; it enables the application to check the
configuration or status of a resource but not to change
it.
AP_READ_WRITE All NOF verbs are enabled in this mode, including
those that change a resource's configuration or status.
AP_COMMIT This mode is only available if the target handle
identifies the domain configuration file (not when
issuing verbs to a node). It obtains a lock on the file so
that only this application can access it; this file lock
ensures that the file will not be modified by any other
process during a sequence of verbs issued by this
application. The file lock also ensures that no changes
are made to the file until the complete sequence of
verbs has been issued (until the application changes
from AP_COMMIT mode to one of the other modes).
Because this mode prevents any other program from
accessing the file, it should be used only for as long as
necessary. The application should immediately issue all
the verbs that it requires to modify the file and then
change to one of the other modes.
If the file lock cannot be obtained (for example, because
another program is currently modifying the file), the
SET_PROCESSING_MODE verb will fail.