HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Set_Conversation_Security_Password (cmscsp)
Chapter 3234
• The conversation's security type
is not set to
CM_SECURITY_PROGRAM or
CM_SECURITY_PROGRAM_ST
RONG
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.”
State When Issued
The conversation must be in Initialize state.
State Change
There is no state change.
Usage Notes
A user ID is required in addition to the password. This can be obtained
from the side information entry specified on the previous
Initialize_Conversation call, or the program can specify it using
Set_Conversation_Security_User_ID.
A password that is not valid is not detected until the allocation request,
generated by the Allocate call, is sent to the partner LU. The error is
returned to the invoking program on a subsequent call.
If the return code is not CM_OK, the security_password and
security_password_length conversation characteristics are
unchanged.