README
1$Id: README 3 2001-05-29 17:54:55Z rcaputo $
2
3--------
4Abstract
5--------
6
7POE::Component::JobQueue manages a finite pool of worker sessions as
8they handle an arbitrarily large number of tasks. It often is used as
9a form of flow control, preventing an arbitrarily large number of
10worker sessions from exhausting some finite resource.
11
12------------
13Requirements
14------------
15
16This module requires POE. This requirement is encoded in Makefile.PL,
17so the CPAN shell should do the right thing. If this is installed
18without the CPAN shell, the person installing it will have to do the
19right thing manually.
20
21------------------
22Basic Installation
23------------------
24
25POE::Component::JobQueue may be installed through the CPAN shell in
26the usual CPAN shell manner. This typically is:
27
28 $ perl -MCPAN -e 'intstall POE::Component::JobQueue'
29
30You can also read this README from the CPAN shell:
31
32 $ perl -MCPAN -e shell
33 cpan> readme POE::Component::JobQueue
34
35And you can install the component from the CPAN prompt as well:
36
37 cpan> install POE::Component::JobQueue
38
39-------------------
40Manual Installation
41-------------------
42
43POE::Component::JobQueue can also be installed manually.
44<ftp://ftp.cpan.org/pub/CPAN/authors/id/R/RC/RCAPUTO/> or a similarly
45named directory at your favorite CPAN mirror should hold the latest
46version.
47
48Downloading and unpacking the distribution are left as exercises for
49the reader. To build and test it:
50
51 perl Makefile.PL
52 make test
53
54The test program, t/01_pools.t, makes an excellent sample program. If
55you would like to see more details about its operation, edit it and
56set the DEBUG constant to any value Perl considers "true".
57
58When you're ready to install the component:
59
60 make install
61
62It should now be ready to use.
63
64Thanks for reading!
65
66-- Rocco Caputo / troc@netrus.net / poe.perl.org / poe.sourceforge.net
67