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

CPI-C Calls
Extract_Security_User_ID (cmesui or cmecsu)
Chapter 3182
security_user_ID
This specifies the user ID used to establish the
conversation.
security_user_ID_length
This specifies the length of
security_user_ID
.
The range for this value is 1–10 characters (HP-UX
systems), or 1–8 characters (Windows systems). If the
security_user_ID_length
is set to 0 (zero), the
security_user_ID_length
parameter is ignored; this
is equivalent to setting
security_user_ID
to a null
string.
return_code
Possible values are:
CM_OK The call executed successfully.
CM_PROGRAM_PARAMETER_CHECK The value specified by
conversation_ID
is not valid.
CM_PRODUCT_SPECIFIC_ERROR For an explanation of
this return code, see Appendix A,
“Common Return Codes.
State When Issued
The conversation can be in any state except Reset.
State Change
There is no state change.
Usage Notes
The
security_user_ID
value is not blank-padded. It is meaningful only
up to
security_user_ID_length
.