Der Aufruf Set_TP_Name (CMSTPN) setzt für die Conversation die Characteristics TP_name und TP_name_length. TP_name ist der Transaktionscode eines UTM-Teilprogramms.
Set_TP_Name ändert die Werte, die beim Initialize_Conversation-Aufruf aus der Side Information entnommen wurden. Die geänderten Werte gelten nur für die Dauer einer Conversation; die Werte in der Side Information selbst werden nicht verändert.
Der Set_TP_Name-Aufruf darf nach Allocate nicht mehr ausgeführt werden.
Dieser Aufruf gehört zu den Advanced Functions.
CMSTPN (conversation_ID, TP_name, TP_name_length, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation |
--> TP_name | UTM-Transaktionscode |
--> TP_name_length | Minimum: 1, Maximum: 8 |
<-- return_code | Ergebnis des Funktionsaufrufs |
Ergebnis (return_code)
CM_OK
Aufruf ok
CM_PROGRAM_STATE_CHECK
Der Aufruf ist in diesem Zustand nicht erlaubt.
CM_PROGRAM_PARAMETER_CHECK
Der Wert in conversation_ID oder TP_name ist ungültig oder der Wert in TP_name_length ist kleiner als 1 oder größer als 8.
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
Falls das Ergebnis nicht CM_OK ist, bleiben TP_name und TP_name_length unverändert.
Zustandsänderung
Keine Zustandsänderung.
Verhalten im Fehlerfall
CM_PROGRAM_STATE_CHECK
Programm ändern.
CM_PROGRAM_PARAMETER_CHECK
Programm ändern.
CM_PRODUCT_SPECIFIC_ERROR
Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderungen und starten Sie ggf. Ihr System neu.
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 )