RESUMESPOOL



RESUMESPOOL

     Resumes suspended spooler output to a spooled device. (CM)

SYNTAX


RESUMESPOOL ldev[;{FORWARD}] [nnn PAGES]
{BACK}

RESUMESPOOL ldev;BEGINNING

PARAMETERS


ldev The logical device number of a spooled device.

BACK Instructs the spooler to back up or nnn
pages and resume printing at that point. (Refer to
"OPERATION".)

FORWARD Instructs the spooler to step forward or
nnn pages and resume printing at that point. (Refer
to "OPERATION".)

BEGINNING Instructs the spooler to resume printing at the
beginning of the file which had been previously
suspended.

nnn The number of files or pages you wish the spooler to
backspace or space forward when printing a RESUME.
(Must be an integer between 1 and 256, inclusive.)

PAGES Informs the spooler process which unit of measure
to use when resuming printing. Refer to
[+/-] in HELP SPOOLER PARMs for a
discussion of what constitutes a page.

OPERATION

     The RESUMESPOOL command is valid only when directed to one or more
     suspended spooler processes.  An error message is displayed otherwise.

     If you specify only the ldev parameter, resumption of printing
     will start where it left off, provided that:

     o  the spooler was suspended with the SUSPENDSPOOL command
        (without the ;FINISH option) or the
        SPOOLER;SUSPEND command without the FINISH
option and with no offset specified.

o SPOOLER ;RELEASE was not entered.

Page count includes the current page in its calculation.
For example, if the spooler was suspended while printing
page 15, the command RESUMESPOOL,BACK 6 PAGES,
resumes the printing on page 9.

Always overestimate the number of pages you need to when using the
BACK parameter, or underestimate the number when using the FORWARD
parameter. This is the only way to ensure getting all the output
you need, since partial pages affect the page count. However, if
you instruct the spooler to go BACK further than the beginning of
the file, MPE/iX will display an error message on the system
console and printing will resume at the beginning of the file.
Similarly, an error message is generated if you instruct the
spooler to advance FORWARD beyond the end of the file. In this
case, the spooler process resumes normal operation but will only
print if there is another file ready to print.

This command may be issued from a session, job, program, or in
BREAK. Pressing [Break] has no effect on this command. It may be
executed only at the console. Unless distributed to users with the
ALLOW or ASSOCIATE commands.

EXAMPLE(S)

     To resume output to logical device number 6 at the beginning
     of the file, enter

     RESUMESPOOL 6;BEGINNING

     To resume output to logical device number 6, and reprint the
     last two pages, enter

     RESUMESPOOL 6;BACK 2 PAGES

     If the spooler did not retain its file when it was suspended, then
     resume output to logical device number 6, and print the highest
     priority spoolfile, enter

     RESUMESPOOL 6

ADDITIONAL INFORMATION

Commands:   SUSPENDSPOOL

Manuals :   Performing System Operation Tasks (32650-90137)