Section 3c - C Functions

ATMI C Function Reference

tpgetrepos(3c)

Name

tpgetrepos() - retrieves service parameter information from a Tuxedo service metadata repository file.

#include <atmi.h>

Synopsis

int tpgetrepos(char *reposfile, FBFR32* idata, FBFR32** odata)

Description

tpgetrepos() provides an alternative repository access interface to the .TMMETAREPOS service provided by TMMETADATA(5). It retrieves service parameters from a Tuxedo service metadata repository file. To use tpgetrepos(), the metadata repository file must reside on the native client or server that initiates the request. This allows for repository information access even when TMMETADATA(5)has not been booted.

Note: tpgetrepos() can also be used to view Jolt repository files. It cannot modify an existing Jolt repository file or create a new one.

tpgetrepos() accepts the following parameters:

reposfile

specifies the path name of a file accessible on the current machine where the Tuxedo Metadata Repository is located. The caller must have read permission for this file.

idata

specifies what type of service parameter information is retrieved, and points to an FML32 buffer.

*odata

On output, points to an FML32 buffer containing the retrieved service parameter information and operation status.

METAREPOS(5)describes the FML32 buffer format tpgetrepos()uses. It is similar to the format used by the Tuxedo MIB.

Return Value

tpgetrepos() returns 0 on success. On failure, it sets tperrno and returns -1. On most failure conditions, the TA_ERROR field in *odata is populated with information about the specific error, as is done by the Tuxedo MIB.

Errors

Upon failure, tpgetrepos() sets tperrno to one of the following values:

Note: Except for TPEINVAL, odata is modified to include TA_ERROR, TA_STATUS for each service entry to further qualify the error condition.

[TPEINVAL]

Invalid arguments were specified. The reposfile value is invalid or idata or odata are not pointers to FML32 typed buffers.

[TPEMIB]

The MIB-like request failed. odata is updated and returned to the caller with FML32 fields indicating the cause of the error as discussed in MIB(5).

[TPEPROTO]

tpgetrepos() was improperly called. The reposfile file argument given is not a valid repository file.

[TPEOS]

An operating system error has occurred. A numeric value representing the system call that failed is available in Uunixerr.

[TPESYSTEM]

A BEA Tuxedo system error has occurred. The exact nature of the error is reported in userlog().

Portability

This interface is available only on BEA Tuxedo release 9.0 or later.

Files

The following library files are required:

${TUXDIR}/lib/libtrep.a ${TUXDIR}/lib/libtrep.so.<rel> ${TUXDIR}/lib/libtrep.lib

The libraries must be linked manually when using buildclient. The user must use: -L${TUXDIR}/lib -ltrep