Cicode Programming Reference > Cicode Function Categories > Report Functions Introduction > RepGetControl


Gets report control information on a report. This function is a blocking function. It will block the calling Cicode task until the operation is complete.


RepGetControl(ReportName, Type [, ClusterName])


The name of the report (can be prefixed by the name of the cluster that is ClusterName.ReportName).


The type of report control information to get (send back in the return value):

0 - State of the report - returns one of:

1 - Time of day that the report is due to run next.

2 - The report period, in seconds, or week day, month or year, for example, if the report is weekly, this is the day of the week, 0 (Sunday) to 6 (Saturday).

3 - Synchronisation time of day of the report, for example, 10:00:00 (In seconds from midnight).

4 - Type of report schedule - returns one of:

5 - Report state - returns one of:


Name of the cluster in which the report resides. This is optional if you have one cluster or are resolving the report server via the current cluster context. The argument is enclosed in quotation marks "".

Return Value

The control information, as an integer.

Related Functions

RepSetControl, Report


! Sets Next to the time that the report is due to run.
! Display a message at the prompt AN (AN2) if
! the report is running.
IF RepGetControl("SHIFT",0,"ClusterXYZ")=3 THEN
Prompt("Shift report is running");

See Also

Report Functions