Specify_Local_Tsel_Format - Setting the TSEL format of the local application

The Specify_Local_Tsel_Format (CMSLTF) call sets the value of the T-SEL-FORMAT ccharacteristic of the local application. The call overwrites the value assigned by 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 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 Specify_Local_Tsel_Format call.

Syntax

CMSLTF (tsel_format, return_code)

Parameters

--> tsel_format

Specifies which character set is to be used for the transport selector (TSEL). The following values can be entered: CM_TRANSDATA _FORMAT The transport selector is transferred to the communication system using TRANSDATA format. CM_EBCDIC_FORMAT The transport selector is transferred to the communication system using EBCDIC format. CM_ASCII_FORMAT The transport selector is transferred to the communication system using ASCII format.

<-- 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 format cannot be assigned for the transport selector because UPIC-L does not require this information as a result 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 tsel_format is invalid.

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 buffer. Check whether the memory requirements of your program is too high and if necessary reboot your system.

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.

Function declaration: Specify_Local_Tsel_Format

CM_ENTRY Specify_Local_Tsel_Format ( CM_TSEL_FORMAT CM_PTR  tsel_format, 
                                     CM_RETURN_CODE CM_PTR  return_code )