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

CPI-C Calls

Set_Conversation_Security_User_ID (cmscsu)

Chapter 3240

Set_Conversation_Security_User_ID (cmscsu)

The Set_Conversation_Security_User_ID call is issued by the invoking

program to specify the user ID required to access to the invoked

program. It overrides the initial user ID from the side information

speciﬁed by the Initialize_Conversation call.

This call cannot be issued after the Allocate call has been issued. This

call is not valid if the conversation security type is

CM_SECURITY_NONE (HP-UX systems)or XC_SECURITY_NONE

(Windows systems).

Function Call

void cmscsu (

unsigned char CM_PTR conversation_ID,

unsigned char CM_PTR security_user_ID,

CM_INT32 CM_PTR security_user_ID_length,

CM_RETURN_CODE CM_PTR return_code

);

Function Call for Java CPI-C

public native void cmscsu (

byte[] conversation_ID,

byte[] security_user_ID

CPICLength security_user_ID_length,

CPICReturnCode return_code

);

Supplied Parameters

The supplied parameters are:

conversation_ID

This is the identiﬁer for the conversation. The value of

this parameter is returned by the

Initialize_Conversation call.

security_user_ID

This speciﬁes the user ID required to access the

partner program. This parameter is a character string

of 1–10 characters (HP-UX systems), or 1–8 characters

(Windows systems), and is case-sensitive.