JoltSessionNew Function

Action

Creates a new JoltSession object. A JoltSession object represents the logon session object and is used to access available TUXEDO services. The JoltCheckAuthenticationLevel function can be used to retrieve the type of authentication that is required.

Include file

Jolt.bdh

Syntax

JoltSessionNew( in hSessionAttr  : number,
                in sUserName     : string allownull,
                in sUserRole     : string allownull,
                in sUserPassword : string allownull,
                in sAppPassword  : string allownull ): number;

Return value

Handle to the new JoltSession object.

Parameter Description
hSessionAttr Handle to a JoltSessionAttributes object that was created with JoltSessionAttributesNew
sUserName Name that identifies the user to the Jolt/TUXEDO System. This parameter represents the name of the caller commonly entered in logon dialogs
sUserRole Group name. This parameter is used to associate the client with a resource manager group name
sUserPassword User password in unencrypted format. This parameter is used for validation against the user password
sAppPassword Application password in unencrypted format. This parameter is used for validation against the application password

Example

var
  hSession, hSessionAttr: number;
dcltrans
  transaction TInit
  begin
    JavaSetOption(JAVA_VERSION, JAVA_V11);
    JavaSetOption(JAVA_HOME, "c:/jdk1.1.7");
    JavaSetOption(JAVA_CLASSPATH, "c:/jdk1.1.7");
    JoltInit();    hSessionAttr := JoltSessionAttributesNew();
    JoltSetString(hSessionAttr, APPADDRESS, "//lab:8000");
    hSession := JoltSessionNew(hSessionAttr, "", "ATM", "", "");
  end TInit;
  transaction TShutdown
  begin
    JoltEndSession(hSession);
    JoltFreeObject(hSession);
    JoltFreeObject(hSessionAttr);
  end TShutdown;

See also

Java: bea.jolt.JoltSession class