Routines for rta.kb


CompletionFailure

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


GetSiteConnection

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


GetSiteIndex

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


InitializeTransferAgent

File Name

rta.kb

Syntax

None

Parameters

: None

Returns

None

Side Effects

None

Description

: This procedure is called upon system startup to load all apropriate configuration data.

Dialog Forms Called

None


Main

File Name

rta.kb

Syntax

None

Parameters

args: command line arguments

Returns

None

Side Effects

None

Description

This is the main startup procedure for the standalone Transfer Agent.

Dialog Forms Called

tivint.dfc[frm_tiv_swdist]

tivint.dfc[frm_tiv_rc]

tivint.dfc[frm_tiv_password]

tivint.dfc[frm_tiv_rc_admin]


PostDDMDataToSite

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


PostRemoteWorkRequest

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


ProcessAssignedRecord

File Name

rta.kb

Syntax

None

Parameters

RemoteWorkData: Remote Work record holding the entire record

to be processed.

Returns

None

Side Effects

None

Description

This procedure reads the PROBLEM_CLOSURE record that it has been assigend and processes it.

Dialog Forms Called

None


ProcessATask

File Name

rta.kb

Syntax

None

Parameters

ClosureData: Closure record holding the entire record

to be processed.

Returns

None

Side Effects

None

Description

This procedure takes a closure record and dispatches it to the apropriate process bassed upon the TransactionType field within the record. Possible values are: CP_FREEZE_PROBLEM CP_TRANSFER_PROBLEM CP_QUICK_SOLUTION CP_SOLVE_WITH These are defined in closeapi.kb and are set by TRANS.KB when a closure record is written.

Dialog Forms Called

None


ProcessIncomingWork

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


ProcessMissedLWRecords

File Name

rta.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

This procedure searches the LOCAL_WORK table for old records and attempts to process them. Records are marked with the current time when they are first picked up. If a record gets old, it is assumed that the process which picked it up has died. The adminstrator can configure the amount of time that a record is allowed to age before it is picked up. The value is read from the g_RemTrans.retryResponseFailure.

Dialog Forms Called

None


ProcessMissedRTRecords

File Name

rta.kb

Syntax

None

Parameters

None

Returns

None

Side Effects

None

Description

This procedure searches the REMOTE_WORK table for old records and attempts to process them. Records are marked with the current time when they are first picked up. If a record gets old, it is assumed that the process which picked it up has died. The adminstrator can configure the amount of time that a record is allowed to age before it is picked up. The value is read from the g_RemTrans.retryTransFailure

Dialog Forms Called

None


ProcessRejectedMessage

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

Called when a message is sent from this server to a server that is stopped or suspended. In the current implementation of the EA 3 tier architecture, messages sent to servers that are in this state are "eaten". The distributed data manager must be able to assume that a message is processed if it successfully posted to the remote server. Therefore, the "server stopped" and "server suspended" messages are captured by the DDM and result in a call to this function so that the pending remote transactions may be marked as failed to be retried in the future.

Dialog Forms Called

None


ProcessRemoteCompletion

File Name

rta.kb

Syntax

None

Parameters

RemoteCompletionRecord

Returns

True if successful, False if not.

Side Effects

None

Description

None

Dialog Forms Called

None


ProcessRemoteWorkRecord

File Name

rta.kb

Syntax

None

Parameters

rw_id: the id of the specific record to process.

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


SendCompletion

File Name

rta.kb

Syntax

None

Parameters

Returns

None

Side Effects

None

Description

None

Dialog Forms Called

None


TransferAgentEvent

File Name

rta.kb

Syntax

None

Parameters

i: only passed because it's required for an event.

Returns

None

Side Effects

None

Description

This event is the main handler for the stand alone Transfer Agent.

Dialog Forms Called

None


ValidateSite

File Name

rta.kb

Syntax

None

Parameters

Returns

True if the site is valid and active

False if not

Side Effects

None

Description

Determines if the sending site is valid and active. Sends a failure to the site if it exists in the database.

Dialog Forms Called

None