METRISoft Mérleggyártó KFT PortaWin (PW2) Jármű mérlegelő program 6800 Hódmezővásárhely Jókai u. 30 Telefon: (62) 246-657, Fax: (62) 249-765 e-mail: merleg@metrisoft.hu Web: http://www.metrisoft.hu Módosítva: 2005. 7. 20. Ver:1.0 Érvényes:2005. 7. 20. D:\R\PW2\Leiras\Kezut\RMTLoad.sxw PortaWin (PW2) Jármű mérlegelő program Hódmezővásárhely, 2005. július 20. Készítette: Petényi István programozó METRISoft Kft.
8/2 Jármű Mérlegelő Program METRISoft KFT Tartalomjegyzék 1. NYILATKOZAT... 3 2. A PROGRAM MŰKÖDÉSE...3 2.1. ÖSSZEFOGLALÓ SPECIFIKÁCIÓ...3 3. KEZELÉSI ÉS ELLENŐRZÉSI FUNKCIÓK...4 4. PROGRAM KONFIGURÁCIÓ... 5 4.1. EREDMÉNYFILE GENERÁLÓ PROGRAM ELÉRÉSI ÚT <PATH> (EXECPATH)...5 4.2. EREDMÉNYFILE GENERÁLÓ PROGRAM NEVE <FILE> (EXECFILE)...5 4.3. EREDMÉNYFILE GENERÁLÓ PROGRAM INDÍTÁSI PARAMÉTEREI (EXECPARAMS)...5 4.4. EREDMÉNYFILE GENERÁLÓ PRG. AUTO INDÍTÁSI GYAKORISÁG (EXECAUTORESTART)... 5 4.5. EREDMÉNYFILE AUTOMATIKUS ELLENŐRZÉS IDŐZÍTŐ (EXECFILECHECKTIME)... 5 4.6. 'EXECFILECHECKTIME' AKTIVITÁS ÜZEMMÓDJA (CANALWAYSCHECKEXECFILE)...5 4.7. EREDMÉNYFILE KELETKEZÉSI HATÁRIDŐ [SEC] (EXECBUSYTIMEOUT)...6 4.8. VÉGREHAJTANDÓ PRG.EREDMÉNYFILE TÖRLÉS ENGEDÉLYEZÉS (CANDELETERESULTFILE)...6 4.9. EREDMÉNYFILE GENERÁLÓ PROGRAM EREDMÉNYFILE ELÉRÉS (EXECRESULTPATH)... 6 4.10. EREDMÉNYFILE NEVE <FILE> (EXECRESULTFILE)... 6 4.11. BETÖLTÖTT ADATOK ÁTADÁSA PW2 PROGRAM SZÁMÁRA (TEXTEXPORT)...6 4.12. AZ ALAPÉRTELMEZETT ADATEXPORT PATH MÓDOSÍTÁSA (TEXTEXPORTPATH)... 6 4.13. AZ EXPORT FILE ELNEVEZÉSE. (TEXTEXPORTFILE)... 7 4.14. A PROGRAM BETÖLTÉSE UTÁNI MEGJELENÍTÉS (STARTMINIMIZED)...7 4.15. TECHNOLÓGIAI PROGRAMSZÁL BEHÍVÁS GYAKORISÁG (TMFSZTIMER)... 7 4.16. LOGÜZENETEK NAPLÓFILE MÉRETE (LOGFILEMERET)...7 4.17. ESEMÉNYEK LOGGOLÁSA (LOGFLAGS)...7 5. EGYÉB KAPCSOLATI ÉS INDÍTÁSI PARAMÉTEREK... 7 5.1. RMTLOAD AUTOMATIKUS INDÍTÁSÁNAK KONFIGURÁLÁSA... 7 5.2. SAJÁT PARAMÉTEREK TÁROLÁSA...8 5.2.1. Továbbított adatsorok loggolásának állománya... 8 5.2.2. Megelőző forrás állomány jellemzőinek mentése... 8 5.3. PROGRAM INDÍTÁSA MÁS ÚTVONALON... 8 5.4. EGYÉB INDÍTÁSI FELTÉTEL... 8 Egyéb dokumentumok: PW2 Jármű Mérlegelő Program Kezelési Utasítás (prgkez) PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv (uzem) PW2 Jármű Mérlegelő Program Termék kiszállítási mérlegelés eljárási mód (ku_3047) Http://www.metrisoft.hu petenyi_istvan@metrisoft.hu
METRISoft KFT PW2.EXE Jármű Mérlegelő Program 8/3 Remote Loader RMTLoad.EXE 1. Nyilatkozat Ez a dokumentum a PW2.EXE Jármű Mérlegelő Program Kezelési Utasítás kiegészítése. A program fölé rendelt, központi informatikai rendszerrel való adatcserét végrehajtó önálló program modul működésével és kezelésével kapcsolatos ismérveket tartalmazza. A Járműmérlegelő program V2.3.6.8 verziójától kerültek beépítésre olyan szöveges adatfile (TEXT) import funkciók, amelyek számára ez a programmodul biztosítja a távoli rendszertől a szövegfájlok folytatólagos és ciklikus importját. A program modul üzemelési és kezelési szempontból független a Járműmérlegelő programtól. A modul működéséhez az alábbi Licensz opció megléte szükséges: 'Eredménynapló automatikus TEXT export' A program üzemeltetése a Járműmérleg kiegészítéseként, azzal azonos számítógépen, egyidőben vagy annak futásától függetlenül történik. 2. A program működése A program megfelelő beállítás esetén automatikusan biztosítja: Egy meghatározott további program ciklikus időközönkénti lefuttatását (forrás file generátor) A forrás file generátor futásának hatására létrejött forrásfile betöltését a Járműmérleg program számára A művelet normál esetben úgy zajlik, hogy a forrás file generátor program elindításakor, az a továbbiakban függetlenül végrehajt egy tetszőleges feladatot. Ennek eredményeként, meghatározott időn belül létrejön egy adatfile. Az adatfile meghatározott DOS elérési útvonalon, konstans néven jön létre. A forrás file generátor indítását követően az RMTLoad program ciklikusan vizsgálja, hogy a kívánt forrás file létrejött-e / megfelelően módosult-e? Ha igen, a forrás file-t beolvassa és a Járműmérleg program számára kijelölt útvonalon, fix néven elhelyezi. Az elhelyezés folytatólagos: ha a cél file nem létezik, akkor létrejön, ha létezik hozzáfűzésre kerülnek az új tételsorok. A program nem foglalkozik a továbbítandó file tartalmával. Egy forrás file akkor kerül a fenti módon feldolgozásra, ha a méretében vagy módosítási időpontjában változás lépett fel, a megelőző feldolgozáshoz képest. 2.1. Összefoglaló specifikáció A forrás file generátor programra vonatkozó előírások Elérése egy meglevő DOS útvonalon biztosított Megnevezése konstans Lefutása nem modális, azaz indítását követően a behívó program a vezérlést visszakapja Forrás file-ra vonatkozó előírások Elérése egy meglevő DOS útvonalon biztosított Megnevezése konstans Tartalma érdektelen (az RMTLoad program számára) Létrehozása a forrás file generátor program indítását követően egy értelmes, záros határidőn belül kötelező. A létrejövő file a megelőzőt felülírja, még akkor is, ha nem tartalmaz haszonadatot (0 hosszban létrejön) A file feldolgozásához az RMTLoad programnak katalógus olvasási jog, file nyitási jog (csak olvasás) és file beolvasási jog szükséges. A file beolvasása az ütközések kivédése érdekében kizárólagos (exclusíve ) módon történik. Eredmény file-ra vonatkozó előírások Elérése egy meglevő DOS útvonalon biztosított Megnevezése konstans Az újabb bejövő file a megelőzőhöz hozzáfűzésre kerül vagy új file jön létre. A hozzáfűzés megosztott módon történik. DocVer: 1.0 File:RMTLoad.sxw Printed :2004. IX.. 28.
8/4 Jármű Mérlegelő Program METRISoft KFT 3. Kezelési és ellenőrzési funkciók A Járműmérleg indításakor az RMTLoad program indítása automatikusan megtörténik 1. Ennek elmaradása hibás konfiguráció vagy hibás telepítés esetén lehetséges. A programot a kezelő is elindíthatja. Telepítése a PW2.EXE járműmérleg programmal azonos könyvtárba történik. A program indítását követően általában ikonizált állapotban indul, mivel kezelése ritkán szükséges. Működése egy háttér szolgáltatást nyújt, megfelelő beállítás esetén a távoli adatállomány kellő rendszerességgel betöltésre kerül a Járműmérleg program számára. A program egy ablakban lehetővé teszi a működés ellenőrzését, a beállítások megváltoztatását, illetve soron kívüli adatállomány átvétel indítását. 9 1 10 3 2 4 5 6 7 8 (1) Az adatletöltési folyamat azonnali indítási lehetősége a kezelő által. (2) Automatikus adatletöltési folyamat indítási időzítő állapota. Az időzítő visszafelé lépked másodpercenként. Nullára futásakor 'Kikapcsolt' állapotba kerül és elindításra kerül a forrás generátor program (4). (3) A forrás generátor elindítását követően a beállított várakozási idő alatt létrejövő forrás állomány útvonala és neve. Ha a program éppen vizsgálja vagy feldolgozza, a kiemelés sárga. Ha a file nem létezik, a kiemelés szürke. Alatta az állomány aktuális jellemzői láthatók (mérete és módosításának időpontja) (4) Az elindítandó forrás file generátor program elérési útja és neve. Ha a program éppen indítva van (tehát aktív), a kiemelés sárga. Ha a file nem létezik, a kiemelés szürke. Alatta az aktuális állapota látható (OK!, INDÍTVA, Nem létezik) (5) A Járműmérleg programmal közös átadó állomány elérési útvonala és neve. Az állomány, miután a Járműmérleg programban betöltötték, törlésre kerül. Ilyenkor a kiemelése szürke. Alatta az aktuális jellemzői láthatók (mérete és módosításának időpontja) (6) A forrás állomány megelőző feldolgozásakor feljegyzett jellemzők. A következő forrás állomány akkor érvényes (csak akkor lesz beolvasva), ha annak jellemzői (3) különböznek az itt levőktől. (7) Általános program üzenetablak. Az RMTLoad program működési információit listázza. Feladata csak rendellenesség esetén, hibakeresés céljából van. (8) Kilépés gomb. Azonos funkciójú, mint az általános ablak bezáró gomb (x az ablakok jobb felső részén) (9) Főmenü. A program beállításai és az üzenetablak (7) kezelésével kapcsolatos műveletek találhatók itt. 1 A programot legelőször önállóan kell elindítani, akkor jön létre az indítási bejegyzés a PW2 számára Http://www.metrisoft.hu petenyi_istvan@metrisoft.hu
METRISoft KFT PW2.EXE Jármű Mérlegelő Program 8/5 Remote Loader RMTLoad.EXE (10)Forrás állomány ellenőrzés időzítő. Általában akkor üzemel, ha a forrás generátor program elindítása megtörtént. Addig működik, amíg annak működésre engedélyezett ideje le nem jár. Az időzítő ciklikusan nullára számlál ezalatt és a nullára futáskor ellenőrzi a program a forrás állományban bekövetkezett változásokat. Változás esetén azonnal megtörténik a feldogozás. 4. Program konfiguráció A program beállításai a főablak => beállítások => Program konfiguráció menüben érhető el. A megjelenő ablakban a megfelelő paraméter kiválasztásával annak értéke szerkeszthető. 4.1. Eredményfile generáló program elérési út <path> (ExecPath) Elérése: Leállított rendsz.+jelszó védett (ReadOnly) Alapérték: Feladata: Eredményfile generáló program elérési út <path> A programot ezen az útvonalon kell lefuttatni ahhoz, hogy az eredményfile létrejöjjön. 4.2. Eredményfile generáló program neve <file> (ExecFile) Alapérték: rmtcmd.exe Feladata: Eredményfile generáló program neve <file> Ezt a programot kell lefuttatni ahhoz, hogy az eredményfile létrejöjjön a konfigurált útvonalon. 4.3. Eredményfile generáló program indítási paraméterei (ExecParams) Alapérték: magbobj/mmyhpacl parm=('portvex') Feladata: Eredményfile generáló program indítási paraméterei 4.4. Eredményfile generáló prg. auto indítási gyakoriság (ExecAutoRestart) Alapérték: 30 [[sec]] Tartomány: Min=0 Max=10000 Nulla eng=nem Feladata: Eredményfile generáló program automatikus indítási gyakoriság Az értéket [sec] dimenzióban kell megadni. 0:Szervíz OFF (A kezelőnek kell az indítást kezdeményeznie) 4.5. Eredményfile automatikus ellenőrzés időzítő (ExecFileCheckTime) Alapérték: 5 [[sec]] Tartomány: Min=0 Max=600 Nulla eng=nem Feladata: Eredményfile automatikus ellenőrzés időzítő Az értéket [sec] dimenzióban kell megadni. A megadott időközönként ellenőrzi, hogy az eredményfile létrejött-e? 0:Szervíz OFF Ha az eredményfile ellenőrzése konfigurálva van, annak időszaka a 'CanAlwaysCheckExecFile' paraméterben szabályozható. Az ellenőrzés alapja a file módosítási időpontja és mérete és az előző feldolgozáshoz van hasonlítva. 4.6. 'ExecFileCheckTime' aktivitás üzemmódja (CanAlwaysCheckExecFile) DocVer: 1.0 File:RMTLoad.sxw Printed :2004. IX.. 28.
8/6 Jármű Mérlegelő Program METRISoft KFT Alapérték: Igen Feladata: Eredményfile automatikus ellenőrzés időzítő 'ExecFileCheckTime' aktivitás üzemmódja IGEN: Az eredményfile ellenőrzése letöltési szünetben is lehetséges NEM: Az eredményfile ellenőrzése csak a letöltés folyamatban lehetséges 4.7. Eredményfile keletkezési határidő [sec] (ExecBusyTimeout) Alapérték: 60 [[sec]] Tartomány: Min=0 Max=600 Nulla eng=nem Feladata: Eredményfile keletkezési határidő [sec] A generáló program indítását követően megengedett várakozási idő. Ennyi idő alatt az eredményfile-nak létre kell jönnie, annak keletkezése az idő lejárta után már nem lehetséges. Megjegyzés: Ha az idő lejár és az eredményfile mégis létrejön később, ez adatvesztést eredményezhet! Ezt az ExecFileCheckTime>0 és a CanAlwaysCheckExecFile=IGEN beállításokkal lehet kiküszöbölni. 4.8. Végrehajtandó prg.eredményfile törlés engedélyezés (CanDeleteResultfile) Alapérték: Igen Feladata: Végrehajtandó program eredményfile törlésének engedélyezése IGEN: Az eredményfile feldolgozás után törölhető. NEM: Nincs törlés. Az újabb eredményfile detektálásának feltétele, hogy a végrehajtandó program indítása előtt beolvasott eredményfile (előző file) hossza és keletkezési dátuma megváltozzon a végrehajtás után (aktuális file). 4.9. Eredményfile generáló program eredményfile elérés (ExecResultPath) Alapérték: MAIL\ Feladata: Eredményfile generáló program lefutásakor keletkező eredményfile elérése <path> 4.10. Eredményfile neve <file> (ExecResultFile) Alapérték: kapuhpa.txt Feladata: Eredményfile neve <file> Megjegyzés: Az eredményfile egy TEXT állomány 4.11. Betöltött adatok átadása PW2 program számára (TextExport) Alapérték: Nem Feladata: Betöltött adatok átadása PW2 program számára IGEN: Export engedélyezve (A szolgáltatás a megvásárolt Szoftver Licensz függvényében működik!) NEM: Szervíz OFF (Adatok átadása letiltva) 4.12. Az alapértelmezett adatexport path módosítása (TextExportPath) Alapérték: DBF\IMPORT\ Feladata: Az alapértelmezett.\dbf\import adatexport path módosítása Http://www.metrisoft.hu petenyi_istvan@metrisoft.hu
METRISoft KFT PW2.EXE Jármű Mérlegelő Program 8/7 Remote Loader RMTLoad.EXE A PW2 programban azonosan beállítva! A program folytatólagosan erre az útvonalra helyezi a beolvasott eredményfile-t Ha a file nem létezik, létrejön. Ha létezik, az újabb tételek a file végére kerülnek. 4.13. Az export file elnevezése. (TextExportFile) Alapérték: MEGREND.TXT Feladata: Az export file elnevezése. A PW2 programban azonosan beállítva! A lehozott eredményfile-t ezen a néven adja át a program. Az átadás folytatólagosan hozzáfűzi az új adatsorokat a meglevőkhöz, ha a file létezik. 4.14. A program betöltése utáni megjelenítés (StartMinimized) Elérése: Futásidejű (Normal) Alapérték: Nem Feladata: A program betöltése utáni megjelenítés IGEN: ikonizált állapotban indul NEM: Ablakot nyit 4.15. Technológiai programszál behívás gyakoriság (TMFSZTimer) Alapérték: 50 msec Feladata: Technológiai programszál behívási gyakoriság szabályozása 4.16. Logüzenetek naplófile mérete (LogFileMeret) Alapérték: 500 [[KByte]] Tartomány: Min=0 Max=10000 Nulla eng=nem Feladata: Logüzenetek naplófile mérete 0:nincs méretkorlát >0:a megadott méreten tart (Levágási hiszterézis fix: 50KByte!) 4.17. Események loggolása (LogFlags) Elérése: Futásidejű (Normal) Alapérték: 01111 Feladata: Események loggolása 0:Loghibak 1:LogAutoTranz 2:LogKezTranz 3:LogMeresTranz 4:LogSQLTranz Feldolgozási, futási hibák üzenetablakra küldése Feldolgozási műveletek üzenetablakra küldése Kezelői akciók üzenetablakra küldése N/A N/A 5. Egyéb kapcsolati és indítási paraméterek A program a PW2.EXE Járműmérleg programmal azonos könyvtárban kell legyen. Indításakor a PW2.INI konfigurációs állományt használja. 5.1. RMTLoad automatikus indításának konfigurálása A program az INI file [STARTUP] szekciójában minden indításakor frissíti az elindításához szükséges paramétersort. Ezt a PW2 Járműmérleg program használja fel. Annak betöltődésekor a paramétersor alapján elindítja az RMTLoad programot. DocVer: 1.0 File:RMTLoad.sxw Printed :2004. IX.. 28.
8/8 Jármű Mérlegelő Program METRISoft KFT Példa bejegyzés: [STARTUP].. PRELOADMODUL=D:\R\PW2\PW2_3047\RMTLOAD.EXE /AUTOSTART /INI=D:\R\PW2\PW2_3047\PW2.INI... 5.2. Saját paraméterek tárolása Az állományban a program egy saját szekciót hoz létre: [RMTLOAD] Ebben különféle, a járműmérleg programot nem érintő kitárolásokat végez. 5.2.1. Továbbított adatsorok loggolásának állománya Formája: RTMDATALOG=<full path> Példa: RTMDATALOG=D:\R\PW2\PW2_3047\RMTLOG.TXT Minden továbbított adatsor ebbe az állományba is bekerül. Az állomány tetszőlegesen törölhető, feladata kérdéses esetekben annak tisztázása, hogy egy adatsor eljutott-e a forrásból a célba. 5.2.2. Megelőző forrás állomány jellemzőinek mentése Formája: LSSTATE=Karakterek:<nn>, Mentve:<yyyy.mm.dd. hh.nn.ss> Példa: LSSTATE=Karakterek:2500, Mentve:2005.07.20. 8:50:10 Minden feldolgozás után, a kurrens forrásállomány jellemzői kitárolásra kerülnek. Ez a változás vizsgálat alapja. 5.3. Program indítása más útvonalon Ha a program indítási könyvtárában nem található meg a PW2.EXE indító állománya, akkor parancssorban közölni kell a PW2.INI állomány teljes elérési útvonalát az RMTLoad indításakor. Formája: /INI=<full path> Példa: RMTLoad /INI=D:\R\PW2\PW2_3047\PW2.INI Az INI file-ban található CNFPATH bejegyzés szerinti útvonalon tárolja a konfigurációs adatállományait. 5.4. Egyéb indítási feltétel Az RMTLoad program indítási útvonalán léteznie kell a PW2.EXE programhoz kiadott Szoftver Licensz filenak. A file-nak tartalmaznia kell a 'Eredménynapló automatikus TEXT export' licensz opciót. A file szokásos neve az alábbi Formája: MS_xxxxx.URF, ahol xxxxx a szoftver eladási sorszáma Példa: MS_03047.URF A program futtatásakor a konfigurációs adatállományait a Borland Database Engine (BDE) segítségével kezeli. Ezért a futtató gépen ennek üzemképesen jelen kell lennie. - vége - Http://www.metrisoft.hu petenyi_istvan@metrisoft.hu