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

CPI-C Calls
Extract_Conversation_Security_Type (xcecst)
Chapter 3160
“Concepts.” If program A invokes
program B with a valid user ID and
password, and program B in turn
invokes program C, then if program B
specifies the value
CM_SECURITY_SAME, CPI-C will send
an already-verified indicator to the
LU for program C.This indicator tells
program C not to require the
password (if program C is configured
to accept an already-verified
indicator).
CM_SECURITY_PROGRAM The invoked program uses
conversation security and thus
requires a user ID and password.
CM_SECURITY_PROGRAM_STRONG As for
CM_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.
For Windows XC_SECURITY_NONE Equivalent to CM_SECURITY_NONE
XC_SECURITY_SAME Equivalent to CM_SECURITY_SAME
XC_SECURITY_PROGRAM Equivalent to
CM_SECURITY_PROGRAM
End of Section return_code Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID is not valid.
State When Issued
The conversation can be in any state except Reset.