Release Date: 1 February 2008
Namedt_continue - continue a task in progress
Generic Prototypedt_continue(dt_Handle, dt_Integer *) => dt_Integer
C Prototype#include "dt_thor.h"
dt_Integer dt_continue(dt_Handle server, dt_Integer *status)
FORTRAN Prototypeinclude 'dt_f_thor.inc'
integer*4 dt_f_continue(server, status)
DescriptionContinues the current task in progress. The returned 'status' parameter indicates how the task is progressing as follows:
DX_STATUS_IN_PROGRESS not finished, task in progress DX_STATUS_DONE task completed, target(s) found DX_STATUS_NOT_FOUND task completed, target(s) not found DX_STATUS_ERROR error, operation not completed
Return ValueReturns the progress for a task. Dividing this value by the return value of dt_done_when(3) gives the fraction of the task completed.
Returns -2 if an error is encountered, and -1 if the search completed but no hits were found. 0 or higher indicates progress or, if the task has completed, the hitlist length.
The final value returned after the task has completed may not be equal to the "final progress" value returned by dt_done_when(3). The "final progress" value reflects the amount of work to be done, not list size.
It is an error to call dt_continue(3) when no task is in progress. It can only be called after a search, sort or dt_continue(3) call has returned a status of DX_STATUS_IN_PROGRESS.
Related Topicsdt_abort(3) dt_done_when(3)
dt_mer_numsearch(3) dt_mer_similarselect(3) dt_mer_sort(3) dt_mer_strsearch(3) dt_mer_subselect(3) dt_mer_subselect2name(3) dt_mer_superselect(3)