Printronix SMARTLINE SL4M User manual

XML Direct for Oracle
Quick Setup Guide
Thermal Series Printers

XML Direct for Oracle
Quick Setup Guide
Thermal Series Printers

Trademark Acknowledgments
Oracle is a registered trademark of Oracle Corporation.
Printronix and PSA are registered trademarks, and SL4M and T4M are
trademarks, of Printronix, Inc.
Unibar and BARCODE 2000 XML DIRECT are registered trademarks of
Unibar, Inc.
Portions of this manual used by permission of Unibar, Inc. Copyright 1996-
2005 Unibar Inc.
Portions of this manual used by permission of Oracle Corporation. Copyright
2003-2005 Oracle Corporation.
COPYRIGHT 2005, 2006 PRINTRONIX, INC.
All rights reserved.

1 Introduction ........................................................... 7
About This Manual................................................................................. 7
XML Direct ............................................................................................. 7
2 Oracle Solution ..................................................... 9
3 Troubleshooting .................................................. 15
4 Printing with XML Direct...................................... 17
Using BarCode 2000 XML Direct......................................................... 17
Installation ..................................................................................... 17
A Brief Overview ........................................................................... 18
Getting Started .............................................................................. 19
BARCODE 2000 XML DIRECT Components ............................... 20
Introduction to Label Data Dictionary ............................................ 21
Introduction to Label Design System (LDS) .................................. 29
Download Template Utility............................................................. 43
Print Config ................................................................................... 45
BARCODE 2000 XML DIRECT File Types ................................... 49
Configuration File & Print Destination Table ................................. 50
Unibar Base Directory ................................................................... 53
Setting the Environment String ............................................... 53
UNIX / Linux............................................................................ 53
Windows Systems .................................................................. 54
A Label Compliance Formats ................................. 55
Label Formats...................................................................................... 55
B Contact Information............................................. 65
Printronix Customer Support Center.................................................... 65
Printronix Supplies Department ........................................................... 65
Corporate Offices................................................................................. 66
Table of Contents

Table of Contents

7
1Introduction
About This Manual
This manual explains the use of the XML language with the Printronix®
SL5000r/T5000r and SL4M/T4M XML Direct printers. Use this manual with
your
SL5000r/T5000r or SL4M/T4M User’s Manual for complete printer-
protocol operation.
XML Direct
Printronix XML Direct enabled printers come equipped with an internal XML
Forms Module. This interface software has been certified for use with Oracle
WMS and MSCA applications. This solution allows users to quickly leverage
RFID technology by connecting tagged objects with the business view of an
ERP system.
Here is a high level overview of how XML Direct works in 4 easy steps:
•The user creates the PGL formatted label template. Use XML Direct label
design software provided by Printronix or follow the examples in chapter
2.
•The template is downloaded to the printer's permanent memory.
•The host application sends XML formatted run time data to the printer.
•The run time data is merged with the stored template, the RFID tag is
encoded and the label is printed.
Details of each of these steps are as follows:
1. Create the label format. This may be done by any of the following
methods:
(a) Use the XML Direct label design software provided by Printronix.
(b) Use commercially available XML enabled label design software.
(c) Follow the programming example in chapter 2 of this manual to create
an XML enabled PGL template. Chapter 2 also provides directions to
sample template files.

8
Chapter 1 XML Direct
2. Download the format to the printer. This may be done via the following
methods:
(a) Use the Format Download Utility supplied with XML Direct label
design utility. (see Chapter 4, Download Template Utility)
(b) Send the XML enabled template to the printer directly from the
operating system the same way you would any other file. For example,
from a DOS command line prompt on a parallel interface you could type
"copy/b <filename> lpt1:".
3. Host application sends XML formatted run time data to the printer. See
chapter 2 for an overview of configuring Oracle to send XML.
4. Merging run time data with the stored template - this step is performed
automatically by the XML Forms Module that is resident on the printer. If
the above steps are followed, the Printronix XML enabled printer will
encode and print RFID smart labels directly from your SAP system.

9
2Oracle Solution
This section discusses the full implementation of the XML printing solution for
Oracle, including an Oracle specific overview, along with instructions for
installation and configuration on the Oracle system.
Introduction
Oracle Warehouse Management (WMS), Oracle Mobile Supply Chain
Applications (MSCA), and Oracle Inventory are applications in Oracle’s
Logistics products. The Oracle WMS and MSCA applications have integrated
label-printing capabilities using XML. Oracle has created 10 XML label
formats that correspond to common transaction created by WMS and MSCA.
When printing a label, the Oracle application determines the correct label
printer and label format to use based on the data included in the request and
rule configuration. Using the format definition, the label data are extracted and
combined into a standardized XML document that is sent to the label printer.
When Oracle receives a label print request, it searches for a printer
assignment in the following sequence: User, Subinventory, Responsibility,
Application and Site level. If no printers are assigned to Label Types, no
labels can be printed.
The 10 label types available with Oracle WMS and MSCA are defined below:
LABEL TYPE DESCRIPTION
LPN License plate information
LPN Content LPN plus content information
LPN Summary Nested contents summarized
Material Item, quantity, lot, etc.
Serial Material information plus serial number
Location Subinventory & locator information
Shipping Customer & address information
Shipping Content Shipping plus material info
WIP Contents LPN plus discrete job information
Flow Contents LPN plus flow schedule
Oracle supports three modes of label printing integration: Asynchronous
mode, Synchronous PL/SQL mode, and Synchronous TCP/IP mode. Of these
three printing integration mode, the Synchronous TCP/IP mode is the easiest
and most powerful method. In this mode, print requests are sent directly to

10
Chapter 2
printers over a TCP/IP connection opened by Oracle. This mode does not
require any 3rd party software to be loaded in the Oracle database.
In addition to the information provided in this chapter, selected Oracle
documentation has been provided for your reference in the Manuals sub
folder:
Seeded Label Formats - Oracle WMS & MSCA
Labeling in WMS & MSCA
Oracle® Warehouse Management Implementation Guide
Installation
To use the Synchronous TCP/IP mode, the printer must be setup within
Oracle. Printers are setup in the same way they are normally setup within
Oracle except you do not need printer drivers for the label printers. Setting up
printers within Oracle requires the following steps:
1. Create a Label Type (performed only once)
2. Define label print mode (performed only once)
3. Register a printer in Oracle
4. Define printer IP Address
5. Assign printer to Label Types
6. Define label formats
Create a Label Type
To use Oracle’s XML enabled label-printing capabilities, a printer type, named
Label, needs to be defined. This printer type does not have to be associated
to any styles or drivers. Only one printer type, named Label, should be
created. To create a Label Type, do the following:
1. Using the System Administrator Responsibility Role, navigate to Install >
Printer > Types.
2. Create a type called Label and enter a description.
Define Label Print Mode
To ensure that Synchronous TCP/IP mode is used for label printing, we need
to set the WMS label print mode. To specify the label print mode, do the
following:
1. Using the System Administrator Responsibility Role, navigate to Profile >
System.
2. Select the profile option named: WMS: Label Print Mode
3. In the WMS: Label Print Mode option dialog, select Synchronous –
TCP/IP.
4. Save your settings.