BUILD.PRINTERS
Builds despoolers and formqueues for printers that are configured on the host.
Syntax
BUILD.PRINTERS {(options}
BUILD.PRINTERS ?
Options
B List which despoolers and formqueues would be created, and which already exist, if the command were run without the B option. Effectively provides a "browse" command mode.
D Only create despoolers.
O Overwrite existing despoolers and formqueues for configured printers.
Q Only create formqueues.
V List which despoolers and formqueues are created, and which already exist, as well as to which despooler each formqueue is assigned. Effectively provides a "verbose" command mode.
Restrictions
SYSMAN only.
Operation
With no options, despoolers and formqueues are built for each printer configured on the host. Each despooler is configured as a system despooler. Those for any existing printers remain unchanged, so you can run BUILD.PRINTERS again whenever you add new printers.
Space characters in the names of the host printers are replaced by underscores in the despooler and formqueue names.
BUILD.PRINTERS ? displays help about the command.
Note
Despooler and form queue names are limited to 40 characters in length. Printers with names longer than this (for example, those that are made available when logging on to a domain) cannot be set up by using BUILD.PRINTERS. The topic Procedure for Setting Up Printers describes an alternative way of setting up system printers.
Example
The following provides an example of the command in verbose mode:
:BUILD.PRINTERS (V
Despoolers
Created despooler 'Send_To_OneNote_2010'
Created despooler 'Microsoft_XPS_Document_Writer'
Despooler Lexmark_CS510_Series_PS3 already exists!
Created despooler 'Lexmark_C543_XL2'
Created despooler 'Fax'
Created despooler 'Brother_HL-1110_series'
Form Queues
Created formqueue 'Send_To_OneNote_2010' assigned to despooler 'Send_To_OneNote_2010'
Created formqueue 'Microsoft_XPS_Document_Writer' assigned to despooler 'Microsoft_XPS_Document_Writer'
Form queue Lexmark_CS510_Series_PS3 already exists!
Created formqueue 'Lexmark_C543_XL2' assigned to despooler 'Lexmark_C543_XL2'
Created formqueue 'Fax' assigned to despooler 'Fax'
Created formqueue 'Brother_HL-1110_series' assigned to despooler 'Brother_HL-1110_series'