High Availability Monitors Version A.03.02 Release Notes

Contents
6
NOF Status Indications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
2. Writing NOF Applications
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Description of the NOF API Entry Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Synchronous Entry Point: nof . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Asynchronous Entry Point: nof_async. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
The Callback Routine Specified on the nof_async Entry Point . . . . . . . . . . . . . . . . . 96
Scope of Target Handle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Scheduling Asynchronous Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Single-Threaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Multithreaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Motif Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Compiling and Linking the NOF Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Linking Motif Applications and Applications That Use Application Scheduled Mode.
104
Linking Multithreaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Target For NOF Verbs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Processing Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Ordering and Dependencies between NOF Verbs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
NOF Restrictions Based on Node Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
APPN LEN Node Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Multiple Domain Support (MDS) Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
PU Concentration and DLUR Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
DLUR Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
List Options For QUERY_* Verbs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Obtaining Information about a Single Resource or Multiple Resources . . . . . . . . . 112
Obtaining Summary or Detailed Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
3. NOF API Verbs (ACTIVATE_SESSION to OPEN_FILE)
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
ACTIVATE_SESSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
VCB Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Supplied Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Returned Parameters: Successful Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Returned Parameters: Parameter Check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120