HP-UX SNAplus2 MS Programmer's Guide

Management Services Indications

FP_NOTIFICATION

Chapter 4 99

FP_NOTIFICATION

SNAplus2 sends this status indication to an MDS-level application that

has requested information about the focal point for a particular MS

category. The application requests this information by issuing

REGISTER_MS_APPLICATION with the name of a particular MS

category speciﬁed as part of the focal point data string. SNAplus2 sends

FP_NOTIFICATION to inform the application of its current focal point

for that category. Each time the focal point changes, SNAplus2 sends

another FP_NOTIFICATION.

This indication is returned using the callback routine that the

application supplied on the REGISTER_MS_APPLICATION verb. For

more information about the requirements for this callback routine, see

“The Callback Routine Speciﬁed on the ms_async Entry Point”.

VCB Structure

typedef struct fp_notification

{

unsigned short opcode;

unsigned char reserv2; /* reserved */

unsigned char format; /* reserved */

unsigned short primary_rc; /* Primary return code */

unsigned long secondary_rc; /* Secondary return code */

unsigned char fp_routing; /* routing to use with this focal point */

unsigned char reserv1; /* reserved */

unsigned short fp_data_length; /* Length of incoming focal point data */

unsigned char *fp_data; /* Focal point data */

} FP_NOTIFICATION;

Parameters

SNAplus2 includes the following parameters when it sends

FP_NOTIFICATION to an MDS-level application:

opcode

AP_FP_NOTIFICATION

fp_routing