|
BEA Systems, Inc. | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface represents a conversation between a client and server over an open conection. The process that opens a connection and starts a conversation is the originator of the conversation. The process with control of the connection is the initiator; the process without control is called the subordinate. The connection remains active until an event occurs to terminate it. This interface is modeled on the conversational interface of the Tuxedo product.
Method Summary | |
void |
tpdiscon()
Executes a disorderly disconnect by immediately tearing down the connection and generating a TPEV_DISCONIMM event on the other end of the connection. |
Reply |
tprecv(int flags)
Receives data sent across an open connection from a Tuxedo application. |
void |
tpsend(TypedBuffer data,
int flags)
Sends data across an open connection from an initiator to a subordinate Tuxedo application. |
Method Detail |
public void tpsend(TypedBuffer data, int flags) throws TPException
data
- Pointer to the data buffer; null specifies no data sent.flags
- The following is a list of valid flags:data
, tperrno
is set to TPEEVENT and
revent
is set to TPEV_SENDONLY.
tperrno
is set to one
of the following values:svc
is null
or flags are invalid.
public Reply tprecv(int flags) throws TPException, TPReplyException
flags
- The following is a list of valid flags:tprecv
does not wait for a reply
to arrive. If a reply is available, tprecv
gets the reply and
returns. If this flag is not specified and a reply is not available,
tprecv
waits for one of the following to occur: a reply, a
transaction timeout, or a blocking timeout.
tprecv
waits indefinitely for a reply.
tprecv
is immune from blocking timeouts but is subject to
transaction timeouts.
tpsend
. A successful termination of a conversation
is determined with a catch of a TPReplyException where the revent
is set to TPEV_SVCSUCC.tperrno
is set to one of the
following values:tperrno
is set to
TPEEVENT and revent
is one of the following:tpdiscon
;
completed the service; committed or aborted the transaction
with the connection still open. This event is also returned to the
initiator or subordinate when a connection is broken due to a
communications error. For example: a server, machine or network
failure. This event signifies an abortive disconnect and indicates that
data in transit may be lost. If two programs were participating in the same
transaction, the transaction is marked abort-only and the conversation object
is no longer valid.
tpreturn
or tpreturn
was called with open
connections to other subordinates. The connection is disconnected in an orderly
manner and this conversation object is no longer valid. Application defined
data or return codes are not available. If part of the recipient's transaction,
the transaction is marked abort-only.
tpreturn
called with TPFAIL
or TPEXIT. The connection is disconnected in
an orderly manner and this conversation object is no longer valid. If part
of the recipient's transaction, the transaction is marked abort-only.
tpreturn
called with TPSUCCESS.
The connection is disconnected in an orderly manner and this conversation
object is no longer valid. If the recipient initiated a transaction, it
can commit the transaction or abort the transaction causing
work done by the server in the same transaction to commit or abort.
public void tpdiscon() throws TPException
tpdiscon
is called by the initiator of the
conversation. Any data that has not yet reached its destination may be lost.
If the conversation is part of a transaction, the transaction must be
rolled back.
Whenever possible allow: Tuxedo conversational services to end
a conversation with a tpreturn
; WebLogic Server conversational
services to end a conversation with call to return
. Letting the
service tear down the connection ensures an orderly disconnect.
tperrno
is set to one of the following
values:
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs81 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |