Daylight v4.9
Release Date: 1 February 2008

Name

dt_continue - continue a task in progress

Generic Prototype

dt_continue(dt_Handle, dt_Integer *) => dt_Integer

C Prototype

#include "dt_thor.h"

dt_Integer dt_continue(dt_Handle server, dt_Integer *status)

FORTRAN Prototype

include 'dt_f_thor.inc'

integer*4 dt_f_continue(server, status)

integer*4 server
integer*4 status

Description

Continues 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 Value

Returns 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 Topics

dt_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)