; How to Use ^Copy^
;.....>...|...|...|...|...|...|...|...|...|...|...|...|...|...|...<.......|
 %                      *** The COPY Command ***                       %

                          Table of Contents

     ^Basics in using COPY^                                Page ^2^

     ^Copying to another file ^(different name)            Page ^3^

     ^Copying from another PPN^                            Page ^4^

     ^Copying to a terminal ^(CRT,printer,modem)           Page ^6^

     ^Copying to and from user memory^                     Page ^7^

     ^Using Wildcards with COPY^                           Page ^8^

     ^Reminders - Don't Forget These!!!^                   Page ^9^

     ^Switches - How to use them^                          Page ^10^


                            Page ^1^ of ^11^
 %                      *** The COPY Command ***                       %

                          ^Basics In Using COPY^

  ^COPY^ is a monitor command and you must be at ^AMOS monitor^ in order to
  use it.  Refer to HELP AMOS if you are unfamiliar with AMOS monitor.

  In using COPY, remember the following format:

              ^COPY New Filespec = Old Filespec /Switches^

  In brief, a ^Filespec^ consists of the following:

                  ^Device:Filename.Extension[PPN]^

  For more help with Filespec, refer to HELP FILES.

  ^Switches^ are options which extend to power of copying.  For a further
  explanation of switches, refer to the end of this help file.


                            Page ^2^ of ^11^
 %                      *** The COPY Command ***                       %

                ^Copying to another file ^(different name)

  To copy one file to another, use the following steps:

  ^1^.  Know the Filespec of the file(s) you wish to copy.

  ^2^.  If you  are  copying  to a new file, use a name that does not
      already exist.

  ^3^.  If you are copying over an existing file, be sure you  really
      want to do so. (The existing file will be history)

  Here is an example:
      Old file name = ^OLDONE.T^; New file name = ^NEWONE.T^
      Type : ^COPY NEWONE.T=OLDONE.T^

  This command will also copy  OLDONE.T  to  NEWONE.T  even if NEWONE.T
  already exists.

                            Page ^3^ of ^11^
 %                      *** The COPY Command ***                       %

                        ^Copying from another PPN^

  In order to copying from another PPN, you must know:

  ^1^.  The PPN you wish to copy from.

  ^2^.  The PPN you wish to copy to.

  ^3^.  The Disk Device each PPN is on (i.e. DSK0: or DSK1: or DDA0:)

  If the ^new file^  you  are creating will have the ^same name^ as the
  ^old file^, you do ^not^ need to specify the name in the New Filespec.

  If  you  are copying ^into the PPN^ you are on,  you  do ^not^ need  to
  specify that PPN in the New Filespec.

  If ^both PPNs^ are on the ^same Disk Device^, then  you  don't  need  to
  specify the Disk Device in either Filespec.

                            Page ^4^ of ^11^
 %                      *** The COPY Command ***                       %

  Here are some examples:

  Same name; into current PPN; same Disk Devices;
  Old File = ^OLDONE.T^; Old PPN = ^5,1^
      Type : ^COPY =OLDONE.T[5,1]^

  Same name; into current PPN; different Disk Devices;
  Old Disk Device = ^DSK1^
      Type : ^COPY =DSK1:OLDONE.T[5,1]^

  Same name; into another PPN; different Disk Devices;
  New PPN = ^5,0^;
      Type : ^COPY [5,0]=DSK1:OLDONE.T[5,1]^

  Different name; into another PPN; different Disk Devices;
  New File = ^NEWONE.T^
      Type : ^COPY NEWONE.T[5,0]=DSK1:OLDONE.T[5,1]^


                            Page ^5^ of ^11^
 %                      *** The COPY Command ***                       %

               ^Copying to a terminal ^(CRT,printer,modem)

  Copying  to  a  terminal  is  very  much like copying to a file.  The
  difference is simply in the name that you give the New Filspec.

  When copying to a terminal, remember the following:

                  ^COPY TRM:Terminal name=Old Filespec^

  Terminal  name  is the name of the terminal  you  wish  to  copy  to.
  Terminal names can be found by typing ^TRMDEF^ at AMOS Monitor.

  If  the  terminal  you  wish to copy to is a printer, the name of the
  printer can be found by typing ^PRINT^ at AMOS Monitor.

  For Example:
      Terminal = ^CITOH^; Old Filespec = ^OLDONE.T^
      Type : ^COPY TRM:CITOH=OLDONE.T^

                            Page ^6^ of ^11^
 %                      *** The COPY Command ***                       %

                     ^Copying to and from user memory^

  Copying to and from memory is similar to copying to a Disk Device.

  When copying to memory, Remember the following:

                  ^COPY MEM:New Filespec=Old Filespec^

  When copying from memory, Remember the following:

                  ^COPY New Filespec=MEM:Old Filespec^

  For Example:
      To Memory; Old Filespec = ^OLDONE.T^; New Filespec = ^NEWONE.T^
      Type : ^COPY MEM:NEWONE.T=OLDONE.T^

      From Memory; Old Filespec = ^OLDONE.T^; New Filespec = ^NEWONE.T^
      Type : ^COPY NEWONE.T=MEM:OLDONE.T^

                            Page ^7^ of ^11^
 %                      *** The COPY Command ***                       %

                        ^Using Wildcards with COPY^

  You are allowed to use Wildcards to extend the power of copying. With
  wildcards you can copy more than one file at a time.

  For Example:

      Files with ^AZ^ as first two letters in filename;
      Type : ^COPY =AZ*[5,1]^

      Files with ^AZ^ as first two letter in four-letter filename;
      Type : ^COPY =AZ??[5,1]^

      To files with ^CA^ as first two letters in four-letter in filename;
      Type : ^COPY CA??=AZ??^

  For more help with Wildcards, refer to HELP WILD.


                            Page ^8^ of ^11^
 %                      *** The COPY Command ***                       %

                    ^Reminders - Don't Forget These!!!^

  REMEMBER:

  1.  ^You  may^ copy a file into your current PPN from another PPN
      unless the other PPN is security protected.

  3.  ^You may not^ use COPY  to  create  a file  within  a  PPN
      other than the one you are logged into unless that PPN is
      within  the  same  project as your own.  (The  project is the
      first number in the PPN)

  2.  ^COPY  assumes^  a filename  and  extension  of  ^*.*^.  (For
      example: COPY  [100,1]=[100,5]   copies   all  files  in  PPN
      [100,5] into PPN [100,1])




                            Page ^9^ of ^11^
 %                      *** The COPY Command ***                       %

                       ^Switches - How to use them^

  There are two switches you can use with COPY.

  ^1^.  Use ^/QUERY^ or ^/Q^ to verify each copy that will be made.
      Use ^/NOQUERY^ or ^/NOQ^ to turn off this switch.

  ^2^.  Use ^/DELETE^ or ^/D^ to writing over existing files.
      Use ^/NODELETE^ or ^/NOD^ to prevent writing over existing files.


  These  switches can be used for a single file or all files subject to
  the COPY command.

  The ^default switches^ are   ^/NOQ^   and  ^/D^.   These switches are used
  if you do not specify any switches.

  If you are not familiar with switches, refer to HELP SWITCH.

                            Page ^10^ of ^11^
 %                      *** The COPY Command ***                       %

  For Example:

      Use /Q switch;
      Type  : ^COPY NEWONE.T=OLDONE.T/Q^
      Prompt: ^OLDONE.T to NEWONE.T?^
      Type  : ^Y^ if you wish to execute this copy
   or Type  : ^N^ if you do not wish to execute this copy

      Use /NOD switch;
      Type  : ^COPY NEWONE.T=OLDONE.T/NOD^
      If NEWONE.T exists then this copy will not be executed
      If NEWONE.T does not exist then this copy will be executed

  If you still do not know how to use  COPY,  go  over  this  help file
  again  and  make a list of the terms or phrases that you don't fully
  understand.

                      % May the Force be with You %

                            Page ^11^ of ^11^
END OF COPY HELP FILE