



                          [33m[3m[1mATCopy Handleiding[0m

     The  program  ATCopyPD is a demo of the comercial version ATCopy3.2.5.
     This  PD version is freely distributable if the manual is also copied.
     Registered  users  of  version 2.xy should order the comercial version
     direct  from  the author.  This is the only way to among the SHAREWARE
     to the cost of DM 49,95.  Plese send your order to :

                              T  r  i     C  o  m
                              Andreas      Kster
                              Geibelstrae     14
                              3000    Hannover  1
                              G  E  R  M  A  N  Y

                              Tel.  0511 / 886059

     or direct to the author :

                              Peter       Vorwerk
                              Pflugweg         27
                              W-8510        Frth
                              G  E  R  M  A  N  Y





     [1m[33mHoofdstuk I[0m

     [1mInstallatie
     1.  Wat is ATCopy?[0m
  
     ATcopy is een programma  dat op de  Amiga-zijde loopt en dat de Janus
     commando's  'ARead' en 'AWrite'  vervangt.  Dit betekent dat U ATcopy
     kunt gebruiken  om files uit te wisselen tussen een XT/AT-bridgeboard
     of een Sidecar en de Amiga en dit in de twee richtingen.   

     Maar ATCopy is  veel  slimmer dan  de commando's 'ARead' en 'AWrite'.
     Je kan ATCopy  opstarten zowel  vanuit de CLI als vanaf de Workbench.
     Als U de Intuition manier  prefereerd dan kunnen  alle acties met een
     simpele  muisklik  worden uitgevoerd.  Bovendien kan ATCopy bestanden 
     en direcotories tonen, aanmaken  of  verwijderen  en  dit op de beide
     zijden van het systeem.  ATCopy ondersteund alle soorten files.

     [1m2.  De benodigde hardware[0m

     ATCopy  zal  werken  op alle Amiga's 1000, 2000, 2500, 3000 uitgerust
     met  een  Bridgeboard  (2088, 2286)  of  een Sidecar en dit  onder de
     Kickstart versies 1.3 en 2.0 	

     [1m3.  Vereiste AmigaDOS- and PC-DOS kennis[0m

     In  deze handleiding  wordt  verondersteld  dat U  bekent bent met de
     normale functies van zowel het Amiga- als het  PC-gedeelte zoals deze
     beschreven worden in  de  respectievelijke  Commodore  handleidingen. 
     Zoniet, gelieve dan deze handleidingen te raadplegen.
     
     [1m4.  Hoe het programma installeren?[0m

     ATCopy  is  opgedeeld  in  verschillende  delen.   De files 'ATCOPY', 
     'ATCOPY.info' en in de s: directory  het  file  'ATCopy.config'  zijn 
     vereist  aan  de Amiga-zijde.  Daarnaast is nog het file 'ATCOPY.EXE'
     op  de  PC-zijde  vereist.   Al  deze  files bevinden zich in normaal 
     Amiga formaat op deze diskette.

     U  kan  deze  file installeren door dubbel te klikken op het install-
     icoon.   Maar  natuurlijk moet U dan eerst uw Amiga herstarten met uw 
     gebruikelijke PC-boot-disk anders kunnen de Janus-files niet gevonden 
     worden. Als U het programma  manueel wilt installeren, copieer dan de
     files 'ATCopy'en 'ATCopy.info' in de directory die Uw andere PC-files
     bevat.  Normaal  is dit SYS:PC.   Het  bestand 'ATCopy.Config' moet U
     copieren naar de S directory van uw opstartdiskette  of harde schijf.
  
     Als U het file 'ATCOPY.EXE' wil copieren, zorg er dan voor dat:
          
          Uw PC-gedeelte opgestart werd zoals gewoonlijk
         
          Controleer dat 'PCDisk' zeker is opgestard op de Amiga-zijde.
        
          En voer dan het volgende commando in op PC-zijde.
      
                    aread DF0:PC/ATCOPY.EXE C: /B

          Als U niet beschikt over een harde schijf vervang dan 'C:' door
          'A:'. 
        
          Controleer nu in het file 'AUTOEXEC.BAT' dat de root directory
          is aangeven in het 'PATH'.
          Bijvoorbeeld:

                   PATH=[1mC:\;[0mC:\DOS;C:\SYSTEM\JANUS

          Verander deze lijn of copieer 'ATCOPY.EXE' in een directory 
          aangegeven in het 'PATH'-commando. (In dit voorbeeld zijn 
          dit dus de directories 'C:\DOS' en 'C:\SYSTEM\JANUS'.)
     
     Als U deze installatie procedure vervolledigd heeft dan kan U de 
     commando's 'ARead' en 'AWrite' vergeten.  
 
     De programma-auteur geeft geen enkele  garantie  met  betrekking  tot 
     statements in deze  handleiding.   Geen  enkele  verantwoordelijkheid
     voor defekten veroorzaakt  door het gebruik van deze handleiding noch 
     door gebruik van  het programma worden gegeven.  Als U fouten vind in
     zowel  de  handleiding  als  in het programma, stuur dan aub een kort
     berichtje.
   
     [1m[33mHoofdstuk II[0m

     [1m1.  Gebruik van ATCopy[0m

     U  kan ATCopy  opstarten van  zowel de CLI als door dubbel klikken op
     het icon op de Workbench. Het programma 'PCDisk' is op de Amiga-zijde
     niet  meer  vereist, maar U kan het natuurlijk wel blijven gebruiken.
  
     Het Amiga programma ATCopy zal trachten het PC programma 'ATCOPY.EXE'
     op te starten.  Daartoe is vereist dat:
            
          De PC-zijde al opgestart is.
         
	  Dat op dat moment erop de PC-zijde geen programma loopt.  Dit
          betekent dat U een normale prompt kunt zien staan zoals 'A:\>'
          of 'C:\>'.  Zoals  U  zeker  en vast weet is de PC geen multi-
          tasking computer. Omdat het Amiga programma ATCopy de PC-zijde
          'bestuurt' door  het  toetsenbord te simuleren, is het vereist
          dat ook de shell van PC-DOS-Versie 4.0 wordt gestopt.

          Bovendien moet U er zich ook van overtuigen dat het file
          'ATCOPY.EXE' zich in de 'PATH'-list bevindt. 
          (zie hoofdstuk I / 4,installatie)
           
     Let erop dat een file-naam op PC beperkt is tot 8 karakters gevolgd
     door een '.' en dat een extentie maximaal 3 karakters lang mag zijn.	
     Hieronder  ziet  U  een  lijst  van  karakters  dewelke  niet mogen
     voorkomen in PC-filenamen.

             [33m--------------------------------------------
            |                                            |
            |  .  "  \  /  [  ]  :  |  <  >  +  =  ;  ,  |
            |                                            |
             --------------------------------------------[0m

     Er wordt geen onderscheid gemaakt tussen hoofd- en kleine letters in
     bestandsnamen, intern worden deze toch omgezet in hoofdletters.
     Als U een bestand zou copieren van Amiga naar PC dan zouden volgende
     namen bijvoorbeeld veranderen:

               Amiga-file                             PC-file

               DemoDatei.info        ===>        DEMODATE.INF

               This is a file.       ===>           THISISAF.

     [1mHoe werken vanaf de Workbench[0m

     Na dubbelklikken van het icoon zal er een requester verschijnen die 
     zowel de versie als het support adres toont.  Doe deze requester weg
     door op het 'OK' gadget te klikken.  Vervolgens ziet U een venster
     verschijnen dat tamelijk gelijkaardig is aan diverse andere CLI-tools.
     Maar kijk naar de rechtse zijde, en jawel daar staan de PC-bestanden
     en directories. 

     [1m[33mMenus[0m

     [1mABOUT (right-Amiga + A)[0m

          Toont de openingsrequester terug.  Afbreken door op 'OK' te
          klikken.

     [1mHELP (right-Amiga + H)[0m

          Toont een korte online help.

     [1mICONIFY (right-Amiga + I)[0m

          Het ATCopy-venster zal 'krimpen' tot een icoon.  Vervolgen met
          'ATCopy' kan door te dubbel klikken op dit icoon.

     [1mQUIT (right-Amiga + Q)[0m

          Stopt ATCopy.

     [1m[33mGADGETS[0m

     [1mBINAIRE COPY  ENKEL LF-CRLF   GEEN LF-CRLF   ZET ALLES OM[0m

     Een en altijd slechts een van deze gadgets is actief.
     Ik heb de namen van de opties veranderd  zoals deze  bij  'ARead'  en    
     'AWrite'  gebruikt  worden,  maar  de  opties  zijn  wel  compatibel.
     'Binaire copy' is  gelijk aan de  optie  '/B'.   Normaal  zal U  deze 
     optie gebruiken om gecompresseerde  files  of  binaire  bestanden  te 
     copieren.   'Enkel  lf-crlf'  is gelijkwaardig met '/NC', hier worden
     alleen de verschillen  tussen  lf (linefeed) en crlf (carriagereturn/
     linefeed) doorgevoerd  dus  niet de  verschillen tussen verschillende
     nationale  karaktersetten.   'Geen lf-crlf'  is  de  tegenhanger  van 
     'Enkel lf-crlf': de nationale karaktersetten worden wel geconverteerd
     maar niet de lf en crlf.'Zet alles om' converteert zowel de nationale
     karakterset als lf naar crlf. Deze optie is gelijk aan geen optie bij
     de commando's 'ARead' en 'AWrite'.
     
     Normaal zult U het gadget 'Zet alles om ' gebruiken om tekstbestanden
     te copiren en het gadget 'Binaire copy' voor .EXE files te copiren.
    
     Op  de volgende rij ziet U het aantal vrije bytes om de huidige disks
     en dit zowel op de Amiga als op de PC.
   
     [1mDF0:  DF1:  DH0:  A:\ B:\ C:\[0m

     Vlak   onder  deze  rij  ziet   U  verscheidene  gadgets  die  U  de
     verschillende  devices  laten  zien  aan  beide  zijden.     Zoals U
     ongetwijfeld weet,  worden  de PC floppy-drives 'A:' en 'B:' genoemd
     terwijl  de  harde  schijven en  ramdisks 'C:', 'D:' tot en met 'Z:'
     noemen.  Als U op een van deze gadgets  klikt  dan verschijnt in het
     venster daaronder de inhoud van deze disk.
  
     [1mDevices[0m

     Als U op dit gadget  klikt dan kan U springen naar de volgende reeks
     van 8 devices als er meer dan 8 zijn genstalleerd.
   
     Opgelet:  Het  is  mogelijk  dat deze functie niet deugdelijk werkt.
               Soms  wordt  de nieuwe tekst vervangen, het gadget zal wel
               blijven.  Een manier  om dit probleem op te lossen is door
               iconify  te  gebruiken  (rechtse  Amiga-toets + I)  en het 
  	       venster terug te open door dubbel te klikken op het icoon.

     [1mDir.:[0m

     Het huidige pad wordt getoond in het string-gadget 'Dir.:'.  
     Natuurlijk  kan U hierop klikken en de inhoud veranderen.  Als U een 
     nieuwe path  naam  verkeerdelijk intypt dan zal U een requester zien
     verschijnen en het oude paht terugkrijgen.
     Rechts  van  dit gadget  ziet U een kleine pijl (<) deze doelt op de 
     parent.
    
     In  het  grote  venster  ziet  U  de bestanden en directories van de
     huidige directory en dit op de beide  zijden van het systeem.  Als U
     klikt  op  een  file of directory dan zal deze veranderen van kleur,
     dan is zo een  file  of  directory geselekteerd.  Als U terug op dit
     file  of  deze  directory  klikt dan zal deze gedeselekteerd worden.
     Maar  als  U  dubbel  klikt  op een directory dan zal deze de nieuwe 
     huidige directory worden, met de  slider kan U door de bestandslijst
     scrollen.

     [1mAmiga naar PC[0m en [1mPC naar AMIGA[0m

     Dit zijn de meest interessante gadgets in het venster.  Als U op een 
     van  deze  gadgets  klikt dan zullen alle geselekteerde bestanden en
     directories naar de andere zijde gecopieerd worden.
     U moet de bestemming aanduiden door het path in 'Dir.:' in te voeren
     of door op de directory dubbel te klikken.
     Als U een copieeropdracht wilt afbreken druk dan op de ESCAPE toets.
     Het programma  zal  dan stoppen met copiren na het huidige bestand.
     Als het niet mogelijk is om alle files op een bepaalde disk te zetten
     dan zal een  requester verschijnen die U vraagt om een nieuwe, lege,
     geformateerde diskette in de disk-drive te steken.  Op de nieuwe disk
     wordt het laatst gebruikte path gecreerd voordat een volgend bestand
     gecopieerd word.
    
     OPGELET:
     Een geselekteerde directory zal worden gecopieerd met al zijn 
     sub-directories en onderliggende files.
   
     [1mNewName[0m
     ~~~~~~~
     Het is mogelijk om de naam van een bestand te veranderen tijdens het
     copieren.   Deze functie  wordt geactiveerd door op de !! rechtse !!
     muisknop te drukken op de gadgets 'Amiga naar PC'of 'PC naar Amiga'.
     Voor elk bestand zal er een  stringrequester  verschijnen  waarin  U
     de nieuwe bestandsnaam kan invoeren.  Het file zal gecopieerd worden
     onder de naam dat het bestand heeft gekregen  nadat  U de  requester
     verlaten had na op return gedrukt  te  hebben of nadat U op het 'OK' 
     gadget  geklikt  heeft.   U  kan  de  requester verlaten door op het 
     'CANCEL'  gadget  of 'window-close-gadget'  te  klikken (het actieve
     bestand zal niet worden gecopieerd).         

     OPGELET:  Geselecteerde directories zullen normaal gecopieerd worden.
    
     [1mDELETE / RmDir[0m

     Als U dit gadget kiest dan zullen alle  geselekteerde bestanden en 
     directories worden verwijderd.  Als U het verwijderen wilt afbreken
     druk dan op de ESCAPE toets.
    
     OPGELET:
     Omdat deze functie  (door)werkt  tot  alle  sub-directories van een 
     geselekteerde  directory,  dient U  op te letten  omdat een PC deze
     functie normaliter niet ondersteund.

     [1mAlles[0m

     Wanneer U dit gadget aanklikt, zullen alle bestanden en directories
     geselekteerd worden.	
 
     [1mNiets[0m

     Alle bestanden en directories worden gedeselkteerd.	
  
     [1mMkDir[0m

     Maak een nieuwe directory aan.

     [1m1.2 Hoe vanuit de CLI werken?[0m

     ATCopy is ook bruikbaar vanuit  de  CLI, wanneer aan  alle punten is 
     voldaan zoals deze vermeld staan bij het opstarten vanaf de workbench.
     Dan  is  de  PC al  opgestart en dan loopt er geen programma op deze.
     Als  U  het  commando 'ATCopy ?'invoert dan ziet U volgende boodschap
     verschijnen:

                  File(s)/...,TO/K,OPT/K,A2PC/S,PC2A/S,ALL/S:

     Als U een tweede vraagteken invoert dan krijgt U meer uitgebreide hulp:
     
          File(s)/...   means some filenames or wildcards
          TO            directory
          OPT           option ( B,CR or NC )
          A2PC          Amiga to XT/AT
          PC2A          XT/AT to Amiga
          ALL           all files and dirs

     File(s)/...wil zeggen dat er meerdere files van dit bepaalde type
     zijn toegelaten.  Wildcards zijn toegelaten.

     Let  er  op dat de '/K' optie achter TO en OPT.  Dit zijn keywords
     en U moet deze invoeren voor een specifieke functie te verkrijgen.
 
     De  opties  zijn  juist  dezelfde als deze van 'ARead' en 'AWrite'.
     'B' betekent dus binair, 'CR' betekent geen convertie van crlf naar
     lf en 'NC'  betekent  geen conversie  van  nationale  karaktersets.
   
     De  twee switches 'A2PC'  (Amiga naar PC) en 'PC2A' (PC naar Amiga) 
     worden gebruikt om de copieerrichting aan te duiden.

     De switch 'ALL' doelt op het copieren van alle bestanden en 
     directories.  Natuurlijk moeten vertrek en doel (source en dest) 
     directories zijn.
 
     Opgelet:  Als de doeldiskette vol is dan zal het programma afbreken 
     in plaats van de gebruiker om een nieuwe volume te verzoeken.  Deze
     optie werkt wel als men opstart vanaf de workbench.
   
     Laten we enkele voorbeelden van dichterbij bekijken:

               ATCopy DF0: DF1: TO C: OPT B A2PC ALL

     Dit commando copieert alle bestanden en directories van de diskettes
     DF0: en  DF1: naar de harde schijf C:.  Zelfs als U de 'OPT B' optie
     gebruikt  kunt U  niet de identieke files terug verkrijgen op Amiga.
     (zie hoofdstuk II. bestandsnamen)
  
               ATCopy PC2A a:\*.c TO DF0:

     Alle  bestanden  met  de extentie '.c' van  de  PC  schijf A: zullen
     gecopieerd worden naar de diskette  in  DF0:.   Normaal  zullen deze
     bestanden tekst bevatten, en aldus dient er geen optie gespecifieerd
     worden.  'ATCopy' werkt  hier  analoog  ten opzichte van 'AWrite' en
     'ARead'.

                ATCopy TO A: OPT NC *.h

     Zelfs dit is een geldig commando.  Als U geen bestand, nog richting
     aanduidt dan zal het programma de defaults  gebruiken.  U kunt deze
     default aanpassen in het bestand 'S:ATCopy.Config'(zie hoofdstuk III)
     De default richting is A2PC, dus het bovenstaande commando zal alle
     '*.h' bestanden van de huidige Amiga directory copieren naar de PC
     drive A:.

     Indien U alleen 'ATCopy' invoert zonder enige parameter dan zal U de
     workbench versie krijgen.  Gelieve het betreffende hoofdstuk te
     raadplegen voor meer informatie.

     [1m[33mHoofdstuk III[0m

     [1mVerdere informatie
     Het Config-Bestand[0m

     Zonder  het  bestand  'ATCopy.Config'  in de Amiga S: directory zal
     dit  programma niet werken.  Dit is een normaal tekstbestand waarin
     U de defaults  van ATCopy kan  veranderen.   Zorg er voor dat U een
     veiligheidscopie  van  het  bestand  heeft  voordat  U  het bestand
     verandert.

     U kan elke ASCII-editor gebruiken  om  'ATCopy.config'  bestand  te
     veranderen.   Maar U dient wel rekening te houden met de lengte van
     de rijen.   Op  deze  disk  vind U een bestand 'Muster.Config', dit
     bestand  toont  U  de  maximale lengte van elke rij.  Zeker de drie
     rijen die  de  a's  bevatten moeten deze lengte hebben!  Zij kunnen
     eventueel aangevuld worden met spaties.

     De  belangrijkste  rijen  zijn de drie rijen na het label 'OPTIONS'.
     Deze rijen bevatten juist 1 karakter per rij.

     De eerste rij na 'OPTIONS' moet een 1 of een 0 bevatten.  Een 1 zet
     de default richting aan:  Amiga  naar PC, elke andere waarde zal de
     default richting veranderen in PC naar Amiga. Deze waarde is alleen
     geldig bij gebruik vanaf de CLI.

     De tweede rij  zou een B, C, N or een spatie moeten bevatten.   Dit
     karakter duidt op  de default option.  Deze waarde  geldt zowel bij
     gebruikt  vanaf de CLI als vanaf de workbench.  Een  'B' wil binair
     zeggen,  een 'C' wil  'CR' zeggenn 'N' doelt op  'NC' en een spatie
     wil zeggen dat er geen optie is.

     De  derde rij zou een 1 of een 0 moeten bevatten.  Als deze rij gelijk
     is  aan 1 dan zal ATCopy naar het US-toetsenbord overschakelen voordat
     het  PC-toetsenbord  gesimuleerd  wordt op 'ATCOPY.EXE' te typen.  Dit
     gebeurd  door  van  [1mCTRL-ALT-F1  en [1mCTRL-ALT-F2[0m gebruik te maken.  Het
     wordt   aanbevolen   om   deze   optie   te   gebruiken  als  men  een
     toetsenbord-driver  gebruikt.  Als U niet naar het US-toetsenbord wilt
     overschakelen dient U deze waar de op 0 te zetten.

     Normaal zou deze waarde '1' moeten bedragen.

     The  fourth row should contain the PC-filename. Exactly this file will
     be  called  from  the  Amiga-program.

     The  fifth  row  should  contain  a '0' (null) or an '1'.  If a '1' is
     found, the program starts in the iconify mode.

     The  value  in the sixed row determine, if the screen should be opened
     in  interlaced  mode  or not.  A '0' will open it non-interlaced and a
     '1' in interlaced mode.

     The  last  value  determine, if the files will be displayed as soon as
     they  are read in the directory, or if they are delayed until the hole
     dir  is  scaned.  A '0' will set the delayed mode while a '1' will set
     the opposide mode.

     [1mAREXX-Port[0m

     The  port  name  is  "ATCOPY".   All  commands  which are send to this
     address,  will  be  checked  by  this  program.   In  this version the
     following commands are surported:

	     CopyToAmiga         pc_file     [ amiga_file ]
	     CopyToPC            amiga_file  [ pc_file ]

	     ChangeAmigaDir      amiga_dir
	     ChangePCDir         pc_dir

	     GetAmigaDir
	     GetPCDir

	     MakeAmigaDir        amiga_dir
	     MakePCDir           pc_dir

	     DeleteAmigaFile     amiga_file
	     DeletePCFile        pc_file

	     DeleteAmigaDir      amiga_dir
	     DeletePCDir         pc_dir

	     SetOption           option

     The  option  selected  by  "SetOption" will stay until a new option is
     selected.  Even the gadgets will change by this arexx command.

     The  copy commands will differ from the normal CLI-Syntax.  So you are
     not  allowed  to  use  wildcards.  The second file or directory is the
     destination.   If  you ommit this value the currend drawer and the old
     filename are used.

     ChangexxDir,   GetxxDir  and  MakexxDir  will  change  or  create  the
     directory.

     DeletexxFile  will  delete this file and DeletexxDir the directory and
     all subdirs.

     Gelieve fout en verbeteringen te melden aan:

                              Peter Vorwerk
                              Pflugweg 27
                              W-8510 Frth
                              GERMANY
