HP-UX SNAplus2 R7 NOF Programmer's Guide

Appendix BCommon Return Codes
If the application has registered using REGISTER_INDICATION_SINK to receive configuration indications or
SNA network file indications, SNAplus2 sends an indication each time another NOF API application or a SNAplus2
component modifies the target file or the target node’s configuration. The format of this indication is the same as
the returned VCB for the NOF verb that modified the configuration. SNAplus2 sets this primary return code to
indicate that the VCB being returned is a configuration indication or an SNA network file indication, rather than
the response to a verb issued by the application; this enables the application to distinguish between its own verb
returns and indications resulting from verbs issued by other applications.
primary_rc
AP_INDICATION
secondary_rc
Possible values are:
AP_EXTRA_DATA_LOST
SNAplus2 was unable to allocate sufficient storage to return the complete VCB for this indication; the
returned information is incomplete. The application should issue the appropriate QUERY_* verb to
obtain more information about the modified component.
(zero)
The complete VCB for this indication is being returned.
B.3 Invalid Function
If the verb does not execute because the node does not recognize it as a valid verb, SNAplus2 returns the following
parameters:
primary_rc
AP_INVALID_VERB
The opcode parameter was not set to the operation code of any NOF verb, or the verb identified by this
parameter cannot be used because this version of SNAplus2 does not support it.
secondary_rc
Not used.
primary_rc
AP_FUNCTION_NOT_SUPPORTED
The NOF verb identified by the specified opcode parameter cannot be used because the target node’s
configuration does not support it.
secondary_rc
Not used.
B.4 Invalid Verb Segment
WINDOWS
If the verb does not execute because the VCB was not contained within a data segment, SNAplus2 returns the
following parameters:
primary_rc
822