March 15, 2010 Volage Ltd P.

Lamary Document version: 1 CavokV5R4

Managing Cavok Tasks

1 Command line
Starting with CavokV5R4, command line facilities were added. Cavok can be launched with a command such as: F:/Cavok_Dev/Cavok_V501_T/ReleaseLama2_64/CavokV5.exe "F:/Cavok_Example501_T/Dev _TaskMager/TestImpAcou_3D.py" State= R Cpus= 2 Priority= 4 (1) where in this example 1. F:/Cavok_Dev/Cavok_V501_T/ReleaseLama2_64/CavokV5.exe is the path of the cavok executable, 2. "F:/Cavok_Example501_T/Dev _TaskMager/TestImpAcou_3D.py" is the script file to run. The double quotes are needed if blank characters are present in the string. 3. State= R is the initial state of the calculus. R stands for Run. The other options are: State= P, for Pause nor State= S for Stop. 4. Cpus= 2, is the number of Cpus you wish to use. Note that Cpus= -1 stands for an undefined value. In this case all the available Cpus will be used. 5. Priority= 4 is the priority of all Cavok processes and threads in regards to the other processes running on the machine. An undefined value of -1 leads to normal priority. The other possible values are: case 1: dwPriorityClass = ABOVE_NORMAL_PRIORITY_CLASS; case 2: dwPriorityClass = NORMAL_PRIORITY_CLASS; case 3: dwPriorityClass = BELOW_NORMAL_PRIORITY_CLASS; case 4: dwPriorityClass = IDLE_PRIORITY_CLASS; case 5: dwPriorityClass = PROCESS_MODE_BACKGROUND_BEGIN; case 6: dwPriorityClass = PROCESS_MODE_BACKGROUND_END; Note that arguments should be provided in the prescribed order of (1) and blank characters respected. Sate=, Cpus= and Priority= are note decoded, only a string is needed. For instance, the following command (2) will lead to the same results as (1): F:/Cavok_Dev/Cavok_V501_T/ReleaseLama2_64/CavokV5.exe "F:/Cavok_Example501_T/Dev _TaskMager/TestImpAcou_3D.py" S R toto 2 Priority= 4 (2)

Page 1/2

2 Running status files

When starting Cavok from valid command line (at least, a script file to run), Cavok will read at each frequency an input file named cav_in.txt, with state, cpus and priority instructions and write an output file, cav_out.txt, with the current state, the number of frequencies requested, the index of the current frequency and the duration in seconds of the previous iteration. You can modify the input parameters while Cavok is running by simply editing and writing new values in cav_in.tx file. In the same way, you can draw statistics using the cav_out.txt file. cav_in.txt and cav_out.txt should be located in the working directory, that is to say, the directory where the script file is located. Note: Using the interactive functions, Stop, Pause or Resume (that where added to the computation dialog box in CavokV5R4) will cut the link with the input/output writing process. cav_in.txt format: InState= P InNbCpus= -1 InPriority= -1 cav_out.txt format (where TimePerFreq is an integer): State= P NbFreq= 4 iFreq= 0 TimePerFreq= 0

3 Running several instances of Cavok

We recall that it is possible to run several Cavok programs at the same time, as long as the working directory is different for each running Cavok. The working directory is the directory where the script file is located.

4 CavokTaskManager
CavokTasManger is an utility program located in the util folder of CavokV5R4 distribution. CavokTasManger is written in QT, a multi platform language we experiment. You can copy CavokTasManger folder to an other location of your computer and start CavokTasManger.exe from there. It will help you to schedule the starting date of Cavok, change the input parameters when Cavok is running and retrieve the output status regularly.

*************************************

Page 2/2