JoltSessionBean

The JoltSessionBean, which represents the Oracle Tuxedo session, encapsulates the functionality of the JoltSession, JoltSessionAttributes, and JoltTransaction classes. The JoltSessionBean has properties that you use to set session and security attributes, such as sending a timeout or an Oracle Tuxedo username, as well as methods to open and close an Oracle Tuxedo session.

The JoltSessionBean sends a PropertyChange event when the Oracle Tuxedo session is established or closed. PropertyChange is a standard bean event defined in the java.beans package. The purpose of this event is to signal other beans about a change of the value of a property in the source bean. In this case, the source is the JoltSessionBean; the targets are JoltServiceBeans or JoltUserEventBeans; and the property changing is the LoggedOn property of the JoltSessionBean. When a logon is successful and a session is established, LoggedOn is set to true. After the logoff is successful and the session is closed, the LoggedOn property is set to false.

The JoltSessionBean provides methods to control transactions, including beginTransaction(), commitTransaction(), and rollbackTransaction().

The following table shows the JoltSessionBean properties and descriptions.

Table 5-1 JoltSessionBean Properties and Descriptions

Property Description
AppAddress Set the IP address (host name) and port number of the JSL or the Jolt Relay. The format is //host:port number (for example, myhost:7000).
AppPassword Set the Oracle Tuxedo application password used at logon, if required.
IdleTimeOut Set the IDLETIMEOUT value.
inTransaction Indicate true or false depending if a transaction has been started and not committed or aborted.
LoggedOn Indicate true or false if an Oracle Tuxedo session does or does not exist.
ReceiveTimeOut Set the RECVTIMEOUT value
SendTimeOut Set the SENDTIMEOUT value.
SessionTimeOut Set the SESSIONTIMEOUT value.
UserName Indicate the Oracle Tuxedo username, if required.
UserPassword Indicate the Oracle Tuxedo user password, if required.
UserRole Indicate the Oracle Tuxedo user role, if required.