NAME

     wye - cause an input stream to be split into several pipes

SYNOPSIS

     wye scriptname

DESCRIPTION

     wye acts as a multiple pipe. Each argument  on  the  command
     line,  scriptname  is  the  name of an executable command or
     script. The program works by opening a pipe to each  execut-
     able  and then copies each input stream to the input of each
     process started.  The I/O is buffered (a big advntage on the
     cray2)

EXAMPLE

     Consider the following command line:

                    davc -Nrec122 | wye sc1 sc2 sc3

     where sc1, sc2, and sc3 are themselves shell scripts:

               sc1:
                    editt -ns1 | davc -Ojunk1 -s15
               sc2:
                    editt -ns2 | davc -Ojunk2 -s30
               sc3:
                    editt -ns3 | davc -Ojunk3 -s99


     Running the above command line will cause the first davc  to
     operate  on  the input data set rec122 sending the output to
     stdout.  wye takes this stream and spits it into three send-
     ing  it  in buffered chunks respectively to the three script
     files (each of which runs an editt step with its input  from
     stdin  followed  by a davc which in turn creates a disk file
     output).

     Note:  in place of the names of script files  one  can  also
     use  command  lines  enclosed  by  either  single  or double
     quotes.

BUGS

     Only a maximum of ten commands can be on the  command  line.
     wye will exit if this is exceeded.

     Each process starting must take care of its own output, oth-
     erwise  it all gets mixed up and is assumed to be the output
     of wye which should have no output.

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.