HP-UX SNAplus2 MS Programmer's Guide

Management Services Verbs
Overview
Chapter 350
Overview
For each MS verb, this chapter provides the following information:
• Purpose and usage of the verb.
• Verb Control Block (VCB) structure used by the verb. All the VCB
structures are defined in the header file ms_c.h.
• Supplied parameters (VCB fields supplied to the verb). For each
parameter, the following information is listed:
— Description
— Valid values and their meanings
— Additional information where necessary
• Returned parameters. When a verb completes, it contains the
following returned parameters:
primary_rc
This parameter indicates whether the verb
completed successfully. If the verb did not complete
successfully, this parameter indicates a category of
reasons for unsuccessful execution.
secondary_rc
This parameter indicates a specific reason for
unsuccessful execution.
In addition, some verbs have additional returned parameters.
Many of the supplied and returned parameter values are numeric. To
simplify coding, make the applications more portable, and make the
program source easier to read, these values are represented by symbolic
constants defined in the header file ms_c.h. For example, the opcode
(operation code) parameter for the SEND_MDS_MU verb is the value
represented by the symbolic constant AP_SEND_MDS_MU.
Because different systems store these values differently in memory, it is
important that you use the symbolic constant, and not the numeric
value, when setting values for supplied parameters or when testing
values of returned parameters. The value shown in the header file may
not be in the format recognized by your system.