Oki MC760x, MC770x, MC780x, ES7470x MFP, ES7480x MFP Print Data Converter Function Guide

...

MULTIFUNCTIONAL LED PRINTER

Print Data Converter Function Guide

Rev. 1.00

45984401EE

Trademarks

Microsoft, Windows, Windows NT, and the brand names and product names of other Microsoft products are trademarks of

Microsoft Corporation in the US and other countries. The official name of Windows XP is Microsoft Windows XP Operating System. The official name of Windows Vista is Microsoft Windows Vista Operating System. The official name of Windows 7 is Microsoft Windows 7 Operating System. The official name of Windows Server 2003 is Microsoft Windows Server 2003 Operating System. The official name of Windows Server 2008 is Microsoft Windows Server 2008 Operating System. Apple, AppleTalk, Macintosh, Mac, Mac OS, Safari, and TrueType are trademarks of Apple Inc. in the US and other countries. Adobe, Adobe Acrobat, Adobe Reader, Adobe Acrobat Reader, and PostScript are trademarks of Adobe Systems Incorporated. IBM, AT and AIX are trademarks of International Business Machines Corporation. TopAccess is a trademark of Toshiba Tec Corporation. Other company names and product names in this manual are the trademarks of their respective companies.

CONTENTS

1. OVERVIEW .......................................................................................................................................... 3

1-1. Support Information ................................................................................................................... 3

1-2. What is Print Data Converter? ................................................................................................... 3

1-3. Function Overview...................................................................................................................... 4

1-4. Print Data Converter support target .......................................................................................... 4

2. How to apply Print Data Converter .................................................................................................... 5

2-1. Print Data Converter Application flow ...................................................................................... 5

2-2. Create Print Data Converter XML file ........................................................................................ 5

2-2-1. Sample XML file ................................................................................................................ 5

2-2-2. Overview of XML description .......................................................................................... 6

2-2-3. XML description details ................................................................................................... 6

2-3. Setting up LPR queue ................................................................................................................ 7

2-3-1. Adding an LPR queue via TopAccess ............................................................................ 7

2-3-2. Changing LPR queue on user’s environment ................................................................ 8

2-4. Setting up Print Data Converter XML file from TopAccess ..................................................... 8

2-4-1. Accessing TopAccess in the administrator mode ......................................................... 8

2-4-2. Setting up Print Data Converter ...................................................................................... 9

2-4-3. Import New Converter ...................................................................................................... 9

2-4-4. Enable/Disable Print Data Converter ............................................................................ 10

2-4-5. Export Converter ............................................................................................................ 10

2-4-6. Delete Converter ............................................................................................................ 10

3. Examples ........................................................................................................................................... 11

3-1. [Example] Force Monochrome print and allow Color for specified users ........................... 11

3-2. [Example] Change any Paper Source command to AUTO command .................................. 12

3-3. [Example] Allow printing from AS400/Unix/Linux on NO LIMIT BLACK function ............... 13

Appendix A - WildCard for SearchPattern .......................................................................................... 16

Appendix B - Changeable parameters ................................................................................................ 17

Appendix C - list of major PJL ............................................................................................................. 18

Appendix D - list of major PCL5 command ........................................................................................ 22

Q&A........................................................................................................................................................ 24

1. OVERVIEW

This chapter describes the overview of Print Data Converter.

1-1. Support Information

Print Data Converter is supported by MC7 series, MB7 series, MC9 series, and ES and MPS models of those series.

1-2. What is Print Data Converter?

Print Data is composed of PJL (optional) and PDL.

PJL (Printer Job Language) : used for job-level printer control/Printer configuration/etc (e.g. Staple)

PDL (Page Description Language) : used for page-level control/image data/etc (e.g. Page Size)

Print Data Converter is the function that allows MFP to replace/add/remove the PJL and PDL of print job before job processing.

The purpose of this function is:

to fix some print problem tentatively (without ROM update)

to provide some solutions of printing function for the customer demand

Replace/add/remove PJL/PCL5 command

PJL part

(optional)

PJL part

(optional)

PDL part PDL part

Print Job

process

Converting

JOB

Fig.1-1

Usage example:

PJL

- Remove specific string from Job Name which will be shown in Job Log ("Microsoft Word - TEST.doc“ -->”TEST.doc”)

- Force Monochrome print (by changing PJL string - @PJL ....RENDERMODE=COLOR -->GRAYSCALE)

- Force Hold Print (@PJL ....PRINTMODE=NORMAL -->HOLD)

PDL (PCL5 command)

- Repair incorrect command to prevent unexpected output

(Replace incorrect A4 size command - “Ec&(26A” with ”Ec&l26A”)

- Force PaperSource Auto selection (Replace any cassette command “Ec&l#H” with AUTO command ”Ec&l7H”)

- Replace Paper related command - Size / Duplex / Source / etc...

See more details in Appendix B - changeable parameters.

As Print Data Converter changes incoming print data, be aware of the risk that unexpected result may occur. To reduce the

risk, limiting applied users using additional LPR queue is STRONGLY recommended.

(No definition / defining default LPR queue (“Print”) to ‘Queue’ element is not recommended because almost incoming

print data will be converted.)

1-3. Function Overview

Converter Setting

(XML based)

"We don't need any solutions"

"We need solution A"

management

(Admin-> Setup->

Print Data Converter)

Import/Export/

Delete

TopAccess

Default queue

queue01

queue02

Converting

"I need solution B & C"

JOB

process

Different Convert setting

can be defined

for each printer queue

printer queue can be added on

TopAccess - Raw Job Setting

Fig.1-2

- Print Data Converting definition (rule) must be described in XML format.

- Print Data Converter file can be created by Service Technicians.

- Print Data Converter file can be imported/exported/deleted via TopAccess.

- Print Data Converter function can be Enabled/Disabled on TopAccess.

- One MFP can import only one XML file.

- One XML file can include multiple convert definitions.

- Limiting Print Data Converter effect to the specified user(s) is possible using Print queue definition.

1-4. Print Data Converter support target

Print Data Converter supports the following conditions.

Table.1-1

Language of

Print Job

PCL5 / PCL5c Yes Yes

PCL6 Yes No

PJL

Conversion

conversion

PDL

PS Yes No

XPS N/A No

*PCL5/PCL5c is not supported by Printer Driver. Legacy environment is assumed.

*PJL is the optional command. Print Job may not contain PJL. It is depend on print environment.

*Printer Driver always contents PJL command except XPS.

2. How to apply Print Data Converter

This chapter describes how to setup and apply Print Data Converter

2-1. Print Data Converter Application flow

1) Analyze user’s issue (problem) / Investigate user’s demand (request)

2) Analyze actual print data

3) Create xml file which will fix the issue / satisfy user’s demand

4) Testing with created xml file

5) Install xml file via TopAccess and setup user’s print environment

Basically 1) to 5) should be done by Service Technician but only 5) is acceptable to be done by User’s Administrator. (TopAccess)

XML file is not installed in MFP by factory default to prevent print data crush by User Administrator’s wrong usage.

2-2. Create Print Data Converter XML file

Print Data Converter XML file can be created using text editor (i.e. Windows NOTEPAD), XML editor (i.e. Microsoft XML Notepad)

and so on.

2-2-1. Sample XML file

Following is the sample of XML file

<?xml version="1.0" encoding="UTF-8"?>

<SearchPattern>@PJL COMMENT DSSC PRINT RENDERMODE=*</SearchPattern>

</SearchPatterns>

<Replacement>@PJL COMMENT DSSC PRINT RENDERMODE=GRAYSCALE</Replacement>

<OperationType>Replace</OperationType>

<Queue>MonoPrintQue</Queue>

</AssociatedQueues>

</PDConverter>

</SearchPatterns>

<OperationType>Replace</OperationType>

<Queue>LTLDtoA4que</Queue>

</AssociatedQueues>

</PDConverter>

</PDConverterList>

</PDConverters>

Above sample XML contents two converter settings. (Red and Blue)

1) Force Monochrome print to the job which is sent via “MonoPrintQue” LPR queue.

2) Change the page size from LT/LD to A4 for PCL5 job which is sent via “LTLDtoA4que” LPR queue

2-2-2. Overview of XML description

- One XML file can define MULTIPLE settings (Index starts from 0).

- Each setting can be enabled/disabled in XML file (Enabled=”true”/”false”).

- Need to define PJL or PCL for LanguageType to clarify the target (Controller’s behavior will change depend on this

setting).

- MULTIPLE SearchPattern can be defined.

- Wildcard can be used for SearchPattern (“*” for PJL, “#” for PCL and “?” for both LanguageType).

- Printer Queue can be defined. Limiting the user by Printer Queue will reduce the risk of crash or invalid print result by

unexpected conversion.

- An escape sequence must be entered as a backslash followed by an 8-bit hexadecimal number, e.g. "\x1B" for [ESC] ,

"\x0D" for [CR] or “\x0A” for [LF].

- The ampersand, the left and right angle brackets must be entered as escape sequences "\x26", "\x3C" and "\x3E"

respectively, since they are not allowed as literals in an XML document. (e.g. PCL5 page size A4 command

“Ec&l26A” should be defined as “\x1B\x26l26A”)

2-2-3. XML description details

Table.2-1

Element/Attribute type comment

Index integer mandatory

Name string optional

Enabled boolean mandatory

LanguageType string mandatory

SearchPattern string optional

Replacement string mandatory

Converter index (should starts from 0)

Converter name

“true” or “false” If “true”, the setting will be enabled. If “false”, the setting will be disabled.

“PJL” or “PCL” Types of language to convert “PJL”: Select when converting PJL. (Only PJL part will be the target of converting.) “PCL”: Select when converting PCL5 command. (PJL part will be skipped for converting.)

Define the string to search. (PJL or PCL5 command) Multiple SearchPattern can be defined in SearchPatterns element. Wildcard can be used. (see details in Appendix A)

Define the string to convert/newly add.

OperationType string mandatory

“Replace”, “InsertBefore”, “InsertAfter” or “InsertAtBeginning”

“Replace”: the string defined in “SearchPattern” will be replaced by the string defined in “Replacement”. “InsertBefore”: the string defined in “Replacement” will be inserted before the string defined in “Replacement”. “InsertAfter” : the string defined in “Replacement” will be inserted after the string defined in “Replacement”. “InsertAtBeginning”: the string defined in “Replacement” will be inserted at the beginning of print data.

Element/Attribute type comment

EndSequence string optional

Queue string mandatory

Stop converting when received defined command/string in the incoming print data stream. This definition is to reduce the risk of performance/unexpected converting. Multiple EndSequence can be defined in EndSequences element. Note that an escape sequence cannot be defined as EndSequence.

Print queues to which the converter is associated. Apply the converter to any queues if not specified. At least one queue must be specified when OperationType=="InsertAtBeginning" Multiple Queue can be defined in AssociatedQueues element.

2-3. Setting up LPR queue

This chapter describes how to add LPR queue to the MFP.

As Print Data Converter changes incoming print data, be aware of the risk that unexpected result may occur. To reduce the risk,

limiting applied users using additional LPR queue is STRONGLY recommended. On this understanding, if default queue is preferred

to apply Print Data Converter, define default print queue “Print” in ‘Queue’ element.

2-3-1. Adding an LPR queue via TopAccess

1) Access TopAccess in the administrator mode.

2) Click the [Setup] menu and [Printer] submenu.

3) To add a new LPR queue, click [Add] in Raw Job Setting.

Fig.2-1

4) Enter the queue name using up to 31 alphanumeric characters. The queue name is case sensitive so that “Queue1”

and “queue1” will be added as different queues.

5) Set up other items (See details in TopAccess Guide - Setting up Raw Job Setting)

6) Click [Save].

For example of sample XML in 2-2-1, two LPR queue should be created, such as “MonoPrintQue” and “LTLDtoA4que”.

In Raw Job Setting,

you can add up to 16 LPR queue names and specify the raw job setting for each queue.

+ 17 hidden pages

Oki MC760x, MC770x, MC780x, ES7470x MFP, ES7480x MFP Print Data Converter Function Guide

Specifications and Main Features

Frequently Asked Questions

User Manual