tpterm - Signing the client off

Syntax in C

int tpterm ()

Syntax in COBOL

CALL "TPTERM" USING TPSTATUS-REC.

Description

The tpterm() function is used to sign a client off from the carrier system. The client is the one in which this function is called and must have been initialized previously with tpinit(). Following a tpterm() call, no further XATMI calls (apart from tpinit()) are permitted.

Return codes

In the event of an error, tpterm() returns in C the value -1 and sets the tperrno error variable to one of the following values:

TPENOENT

The client could not sign off in the normal way. There may be problems in the carrier system.

TPEPROTO

tpterm was called at an inappropriate time, i.e. the client is not yet initialized.

TPESYSTEM

An internal error has occurred.

In COBOL, in case of error in the TPTERM call the corresponding tperrno value is supplied directly as the return status.