HP-UX SNAplus2 Upgrade Guide (June 2003)

Porting Application Programs
NM-API
Chapter 344
dptr The dptr parameter from the NM_SEND verb.
The NM_OPEN and NM_CLOSE verbs are no longer required, and must
be removed.
Sending and Receiving NMVTs, Acknowledgements,
or Both
If the NM-API application uses the NM_RECEIVE verb to receive
NMVTs, or if it issues NM_SEND with the options parameter set to
request an acknowledgment from the host and then uses NM_RECEIVE
to receive the response, it must be redesigned to use the asynchronous
receive mechanism provided by the MS API. The following paragraphs
explain how each verb in the original application should be replaced by
MS verbs.
NM_OPEN
The NM_OPEN verb must be replaced by the CONNECT_MS_NODE
and REGISTER_NMVT_APPLICATION verbs. The parameters to these
verbs should be set as follows:
CONNECT_MS_NODE
node_name Name of the SNAplus2 node to
connect to. For the stand-alone
version of SNAplus2, you can set this
parameter to all binary zeros; you do
not need to specify the node name.
For the client/server version, setting
this parameter to all binary zeros
indicates the default local node (on
the same SNAplus2 server as the
application).
REGISTER_NMVT_APPLICATION
ms_appl_name
The origintr_id parameter that
was supplied to the NM_OPEN verb.
ms_vector_key_type
Set this parameter to AP_ALL_KEYS
(to accept all major vector keys).