HP-UX SNAplus2 MS Programmer's Guide

Management Services Indications
Overview
Chapter 498
Overview
For each indication, this chapter provides the following information:
• Purpose of the indication, and the conditions in which SNAplus2
returns it to an application.
• Description of the indication. For consistency, the term verb control
block (VCB) is used to describe the indications, although this
structure is not associated with a verb issued by the application. All
the VCB structures are defined in the header file ms_c.h.
• For each parameter in the VCB structure, the following information
is listed:
— Description
— Values that can be returned and their meanings
— Additional information where necessary
Many of the supplied and returned parameter values are numeric. To
simplify coding, make the applications more portable, and make the
program source easier to read, these values are represented by symbolic
constants defined in the header file ms_c.h. For example, the opcode
(operation code) parameter for the FP_NOTIFICATION indication is the
value represented by the symbolic constant AP_FP_NOTIFICATION.
Because different systems store these values differently in memory, it is
important that you use the symbolic constant, and not the numeric
value, when setting values for supplied parameters or when testing
values of returned parameters. The value shown in the header file may
not be in the format recognized by your system.
NOTE Although the application allocates the VCBs for MS verbs, SNAplus2
allocates the VCBs for indications. Therefore, the application has access
to the VCB information only from within the callback routine; the VCB
pointer that SNAplus2 supplies to the callback routine is not valid
outside the callback routine. The application must either complete all the
required processing from within the callback routine, or it must make a
copy of any VCB data that it needs to use outside this routine.