HP-UX SNAplus2 MS Programmer's Guide

Management Services Verbs
REGISTER_NMVT_APPLICATION
Chapter 3 65
REGISTER_NMVT_APPLICATION
The REGISTER_NMVT_APPLICATION verb registers the MS
application with SNAplus2 as an NMVT-level application that can
receive NMVTs. This verb is normally used by an NMVT-level
application, but it can also be used by an MDS-level application that can
receive NMVTs after they have been converted to MDS_MUs. Before
issuing this verb, the application must issue CONNECT_MS_NODE to
obtain a target handle for the SNAplus2 node. This handle is a required
parameter to the MS entry point for
REGISTER_NMVT_APPLICATION.
An application must always issue this verb using the asynchronous MS
entry point and supply a callback routine. SNAplus2 uses this callback
routine to return received NMVTs to the application. For more
information about the MS entry points, see Chapter 2, “Writing MS
Applications.”
SNAplus2 routes an NMVT to this application only if both the
destination name and the MS major vector key in the NMVT match the
values supplied on this call. For more information, see “NMVT Routing”.
VCB Structure
typedef struct register_nmvt_application
{
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 char ms_appl_name[8]; /* MS application name */
unsigned short ms_vector_key_type; /* MS vector key accepted by appl */
unsigned char conversion_required; /* MDS level application requesting */
/* MDS_MUs */
} REGISTER_NMVT_APPLICATION;
Supplied Parameters
An application supplies the following parameters when it issues the
REGISTER_NMVT_APPLICATION verb: