HP-UX SNAplus2 MS Programmer's Guide

Management Services Verbs
TRANSFER_MS_DATA
Chapter 3 85
dlen
Length of the data supplied by the application.
The maximum length of an NMVT is 512 bytes. If the
application is supplying a complete NMVT, the data
length must not exceed 512 bytes. If the application is
supplying alert subvectors, or requesting SNAplus2 to
add one or more subvectors to the supplied data, the
total length after addition of any required headers and
subvectors must not exceed 512 bytes.
dptr
A pointer to the data string supplied by the application.
The data must be in the valid format for an NMVT,
alert subvectors, or problem determination statistics,
as specified by the
data_type
parameter.
Returned Parameters
After the verb executes, SNAplus2 returns parameters to indicate
whether the execution was successful and, if not, to indicate the reason
the execution was not successful.
Successful Execution
If the verb executes successfully, SNAplus2 returns the following
parameters:
primary_rc
SV_OK
SNAplus2 does not return a
secondary_rc
when the verb executes
successfully.
Unsuccessful Execution
When a verb does not execute successfully, SNAplus2 returns a primary
return code to indicate the type of error and a secondary return code to
provide specific details about the reason for unsuccessful execution.
Parameter Check If the verb does not execute because of a parameter
error, SNAplus2 returns the following parameters:
primary_rc