Click above to get retro games delivered to your door ever month!

N_PSREWIND( <cPrintServer>, <nPrinter>
            [, [-] <nPage> [, [-] <nCopy> ] ] )


Parameters

<cPrintServer>
Name of the print server.

NetLib will remember the argument to <cPrintServer> specified in the 
last call to one of the N_PS* functions. You can then pass NIL as the 
argument, and NetLib will assume you mean the same print server as 
before. If no print server has yet been specified, NIL will represent 
the first or only print server defined in the system. Thus this 
sequence is permissible:

nPrinter = N_PSPNO('PS1', 'LASER3')
N_PSREWIND( , nPrinter, 5, -1)


<nPrinter>
Printer number. Numbering starts with zero. The first network printer 
is 0.

<nPage>
The page number at which to restart printing. The page number can be 
either absolute or relative. An absolute page number is indicated by a 
positive integer. A negative integer specifies a relative number of 
pages back from the page currently printing.

If the argument is omitted or zero, all pages will be reprinted.

<nCopy>
The copy number at which to restart a multiple copy print job. As with 
the page number, you can specify a particular copy number or a relative 
number of copies back from the currently printing copy. Specify a 
relative copy number by passing a negative integer.

If the argument is omitted or zero, the currently printing copy will be 
reprinted.


Returns

Logical true if successful, false otherwise. Use N_ERROR() to obtain an 
error code if unsuccessful.


Description

Restarts all or part of the job currently printing on the printer 
specified. Reprint a full job by passing just the first two arguments, 
<cPrintServer> and <nPrinter>. Reprint part of a job by specifying a 
page number and, optionally, a copy number at which printing should 
begin.

If <nPage> is less than zero, the job will be rewound a relative number 
of pages-that is, reprinting will start at the current page minus 
<nPage> pages. If <nPage> is zero or omitted, all pages will be 
reprinted. If <nPage> is greater than zero, reprinting will begin at 
that page number. Passing a value for <nPage> that is greater than the 
actual number of pages will have the same result as passing zero-all 
pages will be reprinted.

For a multiple copy job, <nCopy> specifies the copy number at which 
printing should restart. If <nCopy> is less than zero, the job will be 
rewound a relative number of copies-that is, reprinting will start with 
the current copy minus <nCopy> copies. If <nCopy> is zero or omitted, 
the currently printing copy will be rewound. If <nCopy> is greater than 
zero, reprinting will begin with the copy number specified. Passing a 
value for <nCopy> that is greater than the actual number of copies will 
cause all copies to be reprinted.


Examples

N_PSREWIND('PS1', 0)         /* Restart the full job
                                on the first printer
                                 serviced by the only
                                print server */
N_PSREWIND('PS1', 0, 10)     /* Restart at page ten
                                of the current copy */
N_PSREWIND('PS1', 0, -10)    /* Restart ten pages back
                                from the current page
                                of the current copy */
N_PSREWIND('PS1', 0, 0)      /* Restart at beginning
                                of the current copy */
N_PSREWIND('PS1', 0, 0, 1)   // Restart copy number one
N_PSREWIND('PS1', 0, 0, -1)  // Restart one copy back
N_PSREWIND('PS1', 0, 10, 1)  /* Restart copy number one
                                at page ten */
N_PSREWIND('PS1', 0, -10, 1) /* Restart copy number one,
                                ten pages back */
N_PSREWIND('PS1', 0, 10, -1) /* Restart one copy back
                                at page ten */
N_PSREWIND('PS1', 0, -10, -1)/* Restart one copy back,
                                ten pages back */