tpgetadmkey-get administrative authentication key.
#include <atmi.h>
long tpgetadmkey(TPINIT *tpinfo)
tpgetadmkey() is available for application use by an application specific authentication server. It returns an application security key suitable for assignment to the indicated user for the purpose of administrative authentication. This routine must be called with a client name (i.e., tpinfo->cltname) of either tpsysadm or tpsysop; otherwise, a valid administrative key will not be returned.
A non-0 value with the high-order bit (0x80000000) set is returned on success; otherwise 0 is returned. Zero may be returned if tpinfo is NULL, tpinfo->cltname is not tpsysadm or tpsysop, or lastly if the effective user id is not the configured application administrator for this site.
A zero return value is the only indication that a valid administrative key was not assigned.
This interface is available only on UNIX System sites running BEA TUXEDO Release 5.0 or later.
tpaddusr(1), tpinit(3), AUTHSVR(5), BEA TUXEDO Administrator's Guide