Set_Partner_Tsel - Setting the T-SEL of the partner application

The Set_Partner_Tsel (CMSPT) call sets the value for the T-SEL characteristic of the partner application of the conversation. The call overwrites the value assigned using the Initialize_Conversation call. After the Allocate call, this call may no longer be issued.

This function is one of the additional functions of the UPIC carrier system; it is not a component of the CPI-C interface.

UPIC-Local on Unix, Linux and Windows systems:

Connection via UPIC local does not support the Set_Partner_Tsel call.

Syntax

CMSPT (conversation_ID, transport_selector, transport_selector_length, return_code)

Parameters

--> conversation_ID	Conversation identifier
--> transport_selector	Transport selector of the partner application which is transferred to the communication system.
--> transport_selector_length	Length of the transport selector in bytes. Minimum: 0, maximum: 8 If the length of the transport selector is entered as 0, the first name part of the partner_LU_name is used as the transport selector.
<-- return_code	Result of the function call.

Result (return_code)

CM_OK

The call is OK.

CM_CALL_NOT_SUPPORTED

This return code only applies to Unix, Linux and Windows systems.
The function is not supported. This return code only occurs for UPIC-L. It indicates to the program that a TSEL cannot be allocated because UPIC-L does not need this information as a result of the underlying communication system.

CM_PROGRAM_PARAMETER_CHECK

The value of either conversation_ID or transport_selector_length is invalid.

CM_PROGRAM_STATE_CHECK

The conversation is not in the “Initialize” state.

CM_PRODUCT_SPECIFIC_ERROR

The UPIC instance could not be found.

State change

The call does not change the state of the conversation.

Behavior in the event of errors

CM_PROGRAM_PARAMETER_CHECK

Modify program.

CM_PROGRAM_STATE_CHECK

Modify program.

CM_PRODUCT_SPECIFIC_ERROR

The operating system cannot provide sufficient memory for the internal buffers. Check whether the memory requirements of your program are too high and if necessary reboot your system.

CM_CALL_NOT_SUPPORTED

This return code only applies to Unix, Linux and Windows systems.
This is not necessarily an error: If the application is intended for both UPIC-L and UPIC-R this return code just means that the application is linked to a UPIC-L library. The program can take note of this return code and avoid making further calls to set address information.

Function declaration: Set_Partner_Tsel

CM_ENTRY Set_Partner_TSEL ( unsigned char CM_PTR conversation_ID,
                            unsigned char CM_PTR transport_selector,
                           CM_INT32       CM_PTR transport_selector_length,
                           CM_RETURN_CODE CM_PTR return_code )