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;