Event fired periodically during long-running data processing operations.

Parameters

<percent expN>

The approximate percent-complete of the operation, from 0 to 100. When a message is passed, <percent expN> is the value -1.

<message expC>

A text message from the database engine.

Property of

Session

Description

Use onProgress to display progress information during data processing operations such as copying or indexing.

onProgress fires for the following operations:

Database::copyTable( )

COPY TABLE

All UpdateSet methods

APPEND FROM

Database::createIndex( )

COPY TO

INDEX ON

SORT

The onProgress event handler receives two parameters, but only one of them is valid for any given event. You may get either:

  1. A percent-complete from 0 to 100 in <percent expN>, in which case <message expC> is a blank string, or