HP NonStop G-Series - Manual (Page 109)

JoltRemoteService Methods
Provides the means to call a transaction service for the JoltRemoteService object.
call
The call method calls the specified service.
void call( Transaction t ) throws ApplicationException,
TransactionException, ServiceException;
Usage The call method calls the service. The t parameter specifies the transaction object. The transaction must belong to
the same session as the current service. If a TUXEDO error (not service failure) occurs, the call method throws a
ServiceException.
You can pass a null to this call method to call services without defining a JoltTransaction object or to exclude the services
from a transaction.
You can use a getErrno to retrieve the TUXEDO error code and error message from the ServiceException. If there is a
service failure (i.e., TPESVCFAIL), the call method throws a runtime exception, ApplicationException.
When programming in multithreaded mode, if the transaction is aborted, all outstanding calls associated with such a
transaction receive a TransactionException with a TPEABORT error code. The associated message contains the service
name.
To call services without defining a JoltTransaction object or to exclude the services from a transaction, you can pass a
null to the call method.
Throws
ApplicationException
(application code) - "this" object is included.
ServiceException
TPEJOLT: Invalid session
TPEJOLT: Connection send error
TPEJOLT: Connection recv error
TPEJOLT: Protocol error
TPEJOLT: bea.jolt.BufException:....
TPEJOLT: bea.jolt.MessageException:...
TransactionException
TPEJOLT - Invalid Transaction
TPEABORT - (service name)
The call() method generates an exception upon receipt of the following TUXEDO errors:
tpcall
TPEINVAL, TPENOENT, TPEITYPE, TPETRAN,
TPETIME, TPESVCFAIL, TPESVCERR, TPEBLOCK,
TPGOTSIG, TPEPROTO, TPESYSTEM, TPEOS
Refer to TUXEDO Errors or tperrno in the TUXEDO System Reference Manual for explanations of these error
messages.