HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
SET_PROCESSING_MODE
3.181 SET_PROCESSING_MODE
This verb specifies how the NOF application interacts with the target node, configuration file, or SNA network data
file: whether the application has read-only access or read/write access, and whether the application has exclusive
access to the domain configuration file so that other applications cannot access it.
This verb applies only to NOF applications running on a server. For an application running on a client, the only
processing mode available is read-only mode (the default), in which the application can issue QUERY_* verbs but
cannot define, start or stop resources. The client application cannot use SET_PROCESSING_MODE to select any
other mode.
The target node or file is specified by the
target_handle parameter on the NOF API call; the application obtains this
parameter from the verb CONNECT_NODE (for a node) or OPEN_FILE (for a file). For more information about
the use of this parameter, see Section 2.1.1, NOF API Entry Points for HP-UX.
This verb may be issued to the domain configuration file, to the
sna.net file, or to a running node. The valid
processing modes that can be set with this verb depend on the target type.
3.181.1 VCB Structure
typedef struct set_processing_mode
{
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 */
unsigned char mode; /* new mode to be set for this handle */
AP_UINT16 reserv1; /* reserved */
} SET_PROCESSING_MODE;
3.181.2 Supplied Parameters
opcode
AP_SET_PROCESSING_MODE
mode
Requested mode for this target handle. The mode cannot be changed while any previous verbs issued using
this target handle are still outstanding. Possible values are:
AP_MODE_READ_ONLY
Read-only mode: the application will use only QUERY_* verbs, which do not modify the configuration.
This option can be used with either a file or a node as the target.
AP_MODE_READ_WRITE
Read / write mode: the application may use any NOF API verbs. This option can be used with either
a file or a node as the target.
AP_MODE_COMMIT
Commit mode: the application has exclusive read/write access to the target file, so that other applications
cannot access it until this application releases it. This option can be used only with the domain
configuration file as the target.
This mode is intended for issuing a series of connected verbs to a file (such as a series of DEFINE verbs
for related components). The application should complete the series of verbs as quickly as possible
723