Spooler Plus Utilities Reference Manual

Introduction to the Spooler Plus Subsystem

Spooler Plus Utilities Reference Manual—522294-002

1-5

Collectors

The spooler includes one or more collectors, each of which is a continuously running

copy of the program in $SYSTEM.SYSTEM.CSPOOL. An application can direct output

from an application program to a collector by treating the collector as its OUT file; that

is, an application can open a file to any collector and begin writing its output using the

Guardian file-system WRITE[X] procedure. Applications can also use the spooler

interface procedures to spool their output (described in the Spooler Plus Programmer’s

Guide).

While the spooler is in the COLD or WARM state, you can declare and initialize the

spooler collectors by using the Spoolcom COLLECT command, specifying attributes

such as execution priority and program file name.

Collector Attributes

Table 1-1 lists the default attributes of collectors and the Spoolcom COLLECT

subcommands used to specify them.

Optimizing Collector Performance

The collector file size can be any size allowed by your file system. The file’s buffer size

is used to set the collector’s internal buffer size. The buffer size must be at least 1K

bytes and the unit size must be at least 2K bytes. The unit size must be the same as

or a multiple of the buffer size, or the buffer size must be the same as or a multiple of

the unit size. The recommended configuration is a buffer size of 4K bytes and a unit

size of 4K bytes.

The collector allows the usage of all available file space. It uses an index block to

account for the space used within a job. Each index contains 220 entries and multiple

chained index blocks are used when needed. Concurrent users are allocated space at

different points in the collection file. This tends to cause allocation within a job to occur

in continuous groups of units. Because each index entry can represent from 1 to 512

contiguous units, each index block theoretically could represent up to 112,640 units.

Table 1-1. Collector Attributes

Collector Attribute

Spoolcom COLLECT

Subcommand Default Value

Program file FILE $SYSTEM.SYSTEM.CSPOOL

Primary processor CPU Processor of supervisor

Backup processor BACKUP No backup processor

Execution priority PRI 145

Data file DATA None

Unit size UNIT 4

Page size PAGESIZE 60