JobTransferStartRecord(Buffer As String, BufferSize As Long)

Description

This event is fired for each Job run in Transfer, if there is a start transaction description specified in the Job. It is fired no matter which transfer method you select in the Transfer job description.

Parameters

Parameter

Description

Buffer 

The data formatted according to your start transaction description.

You can change Buffer, but if you do, remember to change the BufferSize as well. See the remarks below.

BufferSize 

The size of the Buffer. Note that the value of BufferSize must correspond to the Buffer length.

Return values

Return value

Description

EV_OK

Normal return.

EV_OK_ABORT 

No effect— treated the same as EV_OK.

EV_ERROR

Causes an error message and job termination.

Suggested usage

Could be used to intercept the formatted output for the start transaction and write it to one or more files or to a database. Other information can also be obtained from the Application and Job objects. See also the FormTransferRecord event.

Remarks

Only fired in the Transfer module, before the JobStarted event.

Note that this record is written twice to the output file: First when the job starts, and then it is updated (written to the same position in the file) when the job finishes. The update makes it possible to transfer the number of transferred records (see the ¤Records variable). Therefore, do not take advantage of the chance to change the buffer, since it is overwritten when the job is finished, anyway.

Job-level events