[Textlib] Rekordok küldése a MOKKA-ba

[Thék György]

Kedves TextLibesek!

E leírás azoknak készült, akik rekordokat szeretnének Hunmarc formában 
kinyerni a TextLib adatbázisból, és azokat elküldeni a MOKKA 
Egyesületbe. Nagy mennyiségű Hunmarc rekord - most ez a feladat - 
előállításának a legegyszerűbb, és mindenki által használható módja egy 
találati halmaz exportja egy parancssoros programmal.

Az előfeltételekről Bánkeszi Kati írt a Katalistre "MOKKA átállás és 
rekordfeltöltések" című levelében 2011. 06. 13-án. (Az archívumban: 
https://listserv.niif.hu/pipermail/katalist/2011-June/023691.html) Azok 
teljesítése után jöhet a textlibes munka.

1. Könyvtárkód
A Dávid Boglárkától, a DEENK ODR felelősétől kapott könyvtárkódot 
rendszergazdaként a [Rendszer - Könyvtárunk adatai] ablak 'MOKKA 
azonosítónk' mezőjébe kell írni. Az export ezt az azonosítót bemásolja 
minden exportált rekord 850 $a mezőjébe.

2. A találati halmaz
A találati halmaz elkészítésére nincs recept, a módszert a feladat 
szabja meg. Egyetlen példa: ha a cél a könyvtár saját példányainak és a 
hozzájuk tartozó bibliográfiai rekordoknak a MOKKA-ba küldése, akkor 
keressük meg a példányokat, majd a találati halmazt táblázatosan mutató 
ablak alján nyomjuk a 'lista' gombot, válasszuk az 'Egyéb' menüpontból a 
'Projekciót', a projekciós leírások közül pedig a "Példányok kötetei" 
nevűt. Az eredmány halmazt mentsük el az 'Elment' gombbal.

Az exportot szabályozó konfigurációs állományban egy bejegyzés úgy 
rendelkezik, hogy a találati halmazban lévő rekordokkal együtt 
kikerülnek a hozzá kapcsolódók (kötet, közös, analitika) is. Így a 
találati halmaz készítésekor nem kell teljességre törekedni, nem 
kötelező a kötetek közösét, a közösök kötetét is összevadászni.

Az exporthoz tudni kell majd, hogy ki készítette a halmazt, jegyezzük 
meg annak a dolgozónak a textlibes belépési azonosítóját.

3. Exportálás
Az export program windowsos (w-hmkuld.exe) és linuxos (g-hmkuld.exe) 
változata a z1.fszek.hu/y/MOKKA helyen található. Ugyanitt van a 
mokkaba.cfg nevű konfigurációs állomány is, ennek windowsos és linuxos 
változata azonos. Az export program része a telepítő készletnek is, de a 
MOKKA-ba küldéshez a friss változatot ajánlott használni!

A Windows 98 utáni Windowsokon futó DOS-os TextLib szerverhez 
használható a w-hmkuld.exe, a DOS-os gépen futó DOS-os TextLib 
szerverhez egyelőre nincs program, ha szükséges, készítünk.

Az .exe-t és a mokkaba.cfg-t másoljuk
- Windowsnál
a \Program Files\TextLib Windows Szerver\exe
- Linuxnál
a /usr/share/textlib/exe/
helyre.

Az exporthoz állítsuk le a szervert. A parancs beírásához szükség van a 
parancssorra, ehhez
- Windowsnál
a [Start - Minden program - TextLib Windows Szerver - TextLib Szerver 
Parancssor] úton,
- Linuxnál
a /usr/share/textlib/exe
helyre navigálva jutunk.

A parancs
- Windowsnál
w-hmkuld <Xyz> /cmokkaba.cfg
- Linuxnál
./g-hmkuld.exe <Xyz> /cmokkaba.cfg
<Xyz> helyére a korábban megjegyzett dolgozó, a találati halmaz 
készítője azonosítóját írjuk <> nélkül, vagyis a valóságban a "pityu" 
nevű dolgozó halmazát a
w-hmkuld pityu /cmokkaba.cfg
vagy a
./g-hmkuld.exe pityu /cmokkaba.cfg
parancs fogja exportálni.

Ha <Xyz>-nek már van exportált állománya, akkor a program engedélyt kér 
a felülírásra, ha megadjuk, elindul az export. Ha nincs korábban 
exportált állomány, akkor nincs kérdés sem.

Az export időtartama függ az exportálandó rekordok mennyiségétől, 
percenként kb. 10000 rekord feldolgozására lehet számítani. Az exportált 
rekordok száma a korábban említett kapcsolatok miatt valószínűleg több 
lesz a találati halmaz elemszámánál.

Az export eredménye az <Xyz>.hm nevű állomány. Ezt kell - célszerűen 
átnevezve - elküldeni a MOKKA Egyesülettel egyeztetett helyre.

Szorgalmi feladatként következhet...

4. A rekordok ellenőrzése
Erről csak röviden, mert szorgalmi feladat. A w-hundir.exe vagy a 
g-hundir.exe ugyanarról a helyről indítható, mint ahol a w-hmkuld.exe 
vagy a g-hmkuld.exe futott. Ajánlott paraméterek:
w-hundir <Xyz>.hm /o<Xyz>.txt /stat /hstat
vagy
./g-hundir.exe <Xyz>.hm /o<Xyz>.txt /stat /hstat
Természetesen <Xyz>-re itt is ugyanaz érvényes, mint korábban, vagyis 
"pityu" esetében:
w-hundir pityu.hm /opityu.txt /stat /hstat
illetve
./g-hundir.exe pityu.hm /opityu.txt /stat /hstat

A keletkező állomány (pityu.txt) egy picit olvasmányosabb az eredetinél 
(pityu.hm), és főként a vége érdekes, ahol a /stat és a /hstat hatására 
összesítés látható a mező előfordulásokról és legfőképp az export 
esetleges hibáiról.

5. A rekordok sorsa
A MOKKA Egyesület mintát kér, és ellenőrzi a kapott anyagot. A 
TextLibből exportált Hunmarc rekordok jók, de nem 
megváltoztathatatlanok, ha valamilyen oknál fogva az előbb leírt módon 
exportált rekordok tartalma mégsem felel meg az egyesület céljainak. 
Változtatni lehet a mokkaba.cfg tartalmán és az exportáló programon is, 
várjuk az erről szóló kéréseket.

Üdvözlettel:  Thék György