---

tpchkauth(3c)

Name

tpchkauth-routine for checking if authentication required to join an application

Synopsis

#include <atmi.h> 
 
int tpchkauth(void) 

Description

tpchkauth() checks if authentication is required by the application configuration. This is typically used by application clients prior to calling tpinit(3c) to determine if a password should be obtained from the user.

Return Values

tpchkauth() returns one of the following non-negative values on success.

TPNOAUTH

indicates that no authentication is required.

TPSYSAUTH

indicates that system authentication only is required.

TPAPPAUTH

indicates that both system and application specific authentication are required.

It returns -1 on error and sets tperrno to indicate the error condition.

Errors

Under the following conditions, tpchkauth() fails and sets tperrno to:

[TPESYSTEM]

A BEA TUXEDO system error has occurred. The exact nature of the error is written to a log file.

[TPEOS]

An operating system error has occurred.

Interoperability

tpchkauth() is available only on sites running Release 4.2 or later.

Portability

The interfaces described in tpchkauth(3c) are supported on UNIX, Windows, and MS-DOS operating systems. However, signal-based notification is not supported on 16-bit Windows or MS-DOS platforms. If it is selected at tpinit() time, then a userlog(3c) message is generated and the method is automatically set to dip-in.

See Also

tpinit(3c)

---

---