PURPOSE

TPTERM - leave a TUXEDO System/T application

SYNOPSIS

01 TPSTATUS-REC.
  COPY TPSTATUS.
CALL "TPTERM" USING TPSTATUS-REC.

DESCRIPTION

TPTERM removes a client from a System/T application. If the client is in transaction mode, then the transaction is rolled back. When TPTERM returns successfully, the caller can no longer communicate with any other thread of control nor can it participate in any transactions. Any outstanding conversations are immediately disconnected.

If TPTERM is called more than once (that is, after the caller has already left the application), no action is taken and success is returned.

RETURN VALUES

Upon successful completion, TPTERM sets TP-STATUS to [TPOK].

ERRORS

Under the following conditions, TPTERM fails and sets TP-STATUS to:

[TPEPROTO]

TPTERM was called in an improper context (for example, the caller is a server).

[TPESYSTEM]

A System/T error has occurred. The exact nature of the error is written to a log file.

[TPEOS]

An operating system error has occurred.

SEE ALSO

TPINITIALIZE(3cbl)