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

CPI-C Calls

Extract_Conversation_Security_Type (xcecst)

Chapter 3 159

Extract_Conversation_Security_Type (xcecst)

This function is not available in Java CPI-C.

The Extract_Conversation_Security_Type call returns the security type

for a speciﬁed conversation.

This call is provided for compatibility with X/Open CPI-Cand with the

Windows CPI-C speciﬁcation; it is not included in IBM CPI-C 2.0.

Function Call

void xcecst (

unsigned char CM_PTR conversation_ID,

XC_CONVERSATION_SECURITY_TYPE CM_PTR conversation_security_type,

CM_RETURN_CODE CM_PTR return_code

);

Supplied Parameters

The supplied parameter is:

conversation_ID

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

this parameter was returned by the

Initialize_Conversation, Initialize_For_Incoming, or

Accept_Conversation call.

Returned Parameters

After the verb executes, SNAplus2 returns the following parameters:

conversation_security_type

This speciﬁes the information the

partner LU requires in order to validate access to the

invoked program. Possible values are:

For Unix CM_SECURITY_NONE The invoked program uses no

conversation security.

CM_SECURITY_SAME This value is used when the

invoked program, which has been

invoked with a valid user ID and

password, invokes another program

(as illustrated in Chapter 1,