Section 3c - C Functions

ATMI C Function Reference

tpsetrepos(3c)

Name

tpsetrepos() - adds, edits, or deletes service parameter information from a Tuxedo Service Metadata repository file

Synopsis

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

Description

tpsetrepos() provides an alternative repository access interface to the .TMMETAREPOS service provided by TMMETADATA(5). It adds, edits, or deletes parameter information from a Tuxedo Service Metadata repository file. To use tpsetrepos(), 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.

tpsetrepos() is available in processes linked with the BEA Tuxedo native libraries, but is not available in processes linked with the BEA Tuxedo workstation libraries.

Note: tpsetrepos() cannot be used to add, edit, or delete service parameter information in a JOLT Repository file.

reposfile

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

idata

specifies what type of service information is added, edited, or deleted, and points to an FML32 buffer.

*odata

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

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

Return Values

tpsetrepos() 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, tpsetrepos() 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]

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

[TPEPERM]

A Jolt repository file is specified. tpsetrepos() cannot be applied to a Jolt 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