BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo C Function Reference

tpcryptpw(3c)

Name

tpcryptpw() - encrypt application password in administrative request

Synopsis

#include <atmi.h> 
#include <fml32.h>

int tpcryptpw(FBFR32 *buf)

Description

tpcryptpw() is used to encrypt the application password stored in an administrative request buffer prior to sending the request for servicing. Application passwords are stored as string values using the FML32 field identifier TA_PASSWORD. This encryption is necessary to insure that clear text passwords are not compromised and that appropriate propagation of the update can take place to all active application sites. Additional system fields may be added to the callers buffer and existing fields may be modified to satisfy the request.

A thread in a multithreaded application may issue a call to tpcryptpw() while running in any context state, including TPINVALIDCONTEXT.

Return Values

Upon failure, tpcryptpw() returns -1 and sets tperrno() to indicate the error condition.

Errors

Upon failure, tpcryptpw() sets tperrno() to one of the following values.

[TPEINVAL]

Invalid arguments were specified. The buf value is NULL, does not point to a FML32 typed buffer or appdir could not be determined from the input buffer or the environment.

[TPEPERM]

The calling process did not have the appropriate permissions necessary to perform the requested task.

[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 written to userlog(3c).

Portability

This interface is available only on UNIX System sites running BEA Tuxedo Release 5.0 or later. This interface is not available to workstation clients.

Files

${TUXDIR}/lib/libtmib.a, ${TUXDIR}/lib/libtmib.so.rel

See Also

MIB(5), TM_MIB(5)

Setting Up a BEA Tuxedo Application

Administering a BEA Tuxedo Application at Run Time