HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_LU_LU_PASSWORD
verification_protocol
Requested LU-LU verification protocol to use. Possible values are:
AP_BASIC
Use basic LU-LU verification protocols.
AP_ENHANCED
Use enhanced LU-LU verification protocols.
AP_EITHER
Basic or enhanced verification is accepted.
description
A null-terminated text string (0–31 characters followed by a null character) describing the password.
This string is for information only; it is stored in the node’s configuration file and returned on the
QUERY_LU_LU_PASSWORD verb, but SNAplus2 does not make any other use of it.
password
Password. This is an 8-byte hexadecimal string, which must not be set to all blanks or all zeros. It must
match the equivalent parameter configured for the partner LU on the remote system (except that the least
significant bit of each byte is not used in session-level security verification and does not need to match).
Whatever value the application supplies for this parameter is immediately replaced by the encrypted version
of the password. Therefore, the value supplied for the
password parameter is never written out.
3.34.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.34.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_LU_ALIAS
The lu_alias parameter did not match any defined LU alias.
AP_INVALID_LU_NAME
The lu_name parameter did not match any defined local LU name.
AP_INVALID_PLU_NAME
The fqplu_name parameter did not match any defined partner LU name.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
208