FCATNL.TXT : Beschrijving file en archief catalogus programma's release 11A, 14 februari 2000 J.R. Ferguson, Amsterdam e-mail: j.r.ferguson @ iname.com web : http://hello.to/ferguson (download de laatste versie hier vandaan) INHOUD ------ 0. VERANTWOORDING 1. FILE OVERZICHT 2. INSTALLATIE 3. WAT IS EEN FILE CATALOGUS ? 4. WAT IS EEN ARCHIEF CATALOGUS ? 5. INTERACTIEF WERKEN 6. WERKEN IN BATCH MET FILE CATALOGI 6.1 Vullen/bijwerken file catalogus 6.2 Raadplegen file catalogus 6.3 Samenvoegen van twee of meer file catalogi 7. WERKEN IN BATCH MET ARCHIEF CATALOGI 7.1 Vullen/bijwerken archief catalogus 7.2 Raadplegen archief catalogus 7.3 Samenvoegen van twee of meer archief catalogi 8. HULPPROGRAMMA'S 8.1 ACAUX.COM 8.2 CHKCMD.EXE 8.3 LBRLST.COM 9. HISTORIE 0. VERANTWOORDING ----------------- De hier beschreven software (zie 'FILE OVERZICHT') mag zonder kosten worden gekopieerd en gebruikt, mits dit gebeurt zonder winstoogmerk. Het werkt bij mij en ik heb er zelf veel plezier aan, daarom geef ik het vrij voor algemeen gebruik. Ik geef echter geen enkele garantie dat deze software voldoet aan uw verwachtingen en stel mij niet aansprakelijk voor enige schade die door het gebruik ervan mocht ontstaan. Ik houd me aanbevolen voor uw opmerkingen en kommentaar (zie bovenstaand e-mail adres), maar kan geen ondersteuning beloven indien u problemen ondervindt. De verschillende programma's hebben een eigen versienummer (x.x). Het totale pakket heeft een releasenummer en wordt vrijgegeven als FCATnn.ZIP waarbij nn het releasenummer is (dus FCAT01.ZIP, FCAT02.ZIP, enz). U wordt dringend verzocht bij kopieren het pakket onder dezelfde naam bijelkaar te houden. Natuurlijk mag .ZIP ook .ARJ of iets anders worden en kunnen er Sysop notes worden toegevoegd. Zie 'HISTORIE' voor een overzicht van eerdere releases. 1. FILE OVERZICHT ----------------- ACAF BAT Alle catalogi doorzoeken, eerst archief catalogi ACAFIND EXE Een archief catalogus doorzoeken ACAMERGE EXE Samenvoegen van twee of meer archief catalogi ACAU BAT Bijwerken archief catalogus ACAUB BAT Voorbeeld: Bijwerken archief catalogus C:\BACKUP.ACA ACAUM BAT Voorbeeld: Bijwerken archief catalogus C:\MASTER.ACA ACAUPD EXE (wordt gebruikt door ACAU.BAT) ACAUPD DAT Beschrijving archief listing formaten voor ACAUPD.EXE ACAUPD TXT Engelstalige beschrijving van ACAUPD.EXE en ACAUPD.DAT ACAUPDB BAT (wordt gebruikt door ACAU.BAT) ACAUPDB2 BAT (wordt gebruikt door ACAU.BAT) ACAUX COM (wordt gebruikt door CATVIEWV.EXE) CATF BAT Alle catalogi doorzoeken, eerst file catalogi CATFIND EXE Een file catalogus doorzoeken CATMERGE EXE Twee of meer file catalogi samenvoegen CATUB BAT Voorbeeld: Bijwerken backup file catalogus C:\BACKUP.CAT CATUM BAT Voorbeeld: Bijwerken master file catalogus C:\MASTER.CAT CATUPD EXE Bijwerken van een file catalogus CATVIEW BAT Batchfile om CATVIEWV.EXE op te starten via RTMRES.EXE CATVIEWD EXE Alternatief voor CATVIEWV.EXE, DOS real mode CATVIEWV EXE Raadplegen/bijwerken file en archief catalogi CHKCMD EXE (wordt gebruikt door ACAU.BAT) DPMI16BI OVL (wordt gebruikt door CATVIEWV.EXE) FCATENG TXT Algemene beschrijving, Engels FCATNL TXT Algemene beschrijving, Nederlands LBRLST COM (wordt gebruikt door ACAU.BAT) RTMRES EXE (wordt gebruikt door CATVIEW.BAT) RTM EXE (wordt gebruikt door CATVIEWV.EXE) 2. INSTALLATIE -------------- Kopieer alle files, met uitzondering van FCAT.TXT en ACAUPD.TXT, naar een directory die in het DOS PATH is opgenomen. Desgewenst kan men de .BAT files in een aparte directory zetten, mits die ook in het DOS PATH is opgenomen. Wanneer men een archief catalogus wil bijhouden moeten de archiverings- programma's als ARJ en PKUNZIP waarmee een listing verkregen kan worden van de inhoud van de betreffende archive files eveneens in het DOS PATH te vinden zijn. Zo nodig zal men de file ACAUPD.DAT met een editor moeten aanpassen. Deze file beschrijft listing formaten van de te gebruiken archiverings- programma's. Meer uitleg hierover vindt men in de file ACAUPD.TXT. Van de files CATVIEWD.EXE (DOS real mode) en CATVIEWV.EXE (DOS protected mode) heeft men er maar een nodig. Meer hierover staat te lezen in het hoofdstuk 'INTERACTIEF WERKEN'. 3. WAT IS EEN FILE CATALOGUS ? ------------------------------ Een file catalogus is een bestand waarin bestandsgegevens worden opgeslagen, met informatie over grootte, datum en tijd. De bestandsgegevens worden gegroepeerd naar disknaam (volume label) en daarbinnen naar directory pad. Bij de disknaam wordt nog opgeslagen hoeveel kilobyte deze totaal kan bevatten, en hoeveel kilobyte er nog vrij is. Om een file catalogus op te zetten moeten men de hard disk(s) en diskettes die in die catalogus opgenomen moeten worden een unieke naam (volume label) geven. Het beste kan men hierbij een systeem aanhouden waarin een volgnummer is verwerkt. Zelf gebruik ik disknamen van het formaat xxxxxxxxAnn, met xxxxxxxx Betekenisvolle naam van 8 karakters, zonodig aangevuld met '-' tekens (spaties zou ook mogen). A Letter die het soort schijf aangeeft (bijv. D=data, S=source, W=werk). nn Volgnummer, waabij cijfers en letters gebuikt mogen worden. Men kan ook een andere systematiek volgen. Essentieel is echter dat de disknamen uniek zijn, dat wil zeggen dat men niet twee of meer keer dezelfde naam gebruikt. Een file catalogus kan interaktief worden onderhouden of geraadpleegd via een menugestuurd programma. Maar ook kan men met DOS commando's werken, die desgewenst vanuit een .BAT file worden aangeroepen. Beide methoden, die verderop worden besproken, mogen ook doorelkaar gebruikt worden. 4. WAT IS EEN ARCHIEF CATALOGUS ? --------------------------------- Een archief catalogus is een bestand waarin gegevens worden opgeslagen over de inhoud van archiefbestanden waarin een of meer files gecomprimeerd zijn samengevoegd. Voor het bijwerken van een archief catalogus worden de betreffende 'archivers' als ARJ en PKZIP (of PKUNZIP) gebruikt om informatie over de inhoud van een archiefbestand te verkrijgen. De volgende archief formaten worden momenteel ondersteund: type programma ---- --------- ARC PKARC v3.5 en PKPAK v3.61 ARJ ARJ v2.21 en v2.41 LBR PCLU (of LU) van T. Jennings (15 Jan 84) LZH LHA v2.1 PAK PAK v2.51 RAR RAR v1.55 en 2.00 ZIP PKZIP v2.04g en 2.50 Mocht men behoefte hebben aan andere archief formaten dan dient men de files ACAU.BAT en/of ACAUPD.DAT met een tekst editor aan te passen. Het formaat van ACAUPD.DAT wordt beschreven in een aparte file met de naam ACAUPD.TXT. Wanneer men andere dan de genoemde programmaversies gebruikt (nu of in de toekomst), kan men de file ACAUPD.DAT eveneens aanpassen om het nieuwe listingformaat te beschrijven. In veel gevallen zal dit trouwens niet eens nodig zijn. De hier gekozen methode is dus zeer flexibel en houdt er rekening mee dat u in de toekomst andere archiveringsprogramma's kunt gaan gebruiken. Er zijn echter twee belangrijke beperkingen: - De namen van de archief bestanden moeten uniek zijn in een archief catalogus. Als men dus bijvoorbeeld twee files PASLIB.ARJ heeft kan er maar een van in de archief catalogus worden opgenomen, ook al staan ze op verschillende disks en/of directories. Wel is het mogelijk met verschillende archief catalogi te werken. - Het opnemen van subdirectories binnen een archief wordt niet ondersteund. Dus geen boomstructuren in de .ARJ, .ZIP, etc. files. 5. INTERACTIEF WERKEN --------------------- CATVIEWV.EXE en CATVIEWD.EXE zijn menugestuurde programma's waarmee zowel file catalogi als archief catalogi kunnen worden geraadpleegd en onderhouden. Hoewel er geen uitgebreide Help teksten zijn ingebouwd denk ik dat het gebruik zichzelf wel wijst. CATVIEWV.EXE is gecompileerd als een Protected Mode programma en maakt gebruik van extended of expanded memory als dat beschikbaar is. Het kan echter alleen op een computer met tenmiste een Intel 80286 of compatible CPU worden uitgevoerd. Het programma maakt gebruik van de Borland DPMI (Dos Protected Mode Interface) server (RTM.EXE en DPMI16BI.OVL). Mocht het rechtstreeks opstarten van CATVIEWV.EXE leiden tot een DPMI foutmelding, dan duidt dit meestal op een conflict met een reeds actieve geheugenmanager. Doorgaans wordt dit verholpen door het commando CATVIEW in plaats van CATVIEWV te gebruiken. Hierdoor start men CATVIEW.BAT op, die zorgt dat CATVIEWV.EXE wordt geladen via Borland's RTMRES.EXE. CATVIEWD.EXE is functioneel identiek aan CATVIEWV.EXE, maar is gecompileerd als een gewoon DOS programma dat geen gebruik maakt van Protected Mode. Hierdoor kan het ook werken op een computer met een Intel 8086, 8088 of 80186 CPU. Dit programma kan echter geen gebruik maken van extended of expanded memory. Welk van de genoemde programma's moet u nu gebruiken? - Gebruik CATVIEWD.EXE als uw computer geen Intel 80286 of compatible processor heeft. De files CATVIEWV.EXE, CATVIEW.BAT, RTM.EXE, DPMI16BI.OVL en RTMRES.EXE heeft u dan niet nodig. U kunt dan echter geheugenproblemen krijgen als met een aantal (zeer grote) catalogi tegelijk wordt gewerkt. Men kan zelf zien of het geheugen vol dreigt te raken door uit het 'Help' menu de optie 'Memory usage' te kiezen. - Gebruik CATVIEWV.EXE als u beschikt over extended of expanded memory. Dit programma maakt hier namelijk gebruik van, zodat veel grotere catalogi verwerkt kunnen worden. Voorwaarde is wel dat u een Intel 80286, 80386 of nog hoger heeft, of een processor van een ander merk die daarmee compatible is. U heeft de files CATVIEWD.EXE, CATVIEW.BAT en RTMRES.EXE dan niet nodig. - Gebruik CATVIEW.BAT als u aan de voorwaarden voor het gebruik van CATVIEWV.EXE voldoet, maar een foutmelding krijgt bij het opstarten ervan. Alledrie de versies kunnen ook vanuit MS-Windows worden opgestart. De eerste keer dat men het programma opstart verschijnt alleen een menu en een statusbalk. Met de keuzen 'File Catalog' of 'Archive Catalog' uit het 'File' menu kan men een of meer catalogi openen. Dit kunnen zowel bestaande als nieuw aan te maken catalogi zijn. Bij het verlaten van het programma worden de namen van de geopende catalogi samen men nog enige andere instellingen opgeslagen in een "setting file" met de naam CATVIEWV.CVS respectievelijk CATVIEWD.CVS (CVS is een afkorting van CatView Settings). De volgende keer dat CATVIEWV.EXE of CATVIEWD.EXE wordt opgestart worden de catalogi automatisch opnieuw geopend. De setting file CATVIEWV.CVS of CATVIEWD.CVS wordt opgeslagen in de directory waarin het bijbehorende .EXE programma staat, of in een directory die aangegeven is in de DOS environment variabele SETTING. Wil men de setting file in een zelf gekozen directory laten opslaan, dan kan men een regel die er als volgt uitziet opnemen in de file AUTOEXEC.BAT: 'SET SETTING=dirpath'. Bij 'dirpath' vult men de gewenste directory in (bijvoorbeeld 'SET SETTING=C:\SETTING'). Desgewenst kan men met verschillende setting files (CVS files) werken door gebruik te maken van de menukeuze 'Options|Save As' en 'Options|Restore from'. Bij het opstarten van het programma kan men aangeven welke setting file gebruikt moet worden door de commando-parameter '/Ssettingfile' of '/settingfile' op te geven. Voorbeelden: CATVIEW /SBACKUPS.CVS CATVIEW /BACKUPS.CVS CATVIEW /MASTER.CVS Bij het openen van een catalogus wordt niet de gehele inhoud in het geheugen geladen, maar alleen de lijst die men te zien krijgt. Wanneer men details raadpleegt of de catalogus bijwerkt wordt het catalogus bestand steeds opnieuw geopend en weer gesloten. Het is dus ook niet nodig om tussendoor te 'saven'. Wel moet het bestand bereikbaar blijven voor het programma. 6. WERKEN IN BATCH MET FILE CATALOGI ------------------------------------ 6.1 Vullen/bijwerken file catalogus Gebruik het commando CATUPD en/of batch files zoals CATUB.BAT en CATUM.BAT om de catalogus te vullen, en later om de inhoud van de catalogus bij te werken als een directory gewijzigd is. Zelf doe ik dat direkt na het maken van een backup van een subdirectory op mijn hard disk. De syntax van het commando CATUPD is: CATUPD [dirpad [...]] [optie [...]] Opties: /D Delete: verwijder opgegeven directories uit catalogus /E Empty : verwijder lege directories uit catalogus /F[catfile] Gebruik aangegeven file catalogus /S Verwerk ook subdirectories Default: dirpad Huidige directory catfile C:\MASTER.CAT Voorbeelden: CATUPD Werk C:\MASTER.CAT bij met gegevens uit de huidige directory CATUPD /E Als boven, maar verwijder evt. lege directory uit de catalogus CATUPD /D Verwijder huidige directory uit catalogus C:\MASTER.CAT CATUPD /D /S Als boven, verwijder tevens alle subdirectories uit de catalogus CATUPD A: Werk C:\MASTER.CAT bij met de gegevens van de huidige directory van A: CATUPD A:\ /S Werk C:\MASTER.CAT bij met de gegevens van alle directories van A: CATUPD A:\ /S /E Als boven, maar verwijder lege subdirectories CATUPD C:\DOS /Ftest.cat Werk TEST.CAT bij met de gegevens van de C:\DOS directory Het commando 'CATUPD /?' geeft een korte Engelstalige uitleg over het gebruik. De batchfiles CATUB.BAT en CATUM.BAT dienen als voorbeeld om aan te geven hoe men gemakkelijk verschillende file catalogi kan bijhouden. Met CATUB.BAT wordt de catalogus C:\BACKUP.CAT bijgewerkt, met CATUM.BAT wordt de catalogus C:\MASTER.CAT bijgewerkt. Voorbeelden: CATUB A:\ Werk C:\BACKUP.CAT bij met gegevens van de A:\ directory CATUM C:\DOS Werk C:\MASTER.CAT bij met gegevens van de C:\DOS directory 6.2 Raadplegen file catalogus Gebruik CATFIND.EXE of CATF.BAT vanaf de DOS prompt. De syntax van het commando CATFIND is: CATFIND filespec [/Fcatfile] [>outfile] Optie : /Fcatfile : Zoek in de file catalogus default catfile = C:\MASTER.CAT Voorbeelden: CATFIND AUTOEXEC.BAT CATFIND CAT*.* Het commando 'CATFIND /?' geeft een korte uitleg over het gebruik. 6.3 Samenvoegen van twee of meer file catalogi Met CATMERGE.EXE kan men twee of meer file catalogi samenvoegen tot een enkele file catalogus. Geef het commando 'CATMERGE /?' voor een korte uitleg. 7. WERKEN IN BATCH MET ARCHIEF CATALOGI --------------------------------------- 7.1 Vullen/bijwerken archief catalogus Gebruik de batch file ACAU.BAT en/of batch files zoals ACAUB.BAT en ACAUM.BAT om de catalogus te vullen, en later om de inhoud ervan bij te werken. De syntax van het commando ACAU is: ACAU filespec [typ [acafile]] filespec = archive file(s) waarvan de members moeten worden gecata- logiseerd. Wildcards * en ? zijn toegestaan typ = archive file type: ARC,ARJ,LBR,LZH,PAK of ZIP (default ZIP) acafile = archive catalogus file. Default is C:\MASTER.ACA Voorbeelden: ACAU A:FOO.ZIP ZIP ACAU *.ARJ ARJ De batchfiles ACAUB.BAT en ACAUM.BAT dienen als voorbeeld om aan te geven hoe men gemakkelijk verschillende archief catalogi kan bijhouden. Men ACAUB.BAT wordt de catalgus C:\BACKUP.ACA bijgewerkt, met ACAUM.BAT de catalogus C:\MASTER.ACA. Voorbeelden: ACAUM A:FOO.ZIP ZIP is hetzelfde als ACAU A:FOO.ZIP ZIP C:\MASTER.ACA ACAUB A:*.ARJ ARJ is hetzelfde als ACAU A:*.ARJ ARJ C:\BACKUP.ACA De hier genoemde batchfiles maken alle uiteindelijk gebruik van het programma ACAUPD.EXE en de bijbehorende datafile ACAUPD.DAT. Deze worden besproken in een aparte tekstfile met de naam ACAUPD.TXT. 7.2 Raadplegen archief catalogus Gebruik ACAFIND.EXE, ACAF.BAT of CATF.BAT vanaf de DOS prompt. De syntax van het programma ACAFIND is: ACAFIND filemask [archmask] [/Fcatfile] [>outfile] filemask en archmask mogen * en/of ? wildcard karakters bevatten Optie: /Fcatfile Zoek in de archief catalogus 'catfile' Default catfile = C:\MASTER.ACA Voorbeelden: ACAFIND ???LIB.PAS /FC:\BACKUP.ACA ACAFIND *.* BATCH.ARC Het commando 'ACAFIND /?' geeft een korte Engelstalige uitleg over het gebruik. 7.3 Samenvoegen van twee of meer archief catalogi Met ACAMERGE.EXE kan men twee of meer archief catalogi samenvoegen tot een enkele archief catalogus. Geef het commando 'ACAMERGE /?' voor een korte uitleg. 8. HULPPROGRAMMA'S ------------------ 8.1 ACAUX.COM ACAUX.COM wordt gebruikt door CATVIEWV.EXE en CATVIEWD.EXE om de batchfile ACAU.BAT aan te sturen wanneer u een archief catalogus gaat bijwerken (Menu keuze 'Edit', optie 'Add/Update'). Verder zorgt ACAUX.COM voor een 'Press any key to continue...' melding na afloop, zodat u de gelegenheid krijgt eventuele foutmeldingen te lezen. 8.2 LBRLST LBRLST doet niets anders dan PCLU aansturen op een manier waar de batch file ACAU.BAT wat mee kan. Met PCLU benadert men .LBR files, een (ouderwets) library formaat dat bij CP/M veel werd gebruikt. PCLU zelf wordt niet meegeleverd (evenmin als PAK, ARJ, PKZIP, etc.) maar het is mogelijk nog beschikbaar in public domain. 8.3 CHKCMD CHKCMD wordt gebruikt in ACAU.BAT om te controleren of de benodigde commando files aanwezig zijn. Door het commando "CHKCMD /?" in te typen krijgt men een korte uitleg van de werking te zien. 9. HISTORIE ----------- 2000-02-14: FCAT11A FCAT*.TXT - Website adres gewijzigd. 1999-04-15: FCAT11 CATVIEWx.EXE - File dialogen: directories eerst, tijd in 24 uurs formaat. - Directory lijsten: alfabetisch geordend. ACAUPD.DAT - Toegevoegd: PKZIP/UNZIP 2.50 en RAR/UNRAR 2.00 ACAUPD.EXE - Ondersteuning van SkpCol/SkpTxt in ACAUPD.DAT. 1998-07-30: FCAT10 CATVIEWx.EXE - Opnieuw gecompileerd met aangepaste CRT unit om runtime error 200 te voorkomen bij gebruik met snelle CPU's. 1996-11-13: FCAT09 FCATNL.TXT - Vervangt FCAT.TXT. E-mail en www adres toegevoegd. FCATENG.TXT - Nieuw: Engelstalige versie van FCATNL.TXT. ACAUPD.DAT - Correctie LZH formaat. 1996-09-28: FCAT08 ACAUPD.EXE - Ondersteuning optie "/D catfile" naast "/Dcatfile". - Scan ZIP listing verbeterd (soms kolomverschuiving). 1995-12-26: FCAT07 ACAUPD.DAT - Fix: ZIP en LZH formaat werd niet meer herkend. - Ondersteuning ARJ v2.50 ACAUPD.EXE - Stringvergelijking ACAUPD.DAT niet meer hoofdletter- gevoelig. 1995-12-25: FCAT06 ACAUPD.DAT - Ondersteuning RAR v1.55 en UNRAR v1.05 CATVIEWV.EXE - Toevoeging Ins 'button' op de statusbalk. 1995-07-26: FCAT05 CATVIEWV.EXE - Fix: lijst positionering na add/update archive catalog. 1995-07-05: FCAT04 CATVIEWV.EXE - Mogelijkheid te werken met verschillende setting files. - Toevoeging Type veld bij add/update archive catalog dialoog. 1995-01-07: FCAT03 CATVIEWV.EXE - Nieuwe menukeuze: 'File|Change directory' - Add/Update archief catalogus zoekt ACAUX.COM in DOS Path - Bij 'abort' Add/Update en Delete wordt .$$$ file gewist 1995-01-05: FCAT02 ACAUPD.DAT - Correctie Lister bij PKUNZIP - Correctie LenCol=01 bij PKZIP/PKUNZIP v2.04g ACAUPD.EXE - Optie /H toegevoegd - Optie /D: echo verwijderde entries toegevoegd CATVIEWV.EXE - Nieuwe menukeuzen: 'Window|Previous Window' 'Edit|Add/Update' 'Options|Archive files' 'Help|Memory usage' - Bij 'Delete dir': optie 'Delete empty directories only' - 'Abort' mogelijkheid toegevoegd bij lange operaties 1994-12-03: FCAT01 Eerste vrijgave naar Public Domain