HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF Indications
SERVER_INDICATION
and flags parameters for changes; it can ignore any server indications where these parameters do not indicate a
change.
The REGISTER_INDICATION_SINK verb used to register for server indications should be issued with a null target
handle; it is not associated with any particular target.
4.24.1 VCB Structure
typedef struct server_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 */
unsigned char data_lost; /* previous indication lost */
AP_UINT32 status; /* node status */
AP_UINT32 flags; /* is server master or backup? */
unsigned char server_name[128]; /* name of server */
} SERVER_INDICATION;
4.24.2 Parameters
opcode
AP_SERVER_INDICATION
primary_rc
AP_OK
data_lost
Specifies whether any previous server indications have been lost. If SNAplus2 detects a condition that pre-
vents it from sending an indication (for example an internal resource shortage), it indicates this by setting the
data_lost parameter on the next indication after the condition has cleared. Possible values are:
AP_YES
One or more previous server indications were lost. Later fields in this VCB may be set to zeros.
AP_NO
No previous server indications were lost.
status
Specifies the status of the SNA software on the indicated server. Possible values are:
AP_ACTIVE
The SNA software has been started.
AP_NOT_ACTIVE
The SNA software has been stopped.
flags
Specifies whether the indicated server is the master server or a backup server. The application should use a
logical
AND operation to check the appropriate values, as follows:
• If the expression “flags AND
AP_MASTER_FLAG” is nonzero, the indicated server is the master server.
• If the expression “flags AND
AP_BACKUP_FLAG” is nonzero, the indicated server is a backup server.
server_name
806