GetUploadTransaction callback

Used to customize the rows uploaded to the MobiLink server during the replay session; called once per upload transaction, per synchronization, per simulated client, and per repetition.

Note

The mlreplay utility tries to adjust the timing information based on the size of the new upload given by GetUploadTransaction and the upload in the recorded protocol file. However, if timing is important, best results are obtained if the total size of the rows added using GetUploadTransaction roughly match the size of the rows uploaded in the original recorded synchronization. The easiest way to ensure the size is roughly the same is to record a synchronization that uploads the same number of rows with similar data.

Syntax

bool _callback GetUploadTransaction(
    asa_uint32 repetitionNum,
    asa_uint32 numRepetitions,
    asa_uint32 simulatedClientNum,
    asa_uint32 numSimulatedClients,
    asa_uint32 syncNum,
    asa_uint32 numRecordedSyncs,
    asa_uint32 transNum,
    asa_uint32 numUploadedTrans,
    IMLReplayUploadTransaction * uploadTrans,
    const MLReplayNamesAndValues * namesAndValues
)

Parameters

repetitionNum The current repetition number.
numRepetitions The number of times to repeat the session.
simulatedClientNum The simulated client number (ordinal 1) used to distinguish this simulated client from other simulated clients in the same mlreplay instance.
numSimulatedClients The total number of simulated clients in this mlreplay instance.
recordedSyncNum The synchronization number (ordinal 1) within the recorded protocol.
numRecordedSyncs The total number of synchronizations in the recorded protocol.
uploadTransNum The transaction number (ordinal 1) within the given synchronization.
numUploadedTrans The total number of upload transactions in the given synchronization.
uploadTrans An output parameter that must be set with the upload operations for the current transaction.
namesAndValues The set of defined names and values used to customize replay behavior.

Returns

Remarks

Discuss this page in DocCommentXchange.