HP-UX SNAplus2 MS Programmer's Guide
5
Contents
1. Introduction to Management Services
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
SNA Management Services Support Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
SNAplus2 Management Services Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Management Services Application Programming Interface . . . . . . . . . . . . . . . . . . . . . 24
Management Services Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
MS Applications That Only Send Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
MS Applications That Both Send and Receive Data. . . . . . . . . . . . . . . . . . . . . . . . . . 25
NMVT Routing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2. Writing MS Applications
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Description of the MS API Entry Points. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Synchronous Entry Point: ms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Asynchronous Entry Point: ms_async . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
The Callback Routine Speciļ¬ed on the ms_async Entry Point . . . . . . . . . . . . . . . . . 38
Scope of Target Handle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Scheduling Asynchronous Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Single-Threaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Multithreaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Motif Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Compiling and Linking the MS Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Back Level Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Linking Motif Applications and Applications That Use Application Scheduled Mode.
48
Linking Multithreaded Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3. Management Services Verbs
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
CONNECT_MS_NODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
VCB Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Supplied Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Returned Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
DISCONNECT_MS_NODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
VCB Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Supplied Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56