Távoli adatfájl betöltő modul

PortaWin (PW2) Jármű mérlegelő program

Módosítva: 2005. 7. 20.

Ver:1.0

METRISoft Mérleggyártó KFT 6800 Hódmezővásárhely Jókai u. 30 Telefon: (62) 246-657, Fax: (62) 249-765 e-mail: [email protected] Web: http://www.metrisoft.hu

Érvényes:2005. 7. 20.

D:\R\PW2\Leiras\Kezut\RMTLoad.sxw

PortaWin (PW2) Jármű mérlegelő program Távoli adatfájl betöltő modul

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 Távoli adatfájl betöltő modul

METRISoft KFT Hmvhely Jókai u.30.

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 (EXECPATH)..........................................................................5 4.2. EREDMÉNYFILE GENERÁLÓ PROGRAM NEVE (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 (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

[email protected]


PW2.EXE Jármű Mérlegelő Program Remote Loader RMTLoad.EXE

8/3

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.

Jármű Mérlegelő Program

8/4


Távoli adatfájl betöltő modul

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énik1. 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

3 10 4

2

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


[email protected]



8/5

(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: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszó védett (ReadOnly) Min=- Max=- Nulla eng=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 (ExecFile) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) rmtcmd.exe Min=- Max=- Nulla eng=Eredményfile generáló program neve

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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) magbobj/mmyhpacl parm=('PORTVEX') Min=- Max=- Nulla eng=Eredményfile generáló program indítási paraméterei

4.4. Eredményfile generáló prg. auto indítási gyakoriság (ExecAutoRestart) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendszer (Critical) 30 [[sec]] Min=0 Max=10000 Nulla eng=Nem 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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendszer (Critical) 5 [[sec]] Min=0 Max=600 Nulla eng=Nem 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) Elérése:

DocVer: 1.0

Leállított rendsz.+jelszóvédett (ReadOnly)

File:RMTLoad.sxw

Printed :2004. IX.. 28.

Jármű Mérlegelő Program

8/6

Távoli adatfájl betöltő modul

Alapérték: Tartomány: Feladata:


Igen Min=- Max=- Nulla eng=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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendszer (Critical) 60 [[sec]] Min=0 Max=600 Nulla eng=Nem 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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) Igen Min=- Max=- Nulla eng=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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) MAIL\ Min=- Max=- Nulla eng=Eredményfile generáló program lefutásakor keletkező eredményfile elérése <path>

4.10. Eredményfile neve (ExecResultFile) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) kapuhpa.txt Min=- Max=- Nulla eng=Eredményfile neve

Megjegyzés: Az eredményfile egy TEXT állomány

4.11. Betöltött adatok átadása PW2 program számára (TextExport) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) Nem Min=- Max=- Nulla eng=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) Elérése: Alapérték: Tartomány: Feladata:


Leállított rendsz.+jelszóvédett (ReadOnly) DBF\IMPORT\ Min=- Max=- Nulla eng=Az alapértelmezett .\DBF\IMPORT adatexport path módosítása

[email protected]



8/7

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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendsz.+jelszóvédett (ReadOnly) MEGREND.TXT Min=- Max=- Nulla eng=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: Alapérték: Tartomány: Feladata:

Futásidejű (Normal) Nem Min=- Max=- Nulla eng=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) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendszer (Critical) 50 msec Min=- Max=- Nulla eng=Technológiai programszál behívási gyakoriság szabályozása

4.16. Logüzenetek naplófile mérete (LogFileMeret) Elérése: Alapérték: Tartomány: Feladata:

Leállított rendszer (Critical) 500 [[KByte]] Min=0 Max=10000 Nulla eng=Nem 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: Alapérték: Tartomány: Feladata: 0:Loghibak 1:LogAutoTranz 2:LogKezTranz 3:LogMeresTranz 4:LogSQLTranz

Futásidejű (Normal) 01111 Min=- Max=- Nulla eng=Események loggolása 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 Távoli adatfájl betöltő modul


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= 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:, Mentve: 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= 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 -


[email protected]

Távoli adatfájl betöltő modul

Recommend Documents