Disable_UTM_UPIC - Vom Trägersystem UPIC abmelden

Mit dem Aufruf Disable_UTM_UPIC (CMDISA) meldet sich ein Programm vom UPIC-Trägersystem ab. Nach erfolgreicher Ausführung des Aufrufs sind keine weiteren CPI-C-Aufrufe erlaubt. Falls es für das Programm noch eine Verbindung gibt, wird diese abgebaut. Außerdem wird die Abmeldung vom Transportsystem durchgeführt.

Dieser Aufruf muss der letzte Aufruf eines CPI-C-Programmes sein. Er ist nicht nötig, wenn Sie nach dem Beenden einer Conversation mit einem weiteren Initialize-Aufruf fortfahren.

Diese Funktion gehört zu den zusätzlichen Funktionen von UPIC, sie ist nicht Bestandteil der CPI-C-Schnittstelle.

Syntax

CMDISA (local_name, local_name_length, return_code)

Parameter

--> local_name	Name des Programms, d.h. der Name, der bei dem vorangegangenen Enable_UTM_UPIC-Aufruf angegeben wurde.
--> local_name_length	Länge von local_name Minimum: 0, Maximum: 8 local_name_length=0 bedeutet, dass ein „leerer lokaler Anwendungsname“ übergeben wird (siehe Abschnitt „Enable_UTM_UPIC - Beim Trägersystem UPIC anmelden“)
<-- return_code	Ergebnis des Funktionsaufrufs

Ergebnis ( return_code )

CM_OK

Aufruf ok

CM_PROGRAM_STATE_CHECK

Der Aufruf ist im aktuellen Zustand nicht erlaubt.

CM_PROGRAM_PARAMETER_CHECK

Das Programm ist nicht mit local_name an UPIC angemeldet, oder der Wert für local_name_length ist < 1 oder > 8.

CM_PRODUCT_SPECIFIC_ERROR

Beim Abmelden von UPIC oder beim Abbau der Verbindung ist ein Fehler aufgetreten.

Zustandsänderung

Falls das Ergebnis CM_OK ist, wurde das Programm abgemeldet und geht in den Zustand "Start" über. In allen anderen Fällen ändert das Programm seinen Zustand nicht.

Hinweis

Den Aufruf müssen Sie auch dann verwenden, wenn Sie bei einer Fehlersituation im Anwendungsprogramm den Prozess mit exit() beenden wollen.
Aus Performancegründen sollte diese Funktion, falls kein Fehler auftritt, nur unmittelbar vor der Prozessbeendigung aufgerufen werden!

Verhalten im Fehlerfall

CM_PRODUCT_SPECIFIC_ERROR

Systemdienst informieren und Diagnoseunterlagen erstellen.

CM_PROGRAM_STATE_CHECK

Programm ändern.

CM_PROGRAM_PARAMETER_CHECK

Programm ändern.

Funktionsdeklaration: Disable_UTM_UPIC

CM_ENTRY Disable_UTM_UPIC ( unsigned char CM_PTR  local_name,
                           CM_INT32       CM_PTR  local_name_length,
                           CM_RETURN_CODE CM_PTR  return_code)