Conversation Security (CPI-C)

You can use conversation security to require that the invoking transaction program (TP) provides a user identifier and password before Common Programming Interface for Communications (CPI-C) allocates a conversation with the invokable TP.

For the invoking TP, conversation security is activated and configured (with user identifier and password) through the symbolic destination name in SNA Manager or by the following calls, which override the symbolic destination name:

  • Set_Conversation_Security_Type

  • Set_Conversation_Security_User_ID

  • Set_Conversation_Security_Password

    For the invokable TP, conversation security is activated and configured through registry or environment variables on the computer where the invokable TP is located.

    With communication involving more than two TPs, the verification of a user identifier and password can be passed from one TP to another. Suppose that TP A invokes TP B, which requires security information, and TP B in turn invokes TP C, which also requires security information. TP B can inform TP C that conversation security has already been verified.

    For information about the registry or environment variables affecting conversation security, see Configuring Invokable TPs. For information about symbolic destination names and side information, see Side Information for CPI-C Programs.