ICECOPY

Copy an input file using a native code (NextMidas Only)

<IN>    Input file name
<OUT>   Output file name

This primitive will make a copy of an input file. It differs from noop in two
ways. First, this primitive instantiates the native read & write functions 
from the approriate IOResource. Second, this primitive defaults to detaching
the header from the data. 

Examples:
  1. Copy a local file
    nM> icecopy localfile localfilecopy
  
  2. Copy a local file to a specified AUX
    nM> icecopy localfile localfilecopy{aux=11}

  3. Copy a local file with a specified transfer length
    nM> icecopy/tl=4M localfile localfilecopy

  4. Copy a local file and reattach the header and data
    nM> icecopy/attach localfile localfilecopy

  5. Copy a file and show progress
    nM> icecopy/gpw localfile localfilecopy

Switches:
  /ATTACH  - Makes the output file attached instead of the default detached
             output file [DEF=not present]

  /REPLAY=n - Number of times to loop through input file.

  /GPW     - Show Graphical Progress Widget of transfer status (usually used
             when downloading a file from a server) [DEF=not present]

  /TL      - Number of elements (in bytes) to transfer in each process loop
             [DEF=# of elements in 32768 bytes, rounded down]

  /FLAGS=m - Mask of options to apply (ATTACH | NATIVE | NIN | NOUT)
             ATTACH is the same as the /ATTACH switch
             NATIVE uses native IO routines instead of Java where applicable
             NIN no Input file reads for testing
             NOUT no Output file writes for testing

Widgets: NONE

See Also:  NOOP