DoCPrint software


DoCPrint software enables you to print from any application with copies, overlays and logos. You can print single or two-sided, with or without toner saving. You can print from any combination of input trays to different output bins. You can print documents to your local printer and copies to other printers - all automatically.

DoCPrint Technical Manual

The DoCPrint command language

A DoCPrint command consists of:

  1. a command opener - "(("
  2. a list of commands or a template name
  3. a command closer - "))"

DoCPrint commands are alpha numeric characters as follows:

1-32 number representing an input tray or an output bin
A - Z DoCPrint function identifier
/ identifies the following numeric as an output bin
[ ] encloses an overlay list
1 - 9999 number representing an overlay ID
; function separator (semicolon)
, parameter separator (comma)
: quantity delimiter (colon)
<> Encloses a port number for distributed printing
1-60 number for DoCport
C copy function
D default input/output function
F Economode
H Staple options (optional configuration)
S stay on input tray function (deprecated command)
T duplex (long edge by default) function
TL duplex function (long edge)
TS duplex function (short edge)
P# Port number for distributed printing
Q# Port number for setting printer

DoCPrint Function list

Functions allow you to select input paper source, output destination, whether to duplex or not, which overlays to use, the number of copies you require and if using distributed printing, which DoCport is specified.
The following section details each of the functions together with examples. The command examples are shown without the command opener and closer.

Input tray selection


A numeric value in the range 0 - 32 identifies the input tray for the first page to be printed.
Example 2 First page from input tray 2

Default input tray selection function


A numeric value in the range 0 - 32 preceded by the default function ‘D’ identifies the input tray for all following pages.
Example D,3 All other pages from tray 3
    The complete command is 2;D,3

Output tray selection function


A numeric value of 1-32 preceded by the ‘/’ character identifies the output tray.
Example 2/4; First page from input tray2
output to Mailbox 4
Set default tray to 3 D,3/4 All other pages from input tray 3 output to Mailbox 4
    The complete command is 2/4;D,3/4

Copy function


A list of numeric values preceded by the copy function ‘C’ identify a list of copies to be printed.
Example 2;d,1;C,1,2,3:2,3 1 copy from tray 1
1 copy from tray 2
2 copies from tray 3
1 copy from tray 4
Example of copy and output tray function 2/2;d,1/2;C,1/4,2/5,3/6 1 copy from tray 1 to Mailbox 4
1 copy from tray 2 to Mailbox 5
1 copy from tray 3 to Mailbox 6

Duplex commands


T Duplex document, default is long edge binding
TL Duplex document, long edge binding
TS Duplex document, short edge binding
T;2;d,1;c,3 First two sides from tray 2, the remainder of the document prints from tray 1 and a copy of all is printed from tray 3. The complete job is printed in duplex with long edge binding,

Select printer


<Q#> The document will be printed by the printer attached to DoCport#.
(This command directs print jobs to a specific DoCPrint printer. You can assign specific jobs to individual printers). This command must be the first in the string.
<Q3>2;d,3;c,1 The printer on DoCport3 will handle this document even if it is printed to another DoCPrint printer. For example, sensitive documents have to print to a specific printer, even if the user has forgotten to change the destination printer.

Distributed printing


<P#> The command following this will send data to the printer on DoCport#
  2[100];d,1[101];<P2>2[102];d,1[103];<P3>3[104];d,2[105]
  The first page of the document will:
Print from tray 2 of the printer mapped to the current DoCport with overlay 100
ALSO
Print from tray 2 of the printer mapped to on DoCport2 with overlay 102
ALSO
Print from tray 3 of the printer mapped to on DoCport3 with overlay 104
Other pages will
Print from tray 1 of the printer mapped to the current DoCport with overlay 101
ALSO
Print from tray 1 of the printer mapped to on DoCport2 with overlay 103
ALSO
Print from tray 2 of the printer mapped to on DoCport3 with overlay 105
By combining the Select Printer and Distributed Printing commands, you can cluster two or more printers with different paper types in each, and documents will be printed on the correct printer(s) with the correct paper.

Economode


F1 Puts printer into Economode for the current document
F0 Takes the printer out of Economode for the current document
This is only necessary if the printer default is Economode On.
F1;2;d,1 Set the printer to Economode, print the first page from tray 2 and the remainder from tray 1

Overlay commands


The following alpha characters are used to prefix overlay IDs

No prefix Side 1 before data Type 1
V Side 2 before data Type 2
B Both sides before data Type 3
K Side 1 after data Type 4
P Side 2 after data Type 5
R Both sides after data Type 6
U Duplex on reverse Type 7
E Duplex on reverse (LEF) Type 8
G Duplex on reverse (SEF) Type 9
H Duplex on reverse (90 °) Type 10

A comma separated list of overlay IDs to be printed with each page may be attached to the input tray selection command. The overlay number must immediately follow the input tray number.
When an overlay has no prefix it will print on side one only, before data, even if the document is duplexed.

Examples  
2[10] Print first page from tray 2 and use overlay 10
2[10,15] Print the first page from tray 2 and use overlays 10 and 15
2[10,15]/3 Print the first page from tray 2 and use overlays 10 and 15, then output goes to Mailbox 3
2[10,P201]/3 Print first page from input tray 2, put overlay 10 on side 1, automatically duplex this page and put overlay 201 on side 2, and output to Mailbox 3
2[10,15]/3 Print the first page from tray 2 and use overlays 10 and 15, then output goes to Mailbox 3
D,6[60]/6 All pages from input tray 6 with overlay 60, output to Mailbox 6
Remember, the ID number is 2000 less than the overlay number created by Commander Generator.
For example, if the overlay ID number created by the Command Generator is 2103, the number you put into the command string is 103.

Named commands

It is recommended that the Command tab of the DoCPrint Commander is used to generate print profiles for standard commands you may wish to use. The print profile name can then be used within the document enclosed by a command starter : 2 round brackets followed by an equal sign followed by the print profile name then command closer e.g. two close round brackets. The command associated with print profile name; will be extracted from the strings.cfg file and used to generate all the copies, overlays, duplex command etc..

Using the popup menu

Embedding commands is fine for controlled tasks where the command can be put in a template or as part of a fixed text area. This method requires no input from the user. However some applications require greater flexibility as the application program may not permit any command string to be embedded or may submit data for printing in a format where the command cannot be recognised.
Enabling ‘PopUp Menu’ from the options tab in DoCPrint Commander means that a dialog showing all the commands that have been created will pop up when you print to that DoCport.
You may select any of the commands you have created with the DoCPrint Commander or you may make any other selection from the following dialog box.
If you only need to choose between a default print and command profiles you have already created, click on ‘Less’ and the simpler PopUp dialog will be used by default.
If you are using another method for some documents and only require PopUp menu in certain applications, you can use another local printer on a separate DoCport with PopUp enabled.
Note: If the document you print contains an embedded command this will take precedence over any selection made in PopUp.

Programable interface

DoCPrint can also be accessed via any program that can call a dll function.

Accessible functions

The following functions are available in the AptDoC01.dll
BOOL bSetPrinter(lpPrinterName);
Specifies the printer you want to print to.

BOOL bSetPrnFile(lpPrnFileName);
Specifies the prn file you want to print.

BOOL bSetDefaultsFromReg(void);
Sets the options defined for the printer on DoCport1.

BOOL bSetPrintCode(lpCode);
Sets the Command to print this file with.

BOOL bSetDelete(BOOL);
If non zero deletes the file after it has been printed.

BOOL bPrintFile(void);
Prints the File.