RESUMESPOOL

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


RESUMESPOOL


     Resumes suspended spooler output to a spooled device.

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)

Back to Main Index