TaskMgr-Verzeichnisstruktur und Dateien

Für den Sydro-TaskManager ist die Verzeichnisstruktur prinzipiell nicht festgelegt. Es ist aber für den Anwender praktisch, wenn die TaskManager-Dateien mit einem festen Bezug zu und in der Nähe der TaskServer-Dateien liegen, da so nur kurze relative Pfade in das TaskManager Input-File eingegeben werden müssen. Dazu kann beispielsweise ein Ordner TaskMgr in dasselbe Verzeichnis wie der Ordner TaskSrv gelegt werden.

SydroTaskMgr.exe

SydroTaskMgr.exe ist die ausführbare Programmdatei des Taskservers. Sie kann entweder über einen Doppelklick gestartet werden oder über die Kommandozeile. Liegt die Input-Datei SydroTaskMgr.process.xml im selben Verzeichnis müssen keine weiteren Argumente eingegeben werden. Trägt die Input-Datei einen anderen Namen, muss der Dateiname in der Kommandozeile als Argument mitgegeben werden.

Nach Starten der ausführbaren Programmdatei öffnet sich das Fenster des TaskManagers. Hier wird lediglich der Status des TaskManagers eingetragen (die Meldungen können schnell wechseln, wenn die TASKS schnell durchlaufen). Ist der TaskManager fertig, schließt sich das Fenster automatisch. Eine Zusammenfassung der Statusberichte kann dann in dem neu geschriebenen File diag.xml gelesen werden.

SydroTaskMgr.process.xml

Die Datei SydroTaskMgr.pcess.xml ist die Input-Datei für den TaskManager im XML-Format. Hier wird eingestellt, welche Tasks der TaskManager nacheinander abarbeiten soll und die nötigen Argumente dafür mitgegeben.

Beispiel für eine SydroTaskMgr.pcess.xml-Datei mit drei Tasks (Pre-Processing, Simulation, Post-Processing):

<TaskList xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <WriteDiag>true</WriteDiag>
  <DiagFormat>FEWS</DiagFormat>
  <DiagDir>.</DiagDir>
  <ErrorHandling>DefaultHandling</ErrorHandling>
  <Tasks>
    <Task>
      <Active>false</Active>
      <Job>RunExecutable</Job>
      <Description>Input Abfluss einlesen und in TalsimNG Binaer Format konvertieren</Description>
      <Key>?</Key>
      <ErrorHandling>DefaultHandling</ErrorHandling>
      <Execute>..\TaskSrv\Exe\tasksrvi.exe</Execute>
      <Executable>TaskSrv</Executable>
      <ProcessWindowsStyle>Hidden</ProcessWindowsStyle>
      <Arguments>tasksrv.Import_FewsZeitreihenkomplett.Q.run</Arguments>
      <FileFormat>FEWS</FileFormat>
      <FileSelectionPattern>?</FileSelectionPattern>
      <NewFileExtension>?</NewFileExtension>
      <InputFile>?</InputFile>
      <OutputFile>?</OutputFile>
      <OutputDir>?</OutputDir>
    </Task>
    <Task>
      <Active>false</Active>
      <Job>RunExecutable</Job>
      <Description>Simulation Gesamtsystem</Description>
      <Key>?</Key>
      <ErrorHandling>DefaultHandling</ErrorHandling>
      <Execute>..\TaskSrv\Exe\talsimw.exe</Execute>
      <Executable>Talsim</Executable>
      <ProcessWindowsStyle>Hidden</ProcessWindowsStyle>
      <Arguments>talsim.nagesamt.run</Arguments>
      <FileFormat>FEWS</FileFormat>
      <FileSelectionPattern>?</FileSelectionPattern>
      <NewFileExtension>?</NewFileExtension>
      <InputFile>?</InputFile>
      <OutputFile>?</OutputFile>
      <OutputDir>?</OutputDir>
    </Task>	
    <Task>
      <Active>true</Active>
      <Job>RunExecutable</Job>
      <Description>aus Talsim-NG Ergebnissen MinMaxMittel Statistik ermitteln</Description>
      <Key>?</Key>
      <ErrorHandling>DefaultHandling</ErrorHandling>
      <Execute>..\TaskSrv\Exe\tasksrvi.exe</Execute>
      <Executable>TaskSrv</Executable>
      <ProcessWindowsStyle>Hidden</ProcessWindowsStyle>
      <Arguments>tasksrv.Result_MinMaxMittel.run</Arguments>
      <FileFormat>FEWS</FileFormat>
      <FileSelectionPattern>?</FileSelectionPattern>
      <NewFileExtension>?</NewFileExtension>
      <InputFile>?</InputFile>
      <OutputFile>?</OutputFile>
      <OutputDir>?</OutputDir>
    </Task>
	</Tasks>
</TaskList>

Die wichtigsten Argumente zu den Tasks in der Input-Datei:

Argument	Beispieleinträge	Beschreibung
Active	true, false	Ist die Task aktiv, d.h. soll sie beim Starten des TaskManagers ausgeführt werden?
Job	RunExecutable, CleanUpDirectory	Eindeutiger Name des Jobs (z.B. RunExecutable: auführbare Programmdatei starten)
Description	Step 1/10: Download and process data from DWD	Beschreibung der Task (frei)
ErrorHandling	DefaultHandling	Einstellung, wie Fehler behandelt werden sollen	Execute	..\TaskSrv\Exe\tasksrvi.exe	Pfad zur ausführbaren Programmdatei
Executable	TaskSrv	Name der ausführbaren Programmdatei
ProcessWindowsStyle	Normal, Hidden	Prozessfensterstil (Normal: Fenster des aufgerufenen Programms wird während der Ausführung angezeigt; Hidden: Fenster werden nicht angezeigt)
Arguments	tasksrv_DWD_00_Cmd_Process.run	Argument für die ausführbare Programmdatei (z.B. `*.run`-Dateien von TaskServer oder Talsim)

diag.xml

Kurzbericht des TaskManager-Laufs. Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<Diag version="1.2" xmlns="http://www.wldelft.nl/fews/PI" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_diag.xsd">
 <line description="TaskList: Process" level="3"/>
 <line description="Task: Process (inactive):Input Abfluss einlesen und in TalsimNG Binaer Format konvertieren" level="3"/>
 <line description="Task: Process (inactive):Simulation Gesamtsystem" level="3"/>
 <line description="Task: Process (active):aus Talsim-NG Ergebnissen MinMaxMittel Statistik ermitteln" level="3"/>
 <line description="TaskExecuteTaskSrv: Run Executable, tasksrvi.exe, C:\TalsimNG\Customers\Auftraggeber_1\projectData\user1\TaskSrv\Exe\, C:\TalsimNG\Customers\Auftraggeber_1\projectData\user1\TaskSrv\Exe\, tasksrv.Result_MinMaxMittel.run" level="3"/>
 <line description="TaskExecuteTaskSrv: aus Talsim-NG Ergebnissen MinMaxMittel Statistik ermitteln terminated, number of Warnings=    33 and Errors=     0" level="3"/>
</Diag>

SydroTaskMgr.log

Weitere Dateien

Für die Ausführung des TaskManagers müssen im gleichen Verzeichnis weitere Dateien vorhanden sein, aber nicht angepasst werden:

SydroTaskMgr.exe.config
SydroTaskMgr.log.config
log4net.xml
log4net.dll