Section 3c - C Functions

ATMI C Function Reference

tpcryptpw(3c)

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:

[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 ATMI release 5.0 or later. This interface is not available to Workstation clients.

Files

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