Spooler Utilities Reference Manual

Migration Considerations for Pre-D41 Spooler
Versions
Spooler Utilities Reference Manual—522295-003
H-10
Changes to Spooler Library Procedures and
Structures
All job parameters are retained and the job is rapidly recollected into the new collector
data file.
For the COLLECT subcommand to function on a job, the job must be in the HOLD
state. If the job has a current, active collector, it is deleted from the current collector
after the transfer has completed successfully. If the job does not belong to a collector
that is active (for example, jobs warm-started from an older-version spooler), the job is
not physically deleted from the current data file, but is no longer accessible from that
file after the transfer is successful. If a transfer fails, the job remains on the current
data file and/or collector. Successful transfer of a job is reported by the following
message issued to the Spoolcom user:
JOB nnnn TRANSFERRED TO $process-name SUCCESSFULLY
Messages associated with unsuccessful transfers are as follows:
JOB nnnn TRANSFER TO $process-name FAILED, ERROR nnn
COLLECTOR $process-name OPEN ERROR nnn
Example H-4 shows transferring jobs from a pre-D41 format collector file to a collector
with a D41, D46, or D48 format collector file:
Changes to Spooler Library Procedures and Structures
Some Spooler library procedures (for example, PRINTREAD) have been significantly
changed internally. Callers of these procedures provide a buffer of a specified size for
these procedures to use. The contents of the buffer are accessible to applications, but
should not be accessed and used directly. The format and content of this buffer has
been changed.
Applications that use the procedures to obtain information from the buffer will not be
affected by the internal changes. However, if an application directly accesses the
contents of the buffer, it will probably not function correctly with the D41 spooler library.
Example H-4. Transferring Jobs
)JOB (DATAFILE $SYSTEM.SYSTEM.DATA),HOLD,COLLECT $S
JOB 1 TRANSFERRED SUCCESSFULLY
JOB 2 TRANSFERRED SUCCESSFULLY
JOB 3 TRANSFERRED SUCCESSFULLY
JOB 4 TRANSFERRED SUCCESSFULLY
JOB 5 TRANSFERRED SUCCESSFULLY
Note. You can use the COLLECT subcommand to transfer jobs between collectors that
belong to the same spooler supervisor process
.