SCATTER(6)
SCORE-D COMMANDS
SCATTER(6)
NAME
scatter - Broadcast standard input of scrun

SYNOPSIS
scatter [-node node_number] [-file filename]

DESCRIPTION
scatter must be invoked by the scrun(1) command. It broadcasts standard input of the scrun process to all scatter processes running on a cluster.

The options available for scatter:

-node node_number
scrun standard input is only copied to the node specified by node_number. If this option is not specified then standard input of scrun is broadcast to all scatter processes running on a cluster

-file filename
The broadcasted data is written to the file filename. If filename does not start with "/", then a temporary output file is created under the /var/scored directory, and when a parallel job finishes, this file is automatically deleted. If the -file option is not specified, then the broadcasted data is output to the standard output of each scatter process on the cluster. Note that when scatter is executed with the -file option on an SMP cluster, then only one output file is created on each host.

The scatter command is designed with the view to be used with the SCore-D parallel job management facility (see also scrun(1) man page). scatter copies a file out of a cluster into cluster hosts in a scalable way. Or, users can run normal sequential programs or Unix commands run on a cluster in parallel using the system(6) SCore-D command.

Here are some examples: 

$ scrun -nodes=8 scatter == a.out < my.dat
In this example, the standard input file my.dat is fed as a standard input for all processes of a.out running on a cluster. 
$ scrun -nodes=16x1 scatter -file cluster.dat :: a.out < local.dat
In this case, the local file local.dat is copied to the file cluster.dat in a temporary directory under /var/scored on all 16 hosts, and then the user program a.out is executed on a cluster so that the a.out program can read the broadcasted file.

SEE ALSO
scrun(1), system(6), gather(6)
CREDIT
This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003 PC Cluster Consortium.