Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo COBOL Function Reference

TPCHKAUTH()-check if authentication required to join a BEA Tuxedo system application

01 TPAUTDEF-REC.
 COPY TPAUTDEF. 
 
01 TPSTATUS-REC.
 COPY TPSTATUS.
 
 CALL "TPCHKAUTH" USING TPAUTDEF-REC TPSTATUS-REC.

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

Upon successful completion, TPCHKAUTH() sets TP-STATUS to [TPOK] and sets one of the following values in TPAUTDEF-REC.

TPNOAUTH

indicates that no authentication is required.

TPSYSAUTH

indicates that only system authentication is required.

TPAPPAUTH

indicates that both system and application specific authentication are required.

Under the following conditions, TPCHKAUTH() fails and sets TP-STATUS 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.

The interfaces described in TPCHKAUTH() are supported on UNIX System and MS-DOS operating systems.

TPINITIALIZE(3cbl)