HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
QUERY_CPIC_SIDE_INFO
As for
XC_SECURITY_PROGRAM, except that the local node must not send the password across the
network in clear text format. This value can be used only if the remote system supports password
substitution.
XC_SECURITY_SAME
The target TP uses conversation security, and can accept an “already verified” indicator from the local
TP. (This indicates that the local TP was itself invoked by another TP, and has verified the security user
ID and password supplied by this TP.) The
security_user_id parameter specified below will be used to
access the target TP; no password is required.
cpic_side_info_data.def_data.side_info.security_user_id
User ID used to access the partner TP. This parameter is not used if the conversation_security_type parameter
is set to
XC_SECURITY_NONE.
cpic_side_info_data.def_data.side_info.security_password
Password used to access the partner TP. This parameter is used only if the conversation_security_type
parameter is set to
XC_SECURITY_PROGRAM
or XC_SECURITY_PROGRAM_STRONG.
cpic_side_info_data.def_data.side_info.lu_alias
The alias of the local LU used to communicate with the target TP. This alias is a character string using any
locally displayable characters.
3.103.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
AP_INVALID_LIST_OPTION
The list_options 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.103.5 Returned Parameters: State Check
If the verb does not execute because of a state error, SNAplus2 returns the following parameters.
primary_rc
AP_STATE_CHECK
secondary_rc
AP_INVALID_SYM_DEST_NAME
The list_options parameter was set to AP_LIST_INCLUSIVE, to list all entries starting from the
supplied name, but the sym_dest_name parameter was not valid.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_STATE_CHECK
, which
are common to all NOF verbs.
3.103.6 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.
385