Name

tpcryptpw()—Encrypts the application password in an 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:

Portability

This interface is available only on UNIX system sites running BEA Tuxedo ATMI 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

Setting Up a BEA Tuxedo Application

Administering a BEA Tuxedo Application at Run Time