TaskMgr-Verzeichnisstruktur und Dateien

Aus TALSIM Docs

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.

Fenster Sydro TaskManager.PNG

Fenster Sydro TaskManager Status.PNG

Fenster Sydro TaskManager Status finished.PNG

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