====== IDLEPROCQUEUE property ======


 
==== Applies To ====
 
System Object
 
==== Description ====
 
This is an enhancement to the existing [[idleproc|IDLEPROC]] property as it allows you to queue multiple requests via the new SYSTEM ADDIDLEPROC method:

<code>
* // Run a process in the future

procID     = "RUN_SOME_PROCESS"

procArg   = "42"

procTime = "12:00:00"; * %%//%% midday

procDate  = oconv( date() + 1, "D4/" ) ; * %%//%% tomorrow

 

call exec_Method( "SYSTEM", "ADDIDLEPROC", procID, procArg, procTime, procDate )

 

* // Run a process ASAP...

procID  = "RUN_SOME_OTHER_PROCESS"

procArg = "X43"

procTime = ""; * %%//%% ASAP

procDate = ""; * %%//%% ASAP

 

call exec_Method( "SYSTEM", "ADDIDLEPROC", procID, procArg, procTime, procDate )
</code>

The contents of the queue can be examined via the new SYSTEM IDLEPROCQUEUE property:


<code>
ipQ      = get_Property( "SYSTEM", "IDLEPROCQUEUE" )

xCount = fieldCount ( ipQ, @fm )

for x = 1 to xCount

     ip           = ipQ<x>

     procID    = ipQ<0,1>

     procArg   = ipQ<0,2>

     procTime = ipQ<0,3>

     procDate = ipQ<0,4>

next
</code>
 

The normal [[idleproc|IDLEPROC]] property works just as it always has done with the following caveats:

 

* Setting the [[idleproc|IDLEPROC]] property will replace the entire contents of the queue (so you can use this to clear the queue if you wish).

* Getting the [[idleproc|IDELPROC]] property will only return the first item in the queue if there are multiple items.