Troubleshooting

Configuration Utility

This topic contains solutions to common problems that you might experience with the Configuration Utility.

See also:


Configuration Utility takes a long time to open

Cause: If Barr Enterprise Print Server is installed on a domain user account, the software will attempt to authenticate to a domain controller when opening the Spool Window and Configuration Utility. If the domain controller is experiencing problems, slow downs, or is unavailable, it will take a long time to open both the Spool Window and the Configuration Utility.

Solution: Verify that the domain controller is active and responding. Contact you Systems Administrator for assistance.

Unable to delete files from the Spool and Retain folders

Cause: An administrator has not given you the right to delete files.

Solution: Have an administrator assign you rights to delete documents.

Unable to change the sort order in the Spool Window

Cause: An administrator has not given you the right to change the sort order.

Solution: Have an administrator assign you rights to sort columns in the Spool Window.

Unable to change fields (for example, Form, Class, Priority, and so on) in the Spool Window

Cause: An administrator has not given you the right to change fields in the Spool Window.

Solution: Have an administrator assign you rights to modify documents in the Spool Window.

Override Table settings are not being applied to some files

Cause: An override table might not be applied properly when a file is being received through LPD and the control file comes after the data file.

Solution: We do not recommend using an override table for routing files when you are receiving the control file last. Complete the following steps to route the document based on the LPD queue name.

  1. Add the Data Set Header User Custom Section/LPD NDHDQNAM queue field to the Spool Window. This will add the column that displays the LPD queue name to the Spool Window.

  2. Enter the queue name in this column next to the desired printers.

All jobs that are received will now display the queue name in the document section of the Spool Window and will route the job to the printer with the matching queue name.

The Landscape option is unavailable in the Page Layout tab

Cause: The availability of some features listed on the Page Layout tab is based on the driver used by the Windows default printer. Windows printers using standard text drivers (for example, the Barr ASCII driver and Barr EBCDIC driver) cannot select special page formatting options because these drivers do not support special layouts on the destination device. Windows recognizes this and, therefore, the Page Layout Landscape option is unavailable when the Windows default printer is configured with a standard text driver.

Solution: Set the default Windows printer to a printer that uses a driver provided by Windows or the printer manufacturer.

  1. Open the Add Printer Wizard.

  2. From the Printers folder, right-click a printer that uses a driver provided by Windows or the printer manufacturer. If this printer does not exist, create a dummy printer to be used as the computer's default.

  3. Click Set as Default Printer.

Cannot change Data Set Headers in the Rules Editor

Cause: The override table is used to assign attributes in the Barr header based on the values in other Barr header fields. The override table can be configured to allow data set header attributes to assign data set header attributes or to allow job header attributes to assign job header attributes.

Conditions added to the job header overrides cannot be used to assign data set header attributes. However, data set header overrides can assign either job header attributes or data set header attributes. Rules added to the job header overrides can only modify job header attributes.

Solution: Complete the following steps.

  1. Modify the override table.

  2. From the Rules Editor dialog box, select Data Set Header Overrides in the Rules section.

  3. Click Add.

You can now add rules that will affect the data set header attributes.

Form overlays are not being applied to print jobs

Cause: The overlay is actually being applied to the job, but the Windows printer driver is overriding the setting. Unlike the data in the job, the overlay bypasses the GDI Acronym for Graphical Device Interface. In Windows, a graphics display system used by applications to display or print bitmapped text (TrueType fonts), images, and other graphical elements. and printer driver when it is sent to the printer. Depending upon how the manufacturer's driver formats and handles the data, the printer might ignore the overlays that are sent after data has passed through the GDI.

For example, if both the beginning and ending overlays are specified, the first overlay is sent to the printer and the printer will accept the raw overlay. Data sent through the GDI to the printer is formatted by the printer driver. From this point through the end of the print job, the printer might no longer accept data that has not been formatted by the driver. The ending overlay might be ignored by the printer because it bypasses the GDI.

Solution: Use a plain text driver (for example, Barr ASCII Printer Driver) when using overlays, or use the Page Layout feature when using Windows printer drivers.

Cannot modify data set header overrides in the Rules Editor

Cause: The override table is used to set attributes in the Barr header based on the values in other Barr header fields. The override table can be configured two ways: data set header attributes can set data set header attributes or job header attributes can set job header attributes.

In the Rules Editor, conditions added to the job header overrides cannot be used to set data set header attributes and rules added to the job header overrides will only be able to modify job header attributes. However, if a data set header override is added, job header attributes and data set header attributes can be used to override a data set attribute.

Solution: Modify the override table. From the Rules Editor dialog box, select Data Set Header Overrides in the Rules section and click Add. You will now be able to add rules that will affect the data set header attributes.

Page layout settings are not being applied to jobs

Cause: Barr Enterprise Print Server cannot apply page layout settings when receiving and printing pass-through data.

Solution: For data in a destination-ready format Data formatted for its ultimate destination. For example, if the data is intended for a printer, it becomes destination-ready when it gets converted to the format the intended printer requires. (for example, data formatted with PCL Acronym for Printer Control Language. Hewlett-Packard uses this language in its LaserJet, DeskJet, and RuggedWriter printer lines. codes), you must enable the Pass data to the printer without conversion option and you will be unable to format the data with the page layout feature. To use the page layout feature, you must remove the embedded formatting from the document and send plain text (for example, ASCII or EBCDIC depending on source).

BARR/SPOOL only uses page layouts when printing to computer printers (for example, a desktop laser printer) that do not have special data-handling options selected.

Unable to rename printers, changing case only

Cause: Because of registry restrictions, it is not possible to rename spool printers changing only the case.

Solution: To get around this problem, we suggest following these steps.

  1. Rename the printer. This must include changes to the text (in addition to case changes).

  2. Rename the printer again with the desired name (with corrected case).

Unable to configure the printer

Cause: The PrinterCfg.dll is not registered.

Solution: Complete the following steps to manually register a DLL.

  1. Open the MS-DOS prompt.

  2. Change your directory to the folder where the DLLs are located. By default, DLLs are stored in the \\Program Files\Barr\Spooler\EXE folder, unless another location is specified during installation.

  3. Enter the following command at the command prompt:

regsrv32 dllfile

  1. Type the appropriate DLL name for dllfile. For example, you would type regsrv32 PrinterCfg.dll to register the PrinterCfg.dll.