Routines for rtcustom.kb


TransactionCompleted

File Name

rtcustom.kb

Syntax

TransactionCompleted( VAL transactionType: INTEGER, REF completionData: RemoteCompletionRecord, VAL data: DATA_FROM_CLIENT )

Parameters

transactionType -- The network message corresponding to

the type of transaction requested of

this data distribution agent.

completionData -- RemoteCompletionRecord. Contains the success

or failure of the transaction and any errors

encountered. This variable is passed by reference

so that the outcome of the transaction may be altered

here.

data -- DATA_FROM_CLIENT structure. The package

of data recieved from the dispatcher.

The transactionType is used to determine the relevant

dataStructure in the DATA_FROM_CLIENT structure(see

description below). This record is a VAL in this

procedure because the data will not be used any more

after this Procedure.

Returns

Nothing

Side Effects

None

Description

This procedure is called after the work for a particular transaction has completed, but before the completion record has been sent back to the requesting site. It is called regardless of whether the work was successful. The data pertinent to the work performed is contained in the 'data' variable. A comment under each transaction type describes the data structure in 'data' that is relevant.

Dialog Forms Called

None


TransactionReceived

File Name

rtcustom.kb

Syntax

TransactionReceived( VAL transactionType: INTEGER, REF data: DATA_FROM_CLIENT )

Parameters

transactionType -- The network message corresponding to

the type of transaction requested of

this data distribution agent.

data -- DATA_FROM_CLIENT structure. The package

of data recieved from the dispatcher.

The transactionType is used to determine the relevant

dataStructure in the DATA_FROM_CLIENT structure(see

description below).

This variable is passed by reference

so that the data may be altered before it is used

by the Data Distribution Agent.

Returns

Nothing

Side Effects

None

Description

This procedure is called anytime the Data Distribution Agent receives a network message from another site instructing it to perform some remote work. It is called before any work is performed. The data pertinent to the requested work is contained in the 'data' variable. A comment under each transaction type describes the data structure in 'data' that is relevant.

Dialog Forms Called

None