Set_Deallocate_Type - Characteristic deallocate_type setzen

Der Aufruf Set_Deallocate_Type (CMSDT) setzt den Wert für die Characteristic deallocate_type einer Conversation.

Dieser Aufruf gehört zu den Advanced Functions.

Syntax

CMSDT (conversation_ID, deallocate_type, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation
--> deallocate_type	Gibt den Typ für die Beendigung der Conversation an. deallocate_type muss den Wert CM_DEALLOCATE_ABEND haben.
<-- return_code	Ergebnis des Funktionsaufrufs

Ergebnis (return_code)

CM_OK

Aufruf ok

CM_PROGRAM_PARAMETER_CHECK

Der Wert in conversation_ID ist ungültig oder der Wert für deallocate_type liegt nicht im zulässigen Wertebereich. Der Wert für deallocate_type bleibt unverändert.

CM_PRODUCT_SPECIFIC_ERROR

Der Wert für deallocate_type ist nicht CM_DEALLOCATE_ABEND.
Der Wert für deallocate_type bleibt unverändert

Zustandsänderung

Keine Zustandsänderung.

Hinweis

Der deallocate_type CM_DEALLOCATE_ABEND wird von einem Programm verwendet, um eine Conversation bedingungslos zu beenden (ohne Berücksichtigung des gegenwärtigen Zustands). Diese abnormale Beendigung sollte vom Programm nur in Ausnahmesituationen durchgeführt werden.

Verhalten im Fehlerfall

CM_PROGRAM_SPECIFIC_ERROR

Programm ändern.

CM_PROGRAM_PARAMETER_CHECK

Programm ändern.

Funktionsdeklaration: Set_Deallocate_Type

CM_ENTRY Set_Deallocate_Type ( unsigned char CM_PTR  conversation_ID,
                          CM_DEALLOCATE_TYPE CM_PTR  deallocate_type,
                          CM_RETURN_CODE     CM_PTR  return_code )