tpterm - Client abmelden

Syntax in C

int tpterm ()

Syntax in COBOL

CALL "TPTERM" USING TPSTATUS-REC.

Beschreibung

Die Funktion tpterm() meldet den Client, in dem diese Funktion aufgerufen wird, beim Trägersystem ab. Der Client muss zuvor mit tpinit() initialisiert worden sein.
Nach tpterm() ist kein XATMI-Aufruf mehr erlaubt, ausgenommen ein erneuter tpinit().

Returnwerte

In C liefert tpterm() im Fehlerfall -1 zurück und setzt die Fehlervariable tperrno auf einen der folgenden Werte:

TPENOENT

Der Client konnte sich nicht ordnungsgemäß abmelden. Ursache können z.B. Probleme beim Trägersystem sein.

TPEPROTO

tpterm wurde an einer nicht erlaubten Stelle aufgerufen, d.h. der Client ist noch nicht initialisiert.

TPESYSTEM

Es ist ein interner Fehler aufgetreten.

In COBOL wird beim TPTERM-Aufruf im Fehlerfall der entsprechende tperrno-Wert direkt als Return-Status geliefert.