› KCM Core Scripting Language Developer's Guide › External tools › ChangeBins tool › ChangeBins configuration › Create the configuration file

Create the configuration file

The ChangeBins and ChangeBinsW programs read their printer mappings from the configuration files ChangeBins.cfg and ChangeBinsW.cfg, respectively. These files must be present in the same directory as the programs.

The configuration files are text files and you can edit them with any text editor. Unicode and UTF-8 encodings are not supported.

For every printer configuration, a line must be present that contains the following information:

  • The name of the printer in quotation marks
  • One or more paper tray numbers, separated by spaces or tabs

All configured printers must have the same number of paper trays in their specification. The trays are matched based on their order of occurrence. If a printer does not provide a paper tray, specify an alternative. It is allowed to specify the same paper tray more than once.

Whenever a printer mapping is performed, the ChangeBins tools look up the configuration for the printer used to configure the Microsoft Word document. For every paper selection used in this document, it looks up the first occurrence of this tray number in the configuration. If the number occurs, it is replaced with the matching tray number from the configuration of the target printer. If the tray number does not occur in the configuration, it is replaced by "0" (no tray selected). This instructs Microsoft Word to fall back to the Auto Select tray when it prints the document.

A sample configuration: 

"PS_LJ4000"			               0		15	 261	 257	 259
"HP LaserJet 4050 Series PS"	0	 15	 269	 271	 270
"\\xerox\xerox"		           	0	 15	 2	   2	   2

In this example, the paper trays are specified in the following order.

  1. Bin 0 (defaults to AutoSelect for DOC documents)
  2. In this example, 15 indicates auto select for the various printers
  3. Plain paper
  4. Letterhead paper
  5. Preprinted paper

The \\xerox\xerox printer in this example has only a single paper tray, so all paper types are mapped to Plain paper as replacements.

It is not necessary to provide mappings for every available printer. If printers are equipped with identical options, their configurations should also be identical, and it is sufficient to provide a generic printer identification to match all devices.