mcp

NAME
  mcp - Allows you to propagate a copy of a file to multiple nodes on an 
  IBM POWERparallel system.

SYNOPSIS

  mcp infile [outfile] [POE options]

  In the command synopsis above, the infile is the name of the file to 
  be copied to.  If you do not provide the outfile name, the file will 
  be placed in its current directory on each node. The outfile can be 
  either an explicit output file name or a directory name.  When a 
  directory is specified, the file is copied with the same name to 
  that directory.

DESCRIPTION

  The mcp command allows you to propagate a copy of a file to multiple 
  nodes on an IBM RISC System/6000 Scalable POWERparallel (SP) System.  
  The file must initially reside (or be NFS-mounted) on at least one node.
  mcp is a POE program and, therefore, all POE options are available.  
  You can set POE options with either command line flags or environment 
  variables. The number of nodes to copy the file to (-procs), and the 
  message passing protocol used to copy the file (-euilib) are the POE 
  options of most interest. The input file must be readable from the 
  node assigned to task 0.

  Note:

  A POE job loads faster if a copy of the job resides on each node. For 
  this reason, it is suggested that you use mcp to copy your executable 
  to a file system such as /tmp, which resides on each node.  

  Return codes are:

  -1	incorrect usage
  -2	error opening input file
  -3	error opening to file on originating node
  -4	error writing data to to file on originating node
  -5	no room on remote node's file system
  -6	error opening file on remote node
  -7	error writing data on remote node
  -8	error renaming temp file to file name
  -9	input file is empty

EXAMPLES

  1. To copy a file from your current directory to the current directory 
     on all nodes of a 16-processor system, using the High-Performance 
     Switch, enter:

     mcp filename -procs 16 -euilib us

  2. To copy a filename from your current directory to the /tmp directory 
     on all nodes of a 16-processor system, using IP, enter:

     mcp filename /tmp -procs 16 -euilib ip

  3. To copy a file from your current directory to a different filename 
     on all nodes of a 16-processor system, enter:

     mcp filename /tmp/newfilename -procs 16

RELATED INFORMATION

  Commands:  mprcp(1), rcp(1)