



                          [33m[3m[1mManual of PD version ATCopy[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[33mChapter I[0m

     [1mInstallation
     1.  What is ATCopy?[0m

     ATcopy  is  the  Amiga-sided  program  to  replace the Commodore Amiga
     Janus-Software-Parcel  commands  'ARead' and 'AWrite'.  This means you
     can  use  the  program  to  copy  files  between the Amiga and the XT-
     AT-board or the Sidecar or vice versa.

     But  ATCopy  is  much  smarter than the commands 'ARead' and 'AWrite'.
     You can use this program from either the CLI or the Workbench.  If you
     prefer  the  intuition  based way, all actions can be done by a simple
     mouseclick.   Furthermore  ATCopy  is  able  to remove, create or show
     files  and  directories  on both sides of the system.  ATCopy supports
     all kind of files.

     [1m2.  The needed hardware[0m

     ATCopy  will  work  with  an Amiga 1000, 2000, 2500 and 3000 under the
     Kickstart-versions  1.3 and 2.0, if an Sidecar (only Amiga 1000) or an
     XT- or an AT-board is installed.

     [1m3.  The needed AmigaDOS- and PC-DOS-Knowledge[0m

     In  this  manual  it is assumed, that you are confided with the normal
     funktions  of  the  Amiga  and  the  PC-part,  as descriped in the re-
     spective Commodore manuals.  If not, please read the manuals again.

     [1m4.  How to install the program[0m

     ATCopy  is divided in several parts.  Surely the file 'ATCopy' and the
     file  'ATCopy.info'  is  part  of  the  parcel.   Futhermore  the file
     'ATCOPY.EXE'  on  the  PC-side  is  needed.   And  the  last  file  is
     'ATCopy.Config'  in  the  currend S:  drawer.  All these files are, in
     the normal Amiga format, on this disk.

     You  can  install these files by simply double-click the install-icon.
     But  of course you must boot your Amiga from your normal PC-boot-disk.
     Otherwise  the  files of the Janus-Software-Parcel won't be found.  If
     you  want  to  install  the  program  manualy,  please  copy the files
     'ATCopy'  and 'ATCopy.info' to the directory, which contains the other
     PC-files.  Normaly this will be SYS:PC.  The file 'ATCopy.Config' must
     reside in the S directory of your boot disk or your harddisk.

     To copy the file 'ATCOPY.EXE', please make sure that :

          Boot your PC-part (Sidecar, XT or AT) as usual.

          Please  make  sure,  that  'PCDisk'  has been started on the
          Amiga.

          Now type the following command on the PC-side.

                    aread DF0:PC/ATCOPY.EXE C: /B

          If you don't have access to an harddisk, replace the 'C:' by
          'A:'.

          Now  check the file 'AUTOEXEC.BAT', if the root directory is
          already mentioned in the 'PATH'.  For example

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

          Please  change this line or copy the file 'ATCOPY.EXE' in an
          directory  mentioned by the 'PATH'-command.  In this example
          the directories 'C:\DOS' and 'C:\SYSTEM\JANUS' will be ok.

     After  done  this the installation is completed and you can forget the
     commands 'ARead' and 'AWrite'.

     The  programauthor  won't  give  any  warranty  of  statements in this
     manual.   No  responsibility  for  any  defekts generated by using the
     manual  nor  the  program  will  be given.  I you find any bugs in the
     manual or in the program, please send me a short report.

     [1m[33mChapter II[0m

     [1m1.  Manual of ATCopy[0m

     You  can  use  ATCopy either from the CLI or by a doubleclick from the
     workbench.   The  program 'PCDisk' on the Amiga-side is not requiered,
     but of coure you can use it.

     The  Amiga  program  ATCopy  will  atempt to start the PC-side program
     'ATCOPY.EXE' by itself.  Therefore it is requiered that :

          The PC-side must already be booted.

          At  this  moment  no other PC-program is running.  This will
          mean  that,  you  will  see the normal prompt like 'A:\>' or
          'C:\>'.   As  you  surely  will  know  the  PC  ist  not  an
          Multitasking  Computer.   Because the Amiga-side ATCopy will
          start  the PC-side by simulating the keyboard, you must also
          terminate the PC-DOS-Version 4.0 shell.

          Furthermore  you  must  make  sure, that the directory which
          will  contain  the  file  'ATCOPY.EXE'  is  included  in the
          'PATH'-list.  (see Chapter I / 4,installation).

     Please  remember,  that  a  filename  on  an  PC is limited to 8 chars
     followed  by  an  optional  single  dot  and an extension of maximal 3
     chars.   Below  you  will see a list of char, which are not allowed in
     PC-filenames.

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

     Capital-  and  nocapital letters in filenames won't differ, but intern
     all  char  will  be converted to capitals.  If you copy files from the
     Amiga to the PC, the filename would change to :

               Amiga-file                             PC-file

               DemoDatei.info        ===>        DEMODATE.INF

               This is a file.       ===>           THISISAF.

     [1mHow to use from workbench[0m

     After  a doubleclick at the  icon you will see a requester showing the
     version  and  the support address. Terminate this requester by a click
     to  the 'OK' gadget. Now you will see a window, which is quite simular
     to an normal CLI-Tool.  But look at the rigth side.  Yes, it will show
     you the PC files and dirs.

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

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

          This will show you the requester again. Terminate with 'OK'.

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

          Show  an  short  online help.  You can change this text (see
          chapter config file).

     [1mFIT (Amiga-rechts + F)[0m

          With  this  function you will get a overview of all selected
          files  and  dirs.   Espaccialy the selected dirs and subdirs
          will be scaned and the wohle selected size is shown.  So you
          are  able  to  determine  if  these  files  will  fit on the
          destination disk or not.

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

          The  ATCopy-window will shrink to an icon.  Continue with an
          doubleclick at this icon.

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

          Terminate ATCopy.

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

     [1mBINARY  LF<->CRLF   ONLY CHARS   CONVERT ALL[0m

     One, and only one, of this gadgets is active. I have changed the names
     of   the  options  from  'ARead'  and  'AWrite'.   But  they  will  be
     compatible.   'BINARY'  is equal to the option '/B'.  Normaly you will
     use  this  option  to copy binary or compressed files.  'LF<->CRLF' is
     equal  to '/NC' (No Conversion).  Here only the differences between LF
     (LineFeed) and CRLF (CarriageReturn/LineFeed) is assimilated.  But not
     the  differences  in  the national charsets.  'ONLY CHARS' is equal to
     the  option  'CR'.   This  is  the counterpart to 'LF<->CRLF' and will
     assimilate the national charset, but not LF to CRLF.  The last but not
     least  gadget 'CONVERT ALL' will do both, convert the national charset
     and  the LF and  CRLF.  This option is equal  to specify no  option in
     the commands 'ARead' or 'Awrite'.

     Normaly with the gadget 'CONVERT ALL' you will copy text-files and
     with the gadget 'BINARY' you will copy .EXE files.

     In the next row, you will see the free bytes in the currend disks
     on both sides.

     [1mDF0:  DF1:  DH0:  A:\ B:\ C:\[0m

     Right  under this row you will see some gadgets showing the devices on
     both  sides.  As  you  surely  know,  on  the PC-side floppydrives are
     labeled  as  'A:' and 'B:', while harddisks or ramdisks are labeled as
     'C:', 'D:' till 'Z:'.  If you click at one of this gadgets the currend
     contens of this disk is shown in the big box.

     [1mDevices[0m

     If you click at this gadget you can switch to the next devices if more
     than 8 devices are installed.

     Attention:   It  is  possible, that this function won't work proberly.
     Sometimes  the  new  text  is  replaced,  but  the  border will remain
     [3mghosted[0m.  One way to fix this problem is to iconify ( right Amiga + I)
     the window and open it again by a doubleclick.

     [1mDrawer:[0m

     The  currend  path is shown in the string-gadget 'Drawer:'.  Of course
     you  can click and change the contens.  If you misspell  the new path,
     you  will  get an requester and the old path is shown again.  Right to
     this gadget you see a litle arrow (<).  This means parent dir.

     In  the  big  box  you  will  see  the  files  and dirs of the current
     directory  on  both sides of the system.  If you click once to an file
     or dir, this will change the color.  Now this file or dir is selected.
     If  you  click  this file or dir again, it will be deselected and show
     the  normal  color  again.   But if  you doubleclick  an dir, it  will
     become the new current directory.  With the prop-gadget you can scroll
     the list up and down.

     [1mAmiga to XT/AT[0m and [1mXT/AT to AMIGA[0m

     These  are  the  most interesting gadgets in the window.  If you click
     one  of these gadgets, all files and dirs, which are selected, will be
     copied  to the other side.  You must secify the destination by typeing
     the path to the 'Drawer:' gadget or by a doubleclick to the directory.
     If  you  want  to  terminate the copy, please hit the ESCAPE key.  The
     program  will  terminate  after  the current file.  If the destination
     disk  won't  be  able to store all files, you will be asked for an new
     formatted disk. On this new disk the last path will be created, before
     the file is transfered again.

     In this new version the protection flags and the date and time is also
     be  copied  to  the  other  side  of  the  system.   The flags will be
     tranfered as long as they are supported on both computers.

     ATTENTION:
     A   selected  directory  will  be  transfered  with  all  subdirs  and
     all files.

     In  this PD version there is a limitation in the filesize.  Only files
     till 6K will be copied.  A [3mreal[0m version is available from :

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

                         Tel.  0511 / 886059


    [1mNewName[0m
    ~~~~~~~

    You  are  able to change the name of the file while transfer it to the
    other  side.   This  function  is  activated by using the !!  right !!
    mouse button at the gadgets "Amiga to XT/AT" or "XT/AT to Amiga".  For
    each file you will be asked by a stringrequester for the new name.  If
    you  leave  the  requester  by the "ENTER-key" or the "OK" gadget, the
    file  will  be copied under this name.  But if you leave the requester
    by the "CANCEL" gadget or the "Window-Close-Gadget", this file wont be
    copied.

    ATTENTION:  Selected drawers will be copied normaly.

     [1mDELETE / RmDir[0m

     If you choose this gadget all selected files and dirs will be deleted.
     If you want to terminate this action, hit the ESCAPE key.

     ATTENTION:
     Even  this function will work with all subdirs of an selected dir.  So
     be careful, because this is normaly not surpported by an PC.

     [1mSELECT ALL[0m

     If you hit this gadget, all files an dirs will be selected.

     [1mDESELECT ALL[0m

     All files and dirs will be deselected.

     [1mMkDir[0m

     Create an new directory.

     [1m1.2 How to use from CLI[0m

     ATCopy  is also useable from the CLI, if all points of workbench start
     are  mentioned.   This will mean the PC is already booted and no other
     PC-program  is  running.  If you type the command 'ATCopy ?', you will
     get this message :

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

     If you type a second question-mark, you will see an additional help :

          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)/...   will  mean,  that  you are allowed to type more than one
     filename.  Even wildcards are allowed.

     Please  notice  the '/K' behind TO and OPT.  These tokens are keywords
     and you must type the keyword to specify the function.

     The  options  are exactly the same as in 'AREAD' and 'AWRITE'.  So 'B'
     means  binary,  'CR' means no convertion of CRLF (CarriageReturn/Line-
     Feed) to LF (LineFeed) and 'NC' means NoConversion of national chars.

     The  two  switches  'A2PC'  (Amiga to PC) and 'PC2A' (PC to Amiga) are
     used to select the copy-direction.

     The  switch 'ALL' means to copy all files and dirs.  Of course in this
     case source and dest must be directories.

     Attention:   If  the  dest  disk  is  full, the program will terminate
     instead  of ask the user to insert the next disk.  This will work only
     from the workbench!

     Now let's look at some examples :

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

     This  command will copy all files and dirs from the disks in DF0:  and
     DF1:   to the harddisk C:.  Even if you specify the 'OPT B' option you
     can't restore all files to the Amiga.  (See Chapter II.1 filenames).

               ATCopy PC2A a:\*.c TO DF0:

     All  files with the extension '.c' from the PC disk A:  will be copied
     to the disk in DF0:.  Normaly these files will contain text, and so no
     option  is specified.  The program ATCopy will work in the same manner
     as  'AREAD'  and 'AWRITE', and use the full convert option if no other
     option is specified.

               ATCopy TO A: OPT NC *.h

     Even this is an valid command.  If you won't specify and direction the
     program  will use a standard.  You are able to change this standard in
     the  file  'S:ATCopy.Config' (see Chapter III).  The default direction
     is  A2PC.   So this command will copy all '*.h' files from the currend
     Amiga directory to the PC drive A:.

     If  you  type  only  'ATCopy'  without  any parameter you will get the
     workbench look.  Please see this chapter how to use the program.

     [1m[33mChapter III[0m

     [1mMore informations
     The Config-File[0m

     Without the file 'ATCopy.Config', in the Amiga S:-drawer, this program
     won't work.  This is a normal textfile and you are able to change some
     defaults  of  ATCopy.   Please  be sure to backup the file, before you
     change it.

     You  can use any ASCII-Editor to change 'ATCopy.Config'.  But you must
     notice  not  to  change the lenght of the rows.  On this disk you will
     find  a  file called 'Muster.Config'.  This file shows you the maximal
     lenght  of each row.  Espacialy the three rows containing the a's must
     have this lenght!  Perhaps they must be filled with spaces.

     The  most  importend  rows are  the rows  behind the label 'OPTIONS:'.
     These rows must contain exactly one character per row!

     The  first row after 'OPTIONS:' should contain an 1 or an 0.  A 1 will
     set  the default direction to Amiga --> XT/AT and any other value will
     switch to XT/AT --> Amiga.  This value is only valid from the CLI.

     The second row should contain an B, C, N or an space.  This value will
     set the default option. A 'B' means    binary,  'C'  means  'CR',  'N'
     means 'NC' and an space will mean no option.

     The   third   row  should  contain  an  1  or  an  0  either.  If this
     value  is  equal  to  1,  ATCopy  will switch to the US-keyboard first
     before simulating the PC-keyboard and type 'ATCOPY.EXE'.  This is done
     by  [1mCTRL-ALT-F1[0m  and  [1mCTRL-ALT-F2[0m.  It is recommend, that you use this
     feature  if  you  have  loaded a keyboard-driver. If you don't want to
     switch to the US-kkeyboard, set this value to 0.

     Normaly this value should be '1'.

     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.

     Please send bugreports or improvements to :

                              Peter Vorwerk
                              Pflugweg 27
                              W-8510 Frth
                              GERMANY
