Session Connection

Lite Client

Trail: PROIV Documentation > Developer > Lite Client > Lite Client and the Browser > Session Connection

A session connection is created by calling the proiv.startPROIVSession in the Lite Client library. This function has a single parameter which is an object holding the properties required for the connection.

   var sessionkey = proiv.startPROIVSession({
      sessionNodeID: SESSION_NODE_ID,
      URI: 'CONNECTION_URI',
      connectionData: {
         sessionType: 'TELNET_SESSION',
         hostname: 'localhost',
         port: '10023',
         username: 'MY_LOGIN',
         password: 'MY_PASSWORD',
         command: 'UNIX_COMMAND',
         resourceURL: 'MY_RESOURCES'
      }
   });

sessionNodeID - The ID of the browser node that will hold the PROIV session.

URI - The URI of the connection servlet (typically just /connect).

sessionType - The type of session (windows = TELNET_SESSION & UNIX = TELNET_LOGIN_SESSION).

resourceURL - The URI to any session resources (e.g. images).

The Lite Client uses a single browser node to hold all the components in a session. This means that more than one PROIV session can be in the same page. Each session must be given a separate browser node. There is no interaction between the sessions but the developer could write JavaScript in the page that uses OpenAjax (see below) to pass messages between the sessions.

The Lite Client has the concept of the ‘Active Session’. This is the session that had the most recent user activity (e.g. click on a component or edit an input field) or it can be set by a function call (see Setting the Active PROIV Session). The ‘Active Session’ is the one given any user events that are not explicitly aimed at a particular session (e.g. a function key click).

Comment on this topic

Topic ID: 870029