HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_ADJACENT_LEN_NODE
For each alert, up to the number specified in num_alerts,an
alert_3270_data
structure is required with the following
information:
alert_3270_data.description
A text description of the alert. This is an ASCII string of 1–52 characters, followed by a null character.
This description is displayed in the 3270 user interface, to identify the alert to the user. It is not sent to
NetView; the NetView operator identifies the alert by its number.
alert_3270_data.parameter1
through alert_3270_data.parameter3
Text strings describing any parameters that the user should enter for the alert. Each one is an ASCII string
of 1–32 characters, followed by a null character.
Check with the NetView administrator at the host to determine the parameters required for each alert. An
alert may not require all three parameters; if so, specify a null string for any parameters that are not required.
The user will only be prompted for a parameter if you specify a description for it.
3.11.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.11.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_RTM_THRESHOLD
One or more of the supplied RTM threshold values was not in the permitted range, or the values were
not in ascending order.
AP_INVALID_RTM_TIMER_OPTION
The rtm_timer_option parameter was not set to a valid value.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK
,
which are common to all NOF verbs.
3.11.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.12 DEFINE_ADJACENT_LEN_NODE
DEFINE_ADJACENT_LEN_NODE adds entries to the node directory database for an adjacent LEN node and its
associated LUs, or adds additional LU entries for a previously-defined LEN node.
108