CSS Unitec Home Page
      

Spooler Utility

csu(U)

Synopsis   Platforms   Description   Options   Notes   See also

Synopsis

csu [option...]

Platforms

Unix, Windows NT

Description  

The program csu is designed to perform all the normal control functions of the spooler administration in batch mode. These functions include status queries, form change, priority control an more.

Options

-a

Show the number of current active printers on standard output and as exit code (may be useful in shutdown scripts).

-c rep:n Change the number of copies of report rep to n.
-d Show current printer states, standard format.
-D Show current printer states, alternate format.
-E rep Remove report rep from the queue (erase).
-f Show a list of all the available forms.
-g r[:n] Print report r starting at page n (go).
-h rep Hold (nonprinting) report rep.
-H dev:r Stop printout of report r on printer dev and put report on hold.
-i dev Activate (initialize) printer dev (1..999 or device name)
-I Activate (initialize) all printers.
-k dev:r Kill report r currently printing on printer dev. The parameter r has to be specified to prevent a different report to be killed.
-K d[:r] Same as option k; the report number r is optional. Note that in a spooler environment things change rapidly. Not specifying the report number may kill another report than expected.
-l rep Show report rep on standard output. Lines exceeding 80 characters are truncated.
-L rep Show report rep without truncation of long lines.
-m dev:f Mount form f on printer dev.
-o dev1:dev2 Route all current and future reports for printer dev1 to printer dev2. Device routing can be cancelled by using the same value for dev1 and dev2, i.e. by routing the printer to itself.
-p f[:m] Show number of lines and line length (in characters) of form f on the standard output. The modifier m serves to reduce the output to the number of lines (m=p) or the line length (m=l).
-q Show current report queue. This is the default option and is mostly used to get the correct report numbers for other csu options.
-Q Show current report queue in an alternate format with program name (lpr p-option) but without TTY number and time information.
-r dev Route report r to printer dev (0..999)
-R dev:f Route all reports with form f to printer dev.
-s dev Hold (stop) printer dev after current printout
-S dev Kill current printout and hold printer dev
-t Show current report queue in a format that includes keep dates.
-T Show all current reports that have their keep date set.
-w f Delete all accessible reports with form f.
-W Delete all accessible reports. Warning: calling csu -W with root permission will remove all pending reports!
-x f Delete all accessible reports with form f. In contrast to the w-option, keep dates are ignored.
-X Delete all accessible reports. In contrast to the W-option, keep dates are ignored. Warning: calling csu -X with root permission will remove all pending reports!
+ rep Put report rep to the front of its form queue (highest priority).

Notes

The default option is -q.

The report number that has to be specified in some of the above options is assigned internally by CSS (in loose order) and may be obtained with a call to csu with the d- or q-option.

Information shown by using options d and D:

D logical device number (1..999)
F current form mounted
Status
**waiting** ready, waiting for work
**on hold** stopped (also 'off-line')
**locked** locked (external lock file)
**starting** starting a printout
**report nn** active / printing report nn
**routed** device routed to the printer specified in the 'Report' column
Report report description (if set in the lpr t-option)
No report number (if printer is active)
Who user-id (or lpr e-option)
TT TTY number (terminal)
Program program name (if set in the lpr p-option)
Date system date (MMYY) of the report creation
Copy number of copies (printed : total)
Page number of pages (printed : total)


Information shown by using option f:

F form name
D logical device number (0 = any printer)
PP page parity (yes/no)
PS number of lines per page (at 6 LPI)
LL number of characters per line (at 10 CPI)


Information shown by using options q and Q:

F form
Report report description (if set in the lpr t-option)
No internal report number (to be used in some options)
 
Status: '  ' unprinted
'P' printing on device D
'H' on hold / stopped
'K' printed / keeping (lpr -k date)
D logical device number (0 = any printer)
Who user-id (or lpr e-option)
TT TTY number (terminal)
Program program name (if set in the lpr p-option)
Date system date (MMYY) of the report creation
Time report creation time (HH:MM)
Cpys number of copies
Page number of pages


Information shown by using options t and T:

F form
Report report description (if set in the lpr t-option)
No internal report number (to be used in some options)
 
Status: '  ' unprinted
'P' printing on device D
'H' on hold / stopped
'K' printed / keeping (lpr -k date)
D logical device number (0 = any printer)
Who user-id (or lpr e-option)
TT TTY number (terminal)
keepdate report keep date (if set with the lpr k or K-option)
Date system date (MMYY) of the report creation
Cpys number of copies
Page number of pages

See also

csa, css, lpdrestart, lpr

 

Back to top