Specify_Local_Tsel - Setting the T-SEL of the local application

The Specify_Local_Tsel (CMSLT) call sets the value of the T-SEL characteristic of the local application. The call overwrites the value assigned using the Enable_UTM_UPIC call. After the Initialize_Conversation call, this call may no longer be issued.

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

UPIC-Local on Unix, Linux and Windows systems:

Connection via UPIC local does not support the Specify_Local_Tsel call.

Syntax

CMSLT (transport_selector, transport_selector_length, return_code)

Parameters

--> transport_selector	Transport selector of the local 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 name of the local application itself 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 in UPIC-L. It indicates to the program that a T-SEL cannot be assigned because UPIC-L does not require this information because of the underlying communication system.

CM_PROGRAM_STATE_CHECK

The conversation is not in the “Reset” state.

CM_PRODUCT_SPECIFIC_ERROR

The UPIC instance could not be found.

CM_PROGRAM_PARAMETER_CHECK

The value of transport_selector_length is invalid.

State change

The call does not change the state of the conversation.

Behavior in the event of errors

CM_CALL_NOT_SUPPORTED

This return code only applies to Unix, Linux and Windows systems.
Is not necessarily an error: If an 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 sending further calls to set address information.

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.

Function declaration: Specify_Local_Tsel

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