TuxAuthInit Function

Action

Manages joining a TUXEDO System application. Before a client is able to use any of the TUXEDO System communication or transaction routines, it must first join a TUXEDO System application. This function joins the client to a TUXEDO System application. In addition, this function is used to provide application authentication (if required). After this function successfully completes, the client can initiate service requests and define transactions.

To join a TUXEDO System application, use this function rather than the native Tux_tpinit function.

Include file

TUXEDO.bdh

Syntax

TuxAuthInit( in sUserName   : string optional,
             in sClientName : string optional,
             in sPassword   : string optional,
             in sGroupName  : string optional,
             in nFlags      : number optional,
             in nDataSize   : number optional,
             in sData       : string optional ): boolean;

Return value

true if successful
false otherwise

Parameter	Description
sUserName	User name (optional). This parameter represents the name of the caller commonly entered in logon dialogs
sClientName	Client name (optional). The semantics of this parameter are application-specific
sPassword	Application password in unencrypted format (optional). This parameter is used for validation against the application password
sGroupName	Group name (optional). This parameter is used to associate the client with a resource manager group name
nFlags	Indicates the client-specific notification mechanism (optional). Any of the following flags is valid: TPU_MASK. Unsolicited notification TPU_SIG. Select unsolicited notification by signals TPU_DIP. Select unsolicited notification by dip-in TPU_IGN. Ignore unsolicited notification
nDataSize	Size of the application-specific data passed to the function (optional)
sData	Application-specific data that is forwarded to an application-defined authentication service (optional)

Example

dcltrans
  transaction TInit
  begin
    // set environment variables
    Tux_tuxputenv("TUXDIR=c:\\tuxedo");
    Tux_tuxputenv("WSNADDR=//server3:3000");
    // join TUXEDO System application    TuxAuthInit("user", "*", "pass", "", 2, 4, "pass");
    Tux_tuxputenv("FLDTBLDIR=C:\\TUXEDO\\apps\\bankapp");
  end TInit;

Sample scripts

bankappn.bdf