ATMI C Function Reference
tpcryptpw()
—Encrypts the application password in an administrative request.
#include <atmi.h>
#include <fml32.h>
int tpcryptpw(FBFR32 *buf)
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
.
Upon failure, tpcryptpw()
returns -1 and sets tperrno
to indicate the error condition.
Upon failure, tpcryptpw()
sets tperrno
to one of the following values:
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.
The calling process did not have the appropriate permissions necessary to perform the requested task.
An operating system error has occurred. A numeric value representing the system call that failed is available in Uunixerr
.
A BEA Tuxedo system error has occurred. The exact nature of the error is written to userlog(3c)
.
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.
${TUXDIR}/lib/libtmib.a
, ${TUXDIR}/lib/libtmib.so.
rel