A program uses the Set_TP_Name (CMSTPN) call to set the values of the conversation characteristics TP_name and TP_name_length. The TP_name is the transaction code of a UTM program unit.
Set_TP_Name modifies the values taken from the side information with the Initialize_Conversation call. The modified values apply only for the duration of a conversation; the values in the side information itself remain unchanged.
The Set_TP_Name call cannot be executed after the Allocate call.
This call is one of the advanced functions.
CMSTPN (conversation_ID, TP_name, TP_name_length, return_code)
Parameters
--> conversation_ID | Identifier of the conversation. |
--> TP_name | UTM transaction code. |
--> TP_name_length | Length of TP_name. Minimum: 1, maximum: 8 |
<-- return_code | Result of the function call. |
Result (return_code)
CM_OK
The call is OK.
CM_PROGRAM_STATE_CHECK
The call is not permitted in this state.
CM_PROGRAM_PARAMETER_CHECK
The conversation_ID or TP_name is invalid or the value in TP_name_length is less than 1 or greater than 8.
CM_PRODUCT_SPECIFIC_ERROR
The UPIC instance could not be found.
If the return code is not CM_OK, TP_name and TP_name_length remain unchanged.
State change
None
Behavior in the event of errors:
CM_PROGRAM_STATE_CHECK
Modify program.
CM_PROGRAM_PARAMETER_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_ENTRY Set_TP_name ( unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR TP_name,
CM_INT32 CM_PTR TP_name_length,
CM_RETURN_CODE CM_PTR return_code )