HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF Indications
NOF_STATUS_INDICATION
The TG type is unknown.
4.18 NOF_STATUS_INDICATION
This indication is generated when the application can no longer access its connected target (because the SNAplus2
software on the target computer has been stopped, or because the communications path to the target computer has
failed). If the target is the domain configuration file, it is also generated if another server takes over as master (and
therefore the connected target file is no longer the master copy of the file).
The application does not need to register explicitly for this indication. SNAplus2 will return it to any application
that has registered for any type of indications on the specified target handle. If the application is currently registered
to receive indications using more than one callback routine, SNAplus2 returns this indication to the first routine
registered.
After the application receives an indication that the target can no longer be accessed, all subsequent verbs using the
relevant target handle will be rejected, apart from DISCONNECT_NODE or CLOSE_FILE (to end the application’s
connection to the target). In addition, any registrations for indications on this target handle will be lost; in order to
continue receiving indications when the target becomes available, the application must reconnect to the target and
reregister for the required indications.
4.18.1 VCB Structure
typedef struct nof_status_indication
{
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 */
AP_UINT32 status; /* status being reported */
AP_UINT32 dead_target_handle; /* Handle of dead connection */
/* NULL for system termination */
unsigned char reserv1[32]; /* reserved */
} NOF_STATUS_INDICATION;
4.18.2 Parameters
opcode
AP_NOF_STATUS_INDICATION
primary_rc
AP_OK
status
Specifies the status change being reported. Possible values are:
AP_LOCAL_ABENDED
The SNAplus2 software on the local computer has stopped. The application should not attempt to issue
any more NOF verbs until the software has been restarted.
AP_TARGET_ABENDED
The SNAplus2 software on the target computer has stopped or the communications path to it has failed.
AP_MASTER_TAKEOVER
793