Using this Guide .................................................................................................................................... 4
Additional Information ........................................................................................ 19
PDL Reference Guide for Xerox® ConnectKey® Products iii
Accessing Extended
Features
Overview
This document describes how to access the extended features of the Xerox® ConnectKey®
Products for environments that do not have a custom driver.
Some of the commands & syntax used in this document requires familiarity with PostScript (PS)
or Printer Command Language (PCL).
This document provides the Printer Description Language (PDL) commands and syntax for each
feature. The following tables are also included:
Features supported by the ConnectKey Products
Commands to use in a PCL print job
Commands to use in a PS print job
The information contained in this document is not intended as a PS or PCL reference manual, but
a guide for using the extended features in PS, PCL or ASCII print jobs.
Using this Guide
Refer to the Feature List for the feature you would like to implement. Select the page number to
jump to that page.
Follow the syntax listed for the command required. Read the “Dependencies/Caveats” section for
additional information.
Feature Listing
PCL and ASCII print jobs can use PJL commands or PCL commands to access the attributes of the
printer. PostScript print jobs can use Document Structuring Commands (DSC) or PS commands. If
there is more than one method listed to access a specific feature, determine the best method for
your application and use that method. In this document, both PJL COMMENT and DSC are
referred to as Comment commands.
PDL Reference Guide for Xerox® ConnectKey® Products 4
Comment Commands
To process all PJL COMMENT commands and DSC, enclose them with XRXBegin and XRXEnd
commands.
The first parameter of the command is an attribute followed by a value.
Comment commands must end with a semicolon except for the XRXbegin and XRXend
commands.
A comment command not enclosed by XRXbegin and XRXend is not a Xerox specific command
and is treated as a real comment with no functional attachment to its contents.
PJL SET Commands
PJL SET commands are available for some features. If you choose to use these commands, do
not enclose them with the XRXBegin and XRXEnd commands. PJL SET commands do not require
a semicolon at the end of the command line.
PCL Commands
PCL commands are available for some features. If you choose to use these commands do not
enclose them with the XRXBegin and XRXEnd commands. Refer to a PCL reference manual for
more specific information regarding PCL commands.
PS Commands
PS commands are available for some features. If you choose to use these commands, do not
enclose them with the XRXBegin and XRXEnd commands. Refer to a PS reference manual for
more specific information regarding PS commands.
PDL Reference Guide for Xerox® ConnectKey® Products 5
Reference Topics
XRXBegin
When interpreter receives XRXBegin it begins to parse PJL COMMENT commands checking for Xerox-specific
commands until it receives the command to stop parsing.
PJL COMMENT Command DSC Comment Command
@PJL COMMENT XRXbegin %%XRXbegin
XRXEnd
When the interpreter receives this command it stops parsing PJL COMMENT commands.
PJL COMMENT Command DSC Comment Command
@PJL COMMENT XRXend %%XRXend
General Commands
Copies
Use the following commands to specify the number of copies or collated sets of a document.
Language Collated
PS
PJL
PCL5
Language Uncollated
PS
PJL
PCL5
PDL
Banner Sheet (Start Sheet) – Device Generated
This command turns on/off the banner sheet that prints at the beginning of every job. It only applies to the job that
contains the command; it does not affect any other jobs. If the device is configured to disable banner sheets, this
command is ignored.
PDL Reference Guide for Xerox® ConnectKey® Products
DSC Command
%%OID_ATT_START_SHEET OID_VAL_JOB_SHEET_”string”;
Where string is:
NONE Do not create a banner sheet for this job.
FULL Create a banner sheet for this job. By default, if the START SHEET comment is not included a banner sheet
is generated unless the device has banner sheet disabled.
USER A custom start sheet is included in this job.
Media Commands
Media Source
This command specifies the tray to supply the job’s media.
PS <</MediaPosition int >> setpagedevice
where int is from the table below.
PCL5
PCL6
<Esc>&l#H
where # is from the table below.
ubyte ## attr_ubyte MediaSource
Tray 1 example: 0xc0 0x04 0xf8 0x26
where ## is the hex number assigned to each selection.
Tray PS intPCL5 # PCL6
Auto select null 7 0x01
1 1 4, 2, 3, or 6 0x04
2 2 1 0x05
3 3 5 or 23 0x07
4 4 8 or 24 0x08
5 5 21 0x0A
6 6 22 0x09
PDL Reference Guide for Xerox® ConnectKey® Products 7
PCL5 Command Tray Mapping Tool
A user with Administrator access rights to the device has the opportunity to change the PCL5
command used to identify a specific paper tray.
®
A user can do this by opening Xerox
address in their favorite Web browser.
To get to the PCL Tray Mapping page select the Properties tab Services Printing Page
Description Languages PCL Tray Mapping. Once there the user is able to select which listed
command will be used for a paper tray.
Note: Changing the device’s default mapping may cause issues when trying to select a paper
tray with the PCL 5 driver.
CentreWare® Internet Services by entering the printer’s IP
PDL Reference Guide for Xerox® ConnectKey® Products
Media Size
This command specifies the size of media on which to print the job.
Note: some sizes may not apply to every printer model.
PDL Reference Guide for Xerox® ConnectKey® Products 13
Internal Auditron or Xerox® Standard Accounting
This PJL command sends the users pin number for use by devices that support the Internal Auditron or Xerox®
Standard Accounting (XSA). You must provide at least a valid USERID. You may also provide a GENERAL Account
number or GROUP Account number if required.
Where xxxx is a valid USER Pin number.
Where yyyy is a valid GENERAL Account number.
Where zzzz is a valid GROUP Account number.
PJL/PCL Dependencies/Caveats
• Locate all PJL commands in the beginning of the file before the image data starts (PS or
PCL).
• To combine printer escape commands (not including PJL commands):
– The first two characters after the <esc> must be the same.
– All alpha characters must be lowercase, except the final terminating character.
– The commands are read left to right. Combine them in the order you wish them
executed.
– For example, print 5 copies (<ESC>&l5X) and use letter size (<ESC>&l2A) is combined as:
<ESC>&l5x2A
• In case of duplicate commands, the last one requested takes precedence.
• The PJL SET COPIES command takes precedence over the PCL command (<Esc>&l#X) to
determine number of copies. In general, PJL commands takes precedence over PCL
commands.
• Printing jobs with odd number of pages & duplex front and back imaged covers, the printer
always prints on both sides of the front and back covers. Remaining pages are printed on the
document body media type & color with a blank page inserted to allow an image on both
sides of the back cover.
• When using the Blank Front or the Blank Front & Back Cover command, the Cover Media Size
command is optional. If the cover size command is not in the PDL, the printer assumes the
cover media size is the same as the document body.
PDL Reference Guide for Xerox® ConnectKey® Products
• Use one of the following methods to specify media selection:
– Describe the media attributes with size, color, and type to allow the device to select the
matching source tray. If this media description method is used, leave the tray source
command out of the job, or set to Auto. If not, the tray source command takes
precedence over the tray selection capabilities of the device.
– Indicate the tray source for the job. If the tray source command is used, the system
automatically defaults paper type to the defined SYSTEM DEFAULT unless specified
otherwise. This prevents inadvertent use of special paper types. To override, include a
paper type specification of UNSPECIFIED in the job.
DSC/PS Dependencies/Caveats
• All %% commands (DSC comments) must be in the first 64KB of the job.
• WorkCentre and ColorQube devices support PostScript resolutions up to and including 1800
x 1800. Some PostScript jobs may not print if the high resolution is indicated. If this occurs,
print the same job at a lower resolution.
• The following media sizes do not print duplex and do not support staple commands: A6, B6,
5 x 7" Postcard (4.5 x 6"), envelopes and any custom sized media where the page width is
less than 5.5". A request to duplex or staple these media sizes is ignored.
• Jobs that indicate Transparencies, Labels, Envelopes or Tab-Stock do not support duplex
commands. The duplex print request is ignored when any of these media types are used.
• When printing an odd number of pages in a document with duplex front and back imaged
covers, the printer always prints on both sides of the front and back covers. The remaining
pages print on the document body media type and color with a blank page inserted to allow
an image on both sides of the back cover.
• When using the Blank Front or the Blank Front and Back Cover command, the Cover Media
Size command is optional. If the Cover Media Size command is not in the PDL, the printer
assumes the cover media size as that of the document body.
• Use one of the following methods to specify media selection (where applicable):
– Describe the media attributes with size, color, and type to allow the device to select the
matching source tray. If this media description method is used, leave the tray source
command out of the job, or set to Auto. If not, the tray source command takes
precedence over the tray selection capabilities of the device.
– Indicate the tray source for the job. If the tray source command is used, the system
automatically defaults paper type to the defined SYSTEM DEFAULT unless specified
otherwise. This prevents inadvertent use of special paper types. To override, include a
paper type specification of UNSPECIFIED in the job.
PDL Reference Guide for Xerox® ConnectKey® Products 15
Examples
Basic PCL/PJL Template
This section illustrates a standard PCL template example that is used to access general print
features. This example lists each feature and the syntax, both PCL commands and PJL, required
to use these features.
Note: This section is only an example that may include features & commands that do not exist
on all products.
This print job specifies the following items: Job owner; Job name; 11 x 17 paper size;
Heavyweight, Green paper, 1 staple, draft mode.
Section 1 (Opening Command, Required for all files)
<Esc>%-12345X
Section 2 (PJL Set Commands)
@PJL SET RESOLUTION=600
@PJL SET COPIES=1
@PJL SET DENSITY=4
@PJL SET JOBOFFSET=ON
Section 5 (XRXend - Closing Statement for Comment Section, Required)
@PJL COMMENT XRXend
Section 6 (PCL Code used to invoke PCL Language)
@PJL ENTER LANGUAGE=PCL
Section 7 (PCL Data Stream or ASCII Document inserted here for Options such as Selecting
Different Fonts, Simplex, Duplex, etc.)
[Document or Text to print inserted here]
PDL Reference Guide for Xerox® ConnectKey® Products
Section 8 (Closing Command, Required at end of Document)
<Esc>%-12345X
Sample PJL Headers
Note: This section is only an example that may include features and commands that do not exist
for every product model.
Example 1 Header for Simple Print
<Esc>%-12345X
@PJL SET COPIES= 1
@PJL COMMENT XRXbegin
@PJL COMMENT OID_ATT_JOB_OWNER “John Smith”;
@PJL COMMENT OID_ATT_JOB_NAME “Print Job”;
@PJL COMMENT XRXend
@PJL ENTER LANGUAGE=PCL
[Insert PCL document or text to be printed here]
<Esc>%-12345X
Example 2 Header for Proof Print
This is a proof print job header that requests 6 copies
<Esc>%-12345X
@PJL SET COPIES= 6
@PJL COMMENT XRXbegin
@PJL COMMENT OID_ATT_JOB_TYPE OID_VAL_JOB_TYPE_ PROOF_PRINT
@PJL COMMENT XRXend
@PJL ENTER LANGUAGE=PCL
[Insert PCL document or text to print here]
<Esc>%-12345X
Example 3 Header for Finishing Options
This is a proof print job header requesting the staple option. You must send the job to the stacker
using the native PCL command.
<Esc>%-12345X
@PJL COMMENT XRXbegin
@PJL COMMENT OID_ATT_JOB_OWNER “John Smith”
@PJL COMMENT OID_ATT_JOB_TYPE OID_VAL_JOB_TYPE_PROOF_PRINT;
@PJL COMMENT OID_ATT_FINISHING OID_VAL_FINISHING_STAPLE;
@PJL COMMENT XRXSTAPLE=PORTRAIT;
@PJL COMMENT XRXend
@PJL ENTER LANGUAGE=PCL
<Esc>&l2G
[Insert PCL document or text to print here]
<Esc>%-12345X
*** Some Products will need to only select the Stapler, the stacker will be automatically added.
PDL Reference Guide for Xerox® ConnectKey® Products 17
Basic PostScript/DSC Template
This section is an example of a standard PostScript template that is used to access general print
features. This template lists each feature and the syntax, both Postscript commands and DSC
(Document Structuring Conventions) required.
Note: This section is only an example that may include features and commands that do not exist
for every product model.
This example print job specifies the following items; Job owner; Job name; 11 x 17 paper size;
Drilled; Ivory paper; 1200 x 1200 resolution; Staple off; Landscape; Sample set; Draft mode;
Offset off; Banner sheet off; Duplex long edge; One copy
%%OID_ATT_JOB_OWNER "John Smith"; (Quotation marks are required)
%%OID_ATT_JOB_TYPE OID_VAL_JOB_TYPE_PRINT;
%%OID_ATT_START_SHEET OID_VAL_JOB_SHEET_NONE;
%%OID_ATT_JOB_NAME "Readme.txt"; (Quotation marks are required)
%%OID_ATT_PRINT_QUALITY OID_VAL_PRINT_QUALITY_DRAFT;
Section 4 (XRXend - Closing statement for Comment Section, Required)
%%XRXend
Section 5 (Options Such as Selecting Different Fonts, Simplex, Duplex, etc.)