Interface1
(Generated Service Request Class) is used by client applications to make service requests to the co-responding Interface1
Impl
(Generated Service Implementation) object.
Module1
· Interface1
(Abstract Base Class) · Interface1
(Generated Service Request Class)
For each interface in a module in the Rose Model, a class of this type is derived from the Abstract Interface class Module1
::
Interface1
. The member functions of this class are mapped onto BEA TUXEDO service requests, and has code to marshal operation parameters to FML buffers, and throw exceptions specific to BEA TUXEDO system error codes and exceptions specific to this operation. Refer to TuxException
and Operation1
Exception
(Generated Exception) for more information about these exceptions.
Objects of this class serve as a local surrogate to the remote Interface1
Impl
(Generated Service Implementation) object running in the application server and are used to make service requests to that object. These objects are stateless and can be reused for subsequent service requests or deleted, as desired. The output argument values (specified in the Rose Model interface definition) are available as data members in Operation1
Reply
(Generated Service Reply) and can be retrieved by the member functions of that class.
Warning:
The client application is responsible for the deletion of Interface1
objects. Interface1
does not support copy semantics.
This section lists the data types of Generated Service Request class.
Data Type | Access | Documented in |
---|---|---|
public |
Generated Service Request |
InvocationType
Description
InvocationType
is an enumerated type that indicates the type of service request. Valid values for invoke
are:
Use This section lists the member functions of the Generated Service Request class.
GetInvoke
to determine the current value of InvocationType
, and SetInvoke
to specify a new value.
Member Functions
The The For more information about the BEA TUXEDO
GetFlags
GetFlags
returns the value of flags
.
Synopsis
Long GetFlags()
Description
flags
variable specifies which flags of the underlying BEA TUXEDO ATMI call is set. For more information about queueing, refer to tpenqueue
in the BEA TUXEDO Reference Manual (see Where to Find Related Information).
GetInvoke
GetInvoke
returns the value of InvocationType
, which indicates the type of service request
Synopsis
InvocationType GetInvoke()
GetTpqctl
GetTpqctl
returns the a reference to the TPQCTL
structure.
Synopsis
TPQCTL* GetTpqctl()
Description
TPQCTL
structure is used to pass and retrieve parameters associated with queuing a message. There is no unique "Get" or "Set" operation for each data member of the TPQCTL
structure. If you wish to examine or modify the TPQCTL
structure, use GetTpqctl
to get a pointer to the structure, and SetTpqctl
save your changes. You can make changes directly to the TPQCTL
structure, or copy the TPQCTL
structure to a temporary structure, make your changes to the temporary structure and use SetTpqctl
to save the temporary structure to the Interface1
(Generated Service Request Class)
object.
TPQCTL
structure, refer to the BEA TUXEDO Reference Manual (see Where to Find Related Information).
Operation1
Operation1
is a generated member function that makes a request to a BEA TUXEDO service with the same name.
Synopsis
Operation1
Reply* Operation1
(char* parameter1)
throw(TuxException*, Operation1
Exception*)
Parameters
parameter1
SetFlags
specifies the value of the flag used by the underlying BEA TUXEDO ATMI call.
void SetFlags(Long)
For more information about the BEA TUXEDO flags
variable, refer to the BEA TUXEDO Reference Manual (see Where to Find Related Information).
SetInvoke
specifies the service invocation type by setting the value of InvocationType.
void SetInvoke(InvocationType)
SetQoptions
is used to specify the parameters of a queued service request.
void SetQoptions(const char* qspace, const char* qname,
const char* replyQue, const char* failureQue)
For more information about these parameters, refer to the BEA TUXEDO Reference Manual (see Where to Find Related Information).
qspace
qspace
parameter identifies a specific queue space.
qname
qspace
.
replyQue
qspace
.
failureQue
qspace
.
SetQoptions
must be called with the required parameters before invoking Operation1
on this generated service request object.
SetTpqctl
specifies the value of the TPQCTL
structure.
void SetTpqctl(TPQCTL*)
For more information about the BEA TUXEDO TPQCTL
structure, refer to the BEA TUXEDO Reference Manual (see Where to Find Related Information).