CONVERT
-------

Format:        CONVERT [d:] [path] [filename]

Purpose:       Converts files between CP/M and VT-DOS  format 
          disks.

Use:           CONVERT is a menu driven program,  and prompts 
          for  various  options  whilst it  is  running.  The 
          command   parameters  specify  a  data  file   that 
          contains  data on various CP/M  formats  supported. 
          The default filename for this is FORMDATA.DAT,  but 
          any  other  filename may be given.  If no drive  or 
          directory is specified,  then the specified file or 
          FORMDATA.DAT  will  be  looked  for  first  in  the 
          current directory on the current drive,  and  then, 
          if  not  found,  in the directory that the  CONVERT 
          command  itself  was loaded from.  If  a  drive  or 
          directory  is  given,  then the specified  file  or 
          FORMDATA.DAT  is  looked  for  only  in  first  the 
          current directory and then the specified directory. 
          The  FORMDATA.DAT file containing the CP/M  formats 
          may be edited and updated with the EDFORM command.

               When CONVERT is running, one drive is used for 
          accessing  the CP/M disk and another for  accessing 
          the VT-DOS disk that it is working with. When it is 
          initially  started up,  the CP/M drive is  prompted 
          for  and the VT-DOS drive and directory default  to 
          the  current ones.  Both may changed from the  main 
          menu.  MAPDISK will continue to function correctly, 
          and  necessary  prompts  to change  disks  will  be 
          given.

               After  prompting for the CP/M drive,  the main 
          menu is displayed.  The screen is divided into four 
          areas.  The top two lines display the current  CP/M 
          drive  and the current VT-DOS drive and  directory. 
          The next few lines display the main menu,  and show 
          the various options that may be selected.  The next 
          three  lines are used for the option prompt and for 
          Abort,  Retry messages etc.  and the bottom area of 
          the screen is a scrolling area used to display  the 
          directory of either of the two disks.

               The menu thus looks like this:

     CP/M drive is A:                CP/M type is TV Computer
     VT-DOS drive is B:\CPM

     1) Copy from CP/M to VT-DOS  2) Copy from VT-DOS to CP/M
     3) Display CP/M directory    4) Display VT-DOS directory
     5) Erase CP/M files          6) Erase VT-DOS files
     7) Change CP/M drive         8) Change VT-DOS pathname
     9) Change CP/M type          0) Exit to system

     Select option:


               It  is  thus possible to copy files in  either 
          direction  and to delete files on either  disk.  If 
          the directory of either disk is displayed,  then it 
          is  displayed in a similar format to the /W  option 
          on the DIR command (which is not dissimilar to  the 
          CP/M format) on the scrolling area at the bottom of 
          the  screen.  This  will  stay  displayed  until  a 
          further directory option is selected,  when it will 
          get scrolled up.

               For  options  1  to  6,  a  filename  will  be 
          prompted for, and defaults to *.*.

               If  option 9 is selected,  then all  available 
          CP/M  types  are displayed in pages of 8 types  per 
          page, and the required one can be selected.

               Note  that this is a  transient  command,  and 
          must be loaded from disk.

Examples:

     CONVERT

               No  parameters  are given,  so the  data  file 
          FORMDATA.DAT   in  the  current  directory  of  the 
          current drive is used as the CP/M format data file. 
          If  it is not found there then it is looked for  in 
          the directory that CONVERT was loaded from.


     CONVERT A:\CONV

               The  file FORMDATA.DAT in the directory  \CONV 
          on drive A: is used as the CP/M format data file.
