$Id: e_tool.C,v 1.7 2004/06/04 09:15:29 gueltlin Exp $
   ---------------------------------------------------------------------
   Kurzbeschreibung: 	Aufruf eines externen Programmes/Scriptes
   ---------------------------------------------------------------------
   Projekt:		BOSCH ccs
   Sourcefile:		e_tool.C 
   Autor:		RtW2/TEF32-Gueltling
   Zielsystem:		SuSE Linux 8.1
   Sprache:		Ansi-C++
   ---------------------------------------------------------------------
   Prototyp:
   MPI Schnittstelle
   
   ------------------------------------------------------------------------
   Aufruf: im Vectorinterpreter
   
   error =  (*funktionen[modulnummer])
	    (Ssp_expand_zeile
	    ,Ssp_expand_wert
	    ,p_verwaltung->begin_modulblock
	    ,p_verwaltung->anzahl_modulparameter);

   if (error == -1)
   {
   // Fehlerbehandlung
   }
   
   ------------------------------------------------------------------------
   Funktionsbeschreibung: 			<GFMT KS=on TAB=8 LF=on>
   
   Das Modul ruft ein Programm oder shell Script auf. Das Programm /
   shell Script liefert Retun Wert:
   0: Abarbeitung ok
   1: Fehler in Abarbeitung
   sonst: Pruefling schlecht
   
   Groß/Klein-Schreibung:
   Default bei Gaudi ist Großschreibung. Es kann mittels "^" Zeichen
   Umgeschaltet werden (Toggle).
   
   Platzhalter:
   Platzhalter werden mittels Routine covert_variables aufgeloest.
   Syntax %{xx} 
   Momentan unterstuetzt:
   %{TTNR},%{TYP},%{VARIANTE},%{WERK},%{SWNR},%{ECUID},%{KNOTEN}, 
   %{SECTION},%{MSEC},%{SEC},%{MIN},%{HOUR},%{DAY},%{MONTH},
   %{YEAR},%{TESTSWNR}
   
   Ausgaben
   Die Ausgaben der aufgerufenen Programmes / Scripts werden auf
   /tmp/e_tool_<PID>.txt umgelenkt.Meldungen, die den String
   ERROR enthalten, werden im Fehlerfall in das Log-File des CCS 
   uebernommen. 
   Falls der Debug-Level DEB_KOMM gesetzt ist erfolgt keine 
   Ausgabeumlenkung.
   
   Ûbergabeparameter anhand der Modglobal.stl
   ,PRUEFSCHRITT
   ,POSITION
   ,P_START      SGTEST:RUESTLAUF
                 Modul wird beim Test des SG oder beim Ruestlauf durchlaufen
   ,SUBDIR       Unterverzeichnis imn dem das Programm zu finden ist
   ,PROGRAMMNAME Name vom Programme oder shell script
   ,P_WARTE      Warte X Sekunden auf Beendigun des Programmes
                 0 warte ewig
                 -1 kehrt sofort zurueck
   ,ABORT_SIGNAL Sende Signal an Prozess bei Abbruck
   ,TERMINAL     Das Programm kann in einem eigenen X-Fenster laufen
                 nocht nicht implementiert
   ,PARA1        Uebergabeparameter an Script / Programm
   ,PARA2
   ,PARA3
   ,PARA4
   ,PARA5
   
   ,RETURN_WERT  Als Return WErt kommt die PID des neuen Prozesses zurueck
   ,ERRORFLAG    Returnwert des Prozesses = 1 --> Fehler im System
                 sonst Geraet schlecht