HP-UX SNAplus2 Upgrade Guide (June 2003)

Porting Application Programs

NM-API

Chapter 3 43

NM-API

The NM-API is replaced by the MS API, which provides a much wider

range of functions. An NM-API application must be rewritten to use the

appropriate MS verbs.

The following paragraphs provide information about the mapping

between NM-API verbs and the equivalent MS verbs, depending on the

function required by the application. For more information about the MS

verbs described here, including error return codes, refer to the HP-UX

SNAplus2 MS Programmers Guide.

Sending NMVTs Without Requesting

Acknowledgement

If the NM-API application uses the NM_SEND verb to send NMVTs

without requesting acknowledgment, and does not use the

NM_RECEIVE verb to receive NMVTs, the only MS verb required is

TRANSFER_MS_DATA (which replaces the NM_SEND verb). The

parameters for TRANSFER_MS_DATA should be set as follows:

data_type

SV_NMVT

options

Set bits 0–3 of this parameter as follows:

Bit 0 Set to 1 (do not add Date/Time

Subvector)

Bit 1 Set to 1 (do not add Product Set ID

Subvector)

Bit 2 Set to 0 (send the NMVT to the

remote system)

Bit 3 Set to 0 (log the data in the SNAplus2

error log ﬁle)

Bits 4–7 are reserved, and must be set to 0.

originator_id

The

origintr_id

parameter from the NM_OPEN verb

that preceded the NM_SEND verb.

pu_name

Set this parameter to eight binary zeros.

dlen

The

datalength

parameter from the NM_SEND verb.