TPOPEN(3cbl)


	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

TPOPEN(3cbl)

Name

TPOPEN() - open the BEA Tuxedo system resource manager

Synopsis

01 TPSTATUS-REC.
COPY TPSTATUS.

CALL "TPOPEN" USING TPSTATUS-REC.

Description

TPOPEN() opens the resource manager to which the caller is linked. At most one resource manager can be linked to the caller. This routine is used in place of resource manager-specific open() calls and allows a service routine to be free of calls that may hinder portability. Since resource managers differ in their initialization semantics, the specific information needed to open a particular resource manager is placed in a configuration file.

If a resource manager is already open (that is, TPOPEN() is called more than once), no action is taken and success is returned.

Return Values

Upon successful completion, TPOPEN() sets TP-STATUS to [TPOK]. More information concerning the reason a resource manager failed to open can be gotten by interrogating the resource manager in its own specific manner. Note that any calls to determine the exact nature of a resource manager's error hinder portability.

Errors

Under the following conditions, TPOPEN() fails and sets TP-STATUS to:

[TPERMERR]: A resource manager failed to open correctly. More information concerning the reason a resource manager failed to open can be obtained by interrogating a resource manager in its own specific manner. Note that any calls to determine the exact nature of the error hinder portability.
[TPEPROTO]: TPOPEN() was called in an improper context (for example, by a client that has not joined a BEA Tuxedo system server group).
[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.