HP-UX SNAplus2 MS Programmer's Guide

Management Services Verbs
REGISTER_MS_APPLICATION
Chapter 3 59
REGISTER_MS_APPLICATION
The REGISTER_MS_APPLICATION verb registers the MS application
with SNAplus2 as an MDS-level application that can receive 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_MS_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 MDS_MUs to the application. For more
information about the MS entry points, see Chapter 2, “Writing MS
Applications.”
VCB Structure
typedef struct register_ms_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 char ms_category[8]; /* MS category */
unsigned short max_rcv_size; /* Maximum size that can be received */
} REGISTER_MS_APPLICATION;
Supplied Parameters
The application supplies the following parameters when it issues the
REGISTER_MS_APPLICATION verb:
opcode
AP_REGISTER_MS_APPLICATION
ms_appl_name