---

tpcryptpw(3)

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.

Return Values

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

Errors

Under the following conditions, tpcryptpw() fails and 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(3).

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), BEA TUXEDO Administrator's Guide

---

---