HP-UX SNAplus2 MS Programmer's Guide

Management Services Indications

MS_STATUS

Chapter 4104

MS_STATUS

SNAplus2 sends this status indication to a registered application (either

MDS-level or NMVT-level) to inform the application of one of the

following changes in the status of the SNAplus2 system:

• The application's communications path to the SNAplus2 local node

has been lost because the connected node or an associated component

is no longer active.

• The SNAplus2 software has been stopped.

SNAplus2 returns the MS_STATUS indication on the callback routine

that the application supplied to the REGISTER_MS_APPLICATION or

REGISTER_NMVT_APPLICATION verb. For more information about

the requirements for this callback routine, see “The Callback Routine

Speciﬁed on the ms_async Entry Point”.

After the application receives the MS_STATUS indication, SNAplus2

rejects all subsequent verbs using the relevant target handle, except for

DISCONNECT_MS_NODE.

VCB Structure

typedef struct ms_status

{

unsigned short opcode; /* Verb operation code */

unsigned char reserv2; /* reserved */

unsigned char format; /* reserved */

unsigned short primary_rc; /* Primary return code */

unsigned long secondary_rc; /* Secondary return code */

unsigned long status; /* status being reported */

unsigned long dead_target_handle; /* Handle of dead connection */

unsigned char reserv1[32]; /* reserved */

} MS_STATUS;

Parameters

SNAplus2 includes the following parameters when it sends the

MS_STATUS indication to the MS application:

opcode