ICECOPY

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

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/gsw localfile localfilecopy

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

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

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

Widgets: NONE

See Also:  NOOP