HP NonStop G-Series - Manual (Page 188)

JoltSessionBean
The JoltSessionBean represents the TUXEDO session. It encapsulates the functionality of the JoltSession, JoltSessionAttributes, and
JoltTransaction classes. The JoltSessionBean offers properties to set session and security attributes, such as send timeout or TUXEDO user
name, as well as methods to open and to close a TUXEDO session.
The JoltSessionBean sends a PropertyChange event when the 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().
Table 3-1 shows the JoltSessionBean properties and descriptions.
Table 3-1. JoltSessionBean Properties
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 (e.g., myhost:7000).
AppPassword Set the 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 a 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 TUXEDO user name, if required.
UserPassword Indicate the TUXEDO user, if required.
UserRole Indicate the TUXEDO user role, if required.
JoltServiceBean
The JoltServiceBean represents a remote TUXEDO service. The name of the service is set as a property of the JoltServiceBean. The
JoltServiceBean listens to JoltInputEvents from other beans to populate its input buffer. JoltServiceBean offers the callService() method to
invoke the service. JoltServiceBean is an event source for JoltOutputEvents that carry information about the output of the service. After a
successful callService(), listener beans are notified via a JoltOutputEvent which carries the reply message.
Although the primary way of changing and querying the underlying message buffer of the JoltServiceBean is via events, the
JoltServiceBean also provides methods to access the underlying message buffer directly (setInputValue(...), getOutputValue(...)).
Table 3-2 shows the JoltServiceBean properties and descriptions.
Table 3-2. JoltServiceBean Properties
Property Description
ServiceName The name of the TUXEDO service represented by this JoltServiceBean.
Session The JoltSessionBean associated with the bean that allows access to the
TUXEDO client session.
Transactional Set to true if this JoltServiceBean is to be included in the transaction that was
started by its JoltSessionBean.