PTools::Proc::NWay 0.09

PTools::Proc::NWay allows to run a list of tasks with concurrent processing.

SYNOPSIS

Module Synopsis

Create a small script to use this module. Then run the small script using the '-h' (--help) command line option for usage help. The 'nway' command is just such an implementation. Example:

use PTools::Local; # PerlTools Local module
use PTools::Proc::NWay; # include this class
exit( run PTools::Proc::NWay ); # return status to OS

Command Synopsis

nway [< options >] { -K | -R } filename [ - command [ -arg [...]]]

where < options > include
-c < num > - concurrent sessions (*) default is 8, max is 40
-L < str > - specify logfile prefix default is to use 'CMD_'
-l < dir > - log dir for the output default is /tmp/nway.< PID >
-m < secs > - max seconds for a task default is unlimited time
-p [< num >] - preview of commands (+) default is to run commands
-r - randomize the task list default is original order
-h - display usage help text and ignore other options
-F < char > - IFS char for data file default is a colon (':')
-D [< num >] - enable debugging output default is no debug output

where
{ -K | -R } - specifes whether to keep (-K) or remove (-R) the
temporary output logfiles created for each task

filename - specifies a file of tasks to perform concurrently
use a value of "stdin" to read from STDIN file

[ - command ] - is a command used to run each of the task lines

[ -arg [...]] - is a list of opts/args passed to the < command >

Note: (*) Default and maximum values for '-c < num >' may be calculated for each server based on the number of CPUs. These limits can vary depending on the class of the host machine. However, the actual maximum value used will be the lesser of the following:

A) calculated maximum, B) tasks to run, or C) value for 'num'

Note: (+) The '-p' (--preview) option can be used as '-p < num >' where 'num' is a number equal to 2 or more. When used in this manner, will cause a random (1 .. num) second delay in the preview to simulate tasks running with various ending times. See the Options and Arguments section, below, for notes on using the long form of these options. For example, the following two commands are equivalent.

nway -K -l /tmp/xyzzy -L ECHO_ filename

nway --logdir /tmp/xyzzy --LogPrefix ECHO_ --Keep filename

Requirements:

�· Perl



Product's homepage