Printronix, Inc. makes no representations or warranties of any kind regarding
this material, including, but not limited to, implied warranties of
merchantability and fitness for a particular purpose. Printronix, Inc. shall not
be held responsible for errors contained herein or any omissions from this
material or for any damages, whether direct, indirect, incidental or
consequential, in connection with the furnishing, distribution, performance or
use of this material. The information in this manual is subject to change
without notice.
This document contains proprietary information protected by copyright. No
part of this document may be reproduced, copied, translated or incorporated
in any other material in any form or by any means, whether manual, graphic,
electronic, mechanical or otherwise, without the prior written consent of
Printronix, Inc.
All rights reserved.
17500 Cartwright Road, P.O. Box 19559
Irvine, California 92713
Telephone (714) 863–1900 FAX (714) 660–8682
Technical Support (714) 221–2686
COPYRIGHT 1995, PRINTRONIX, INC.
Trademark Acknowledgments
IBM and IBM PC are registered trademarks of International Business
Machines Corp.
Printronix is a registered trademark of Printronix, Inc.
IGP is a registered trademark of Printronix, Inc.
ThermaLine is a registered trademark of Printronix, Inc.
PSA is a trademark of Printronix, Inc.
Scalable type outlines are licensed from Agfa Corporation. Agfa
is a
registered trademark of Agfa–Gevaert, AG. CG, Garth Graphic, Intellifont,
and Type Director are registered trademarks of Agfa Corporation, and
Shannon and CG Triumvirate are trademarks of Agfa Corporation. CG
Bodoni, CG Century Schoolbook, CG Goudy Old Style, CG Melliza,
Microstyle, CG Omega, and CG Palacio are products of Agfa Corporation.
CG Times, based on Times New Roman under license from The Monotype
Corporation Plc is a product of Agfa Corporation.
Univers is a registered trademark of Linotype AG and/or its subsidiaries.
Letraset is a registered trademark, and Aachen, Revue and University Roman
are trademarks of Esselte Pendaflex Corporation.
Futura is a registered trademark of Fundición Tipográfica Neufville, S.A.
ITC Avant Garde Gothic, ITC Benguiat, ITC Bookman, ITC Century, ITC
Cheltenham, ITC Clearface, ITC Galliard, ITC Korinna, ITC Lubalin Graph,
ITC Souvenir, ITC Tiepolo, ITC Zapf Chancery, and ITC Zapf Dingbats are
registered trademarks of International Typeface Corporation.
Albertus, Gill Sans, and Times New Roman are registered trademarks, and
Monotype Baskerville is a trademark of The Monotype Corporation Plc,
registered in the U.S. Pat. and TM office and elsewhere.
Hiroshige and Marigold are trademarks of AlphaOmega Typography, Inc.
HP is a registered trademark of Hewlett–Packard Company.
This manual explains how to use the IGP/PGL (Intelligent Graphics
Printing/Printronix
with your printer Setup Guide for complete printer–IGP/PGL compatibility.
How to Locate Information
You can locate information three ways:
•Use the Table of Contents at the front of the manual.
•Use the Chapter Contents list on the first page of each chapter.
•Use the alphabetical Index at the back of the manual.
Warnings and Special Information
Information requiring special attention is highlighted under special headings.
Always read and comply with this information. The heading reveals the
nature of the information:
Graphics Language). Use this manual in conjunction
WARNING
WARNING tells you of conditions that could cause you physical harm.
CAUTION
CAUTION tells you of conditions that could damage the printer,
IGP/PGL, or related equipment.
IMPORTANT
IMPORTANT gives you information vital to proper IGP/PGL operation.
NOTE: Provides information affecting IGP/PGL operation considered
important enough to emphasize.
1–2Introduction
Features
IGP/PGL is the Intelligent Graphics Printing firmware for the Printronix
Graphics Language, which is designed for the new Printronix PSA line of
line-matrix, laser and thermal printers. The IGP/PGL provides on–line forms,
bar codes, and many alphanumeric text–generation capabilities and is
compatible with earlier versions of Printronix IGP protocol and
programming. IGP/PGL graphics processing features are detailed below.
NOTE: The ThermaLine Series printers are not floppy disk-based
printers. As a result, reference to disk drive ‘A’ implies the internal
SRAM, disk drive ‘B’ corresponds to the top external memory
module slot, and drive ‘C’ corresponds to the bottom memory
module slot. Note also that drive ‘C‘ does not exist for the T3204
model.
On–Line Form and Label Generation makes it easy to create forms or
labels with a “preprinted” look for each application. IGP/PGL programs
control all graphic functions, dramatically reducing host computer
programming and processing time.
Graphic capabilities include boxes, vertical and horizontal lines with
user–selectable thickness, logos, and special alphanumeric print features.
Forms and graphic designs can be duplicated horizontally and vertically.
Alphanumeric data can appear as prepositioned “fixed” information (entered
when the form is created), can be overlayed onto the form (positioned in a
specific location after the form is created), or may be dynamically merged
with the form.
Selectable Bar Codes provides you with the appropriate bar code for your
application using standard wide–to–narrow ratios. A wide selection of bar
codes are available: Code 39, Interleaved 2 of 5, UPC–A, UPC–E, MSI A
through D, Code 128 Subset B and C, Code 93, EAN 8, EAN 13, POSTNET,
FIM, and PDF–417. UPC and EAN bar codes can also specify add–on data.
Expanded and Compressed Character Print attract attention where
needed. Alphanumeric height and width are controlled independently for a
wide range of character sizes up to 113 times the standard character size (up
to 9.9 inches wide and tall). Compressed print sizes of 10 to 30 characters per
inch (cpi) are available.
1–3Introduction
Rotated Alphanumerics permit new concepts in form design. Normal,
expanded, and compressed character strings can be rotated 90 degrees
clockwise or counterclockwise, or they can be printed upside down.
Logos are easily created using alphanumeric commands and add a variety of
print and shading features for a “customized” appearance to forms, reports,
and labels. You can define the format of the logo using TIFF files and PCX
raster data as well as the standard IGP/PGL dots.
Reversed Print permits highlighting and contrasting by printing white
characters on a dark background.
Automatic Increment/Decrement Capability allows batch form
processing. You can identify individual numeric and bar code data fields,
which includes automatic increment or decrement functions.
The following list summarizes the new features included in the current
release:
•Inline Commands allows commands to appear anywhere within a line.
This enables the FONT command to control text attributes for a text
line. It also permits commands to be packed into a single text line to
maintain line counting when using an IBM system.
•TIFF and PCX Raster Data File Support allowing two of the four
TIFF file formats (uncompressed and packed bits compression formats)
and both of the PCX raster data file formats (compressed and
uncompressed).
•Additional Bar Codes including Code 93, an industrial bar code, and
Codabar, a medical and package tracking bar code.
•Host Control of PSA Resources through PTX SETUP command,
which manages those options that are common between printer
emulations.
1–4Introduction
How the IGP/PGL Operates
IGP/PGL is an emulation that allows you to print sophisticated graphics and
bar codes.
Depending on what the printer is doing, it is always in a particular mode,
which is transparent to the user. These modes are discussed in more detail in
Chapter 2.
When the printer is receiving text or printing text, it is in Normal mode. Any
time the printer is on and is not processing IGP/PGL commands, it is in
Normal mode.
When a Create Form command is issued, the printer moves from the Normal
mode to the Create Form mode.
During this phase, the user sends text, images, and bar code data to the
IGP/PGL. All of this data is stored in memory. An End statement terminates
the IGP/PGL data string. The printer returns to Normal mode.
You can create as many forms as you wish and store them on your host or in
external printer memory.
All forms have filenames. You may want to print the form, label it, and store
it for future reference. Or, you can devise another method for easy retrieval.
These forms can then be downloaded from your host to the printer.
When you Execute a form, you can print it as many times as you wish. This
saves you time from downloading the form each time you want to print it.
1–5Introduction
Printer Operating ModeWhat It Means
Normal Mode
Create Form Mode
Execute Form Mode
Printer receives data
and prints text/graphics.
You send IGP commands
to the printer.
Printer prints the
form designed in
Create Form mode.
Normal Mode
Printer returns
to Normal mode.
Figure 1–1. IPG/PGL Modes
1–6Introduction
Modes of Operation
The IGP/PGL has six modes of operation that use specific command
sequences to control the IGP/PGL.
•In the Normal mode, the printer waits for a Special Function Control
Code (SFCC) in order to perform IGP/PGL functions.
•In Quiet mode all IGP/PGL commands are ignored.
•In the Create Logo and Create Form modes, the printer produces
graphics such as forms, logos, bar codes, and alphanumeric data.
•The Execute mode is the IGP/PGL printing mode, which controls when
the actual printing of the bar codes and graphics will occur.
•The Configuration mode allows you to select specific IGP/PGL
operations for running IGP/PGL files on your printer.
Normal Mode
Normal mode commands print data in a line printer format until a Special
Function Control Character (SFCC) is detected.
Commands accessible in the Normal mode are summarized in Table 1–1 and
fully described on the referenced pages. Some Normal mode commands can
also be used in other modes: Compressed Print, Expand, Ignore, Select
Format, and Vertical Line Spacing, which are Normal mode commands, can
also be used in the Execute Form mode; the Multinational Character Set
command can be used in the Normal or Create modes. Carriage Return, Form
Feed, Line Feed, EVFU commands, and Paper Slew commands also operate
in the Normal mode.
NOTE: All IGP/PGL commands must be entered in UPPERCASE, and each
command line must be followed immediately by a line feed (or
carriage return with line feed terminator) or a paper motion
command.
1–7Introduction
Table 1–1. Normal Mode Commands
CommandMnemonicDescriptionPage #
Compressed PrintDENSITYDefines the horizontal print density in characters per inch (cpi).4–33
ConfigurationCONFIGReconfigures IGP/PGL parameters.4–34
CreateCREATEPlaces
Create LogoLOGOPlaces
Delete FormDELETE FORMDeletes a selected form name from the directory and IGP/PGL memory.4–41
Delete LogoDELETE LOGODeletes a selected logo name from the directory and IGP/PGL memory.4–42
DirectoryDIRECTORYProvides a list of all defined forms and logos, logo assignments to forms, and
ExecuteEXECUTEExecutes a previously created form.4–49
Expanded PrintEXPANDExpands fonts vertically and horizontally.4–60
FontFONTSelects a specific typeface, bold, slant (italic) factor, and symbol set.4–61
Ignore Sequence
On/Off
Line Spacing,
Vertical
ListenLISTENRemoves IGP/PGL from the quiet state and enables IGP/PGL operation.4–71
Multinational
Character Set
Normal ModeNORMALPlaces the IGP/PGL in the Normal mode, where it does not change the data
PaperPAPERSelects features such as paper cutter, print intensity, label sensor, page
Print FilePRINTPrints a file from external memory4–83
QuietQUIETIGP/PGL operation is disabled until a Listen command is received. Any data
ResetRESETDeletes all forms and logos from the IGP/PGL memory.4–85
Select Format
On/Off
Set UpSETUPAutomatically executes and loads the IGP/PGL commands into the printer at
Printer ModePMODEIncluded only for compatibility; not recommended for use.N/A
Scaling ModeSMODEIncluded only for compatibility; not recommended for use.N/A
IGON
IGOFF
LPIDefines the lines per inch (lpi) printing format.4–66
USET
ISET
SFON
SFOFF
the IGP/PGL in the
commands are available to design form elements.
the IGP/PGL in the Create Logo mode, where logos can be defined using
the appropriate dot placements.
memory usage and availability.
Enables the IGP/PGL to ignore all characters after the Ignore Sequence On
command
Page 1–11.
Use
stream but awaits the SFCC followed by an IGP/PGL command.
orientation (portrait/landscape), and print speed.
sent to the LinePrinter Plus Emulation is unaffected by IGP/PGL commands.
Ignores all host–generated paper movement commands. See Note on Page
1–11.
power–up or after a RESET command is sent.
is sent until the Ignore Sequence Of
a multinational character set or create a custom user–defined character set.
Create Form mode where all the Create Form mode
f command is sent. See Note on
4–39
4–74
4–43
4–65
Chapt. 6
4–77
4–79
4–84
4–90
3–2
1–8Introduction
Quiet Mode
In this mode, the host sends all data to the LinePrinter+ emulation without
any IGP/PGL interpretation––the IGP/PGL is disabled and all IGP/PGL
commands are ignored. The IGP/PGL looks only for LISTEN and
PTX_SETUP.
Create Form Mode
Create Form mode commands design forms, all form components, and bar
codes. The forms are not printed in the Create Form mode; forms are printed
in the Execute Form mode after all form design is completed. To begin form
design, access the Create Form mode using the Create command. The Create
command is always used to enter the Create Form mode to begin form
design. Remember that the CREATE command must be entered in
UPPERCASE.
Each element has its own specific set of commands and parameters that
determine size, location, and content. Listed in alphabetical order, Create
Form mode commands are summarized in Table 1–2 and fully described on
the referenced pages.
Print Boundaries
Print area boundaries exist for the paper size selected. All Create Form mode
commands require you to identify the location for the components in your
form. Boundary checking for form elements is performed only when the
form length is specified. This ensures that forms can be created regardless of
the type of paper you have loaded or margins you have set. The IGP/PGL
checks the boundaries before the form is executed to assure that it will fit on
the loaded paper size. If the debug option is used in the Create statement, the
boundaries are checked against the current paper size. Refer to Appendix C
for more information regarding page boundary guidelines.
1–9Introduction
Table 1–2. Create Form Mode Commands
CommandMnemonicDescriptionPage #
AlphanumericsALPHADefines
Alpha,
Incremental
Bar CodesBARCODEEach bar code type has its own command to define size, location,
BoxesBOXDefines size, location, and thickness of boxes.4–30
CornersCORNERDefines vertical and horizontal length, location, and thickness of a set of
Duplication,
Horizontal
Duplication,
Vertical
EndENDTerminates the Create Form mode.4–48
FontFONTSelects a specific typeface, bold, slant (italic) factor, and symbol set.4–61
Form LengthLFORMSpecifies the form length by total number of lines at 6 or 8 lpi.4–64
Ignore Sequence
On/Off
Lines, HorizontalHORZDefines the location, size, and thickness of horizontal lines.4–67
Lines, VerticalVERTDefines the location, size, and thickness of vertical lines.4–69
ALPHADefines starting data and increment amount for fixed auto–increment
HDUPDefines
VDUPDefines the number of vertical duplications of an element and the spacing
IGON
IGOFF
size, location, and content of alphanumeric characters and
alphanumeric data fields.
fields.
orientation, and data as described in the “Bar Codes” chapter.
four corners.
the number of horizontal duplications of an element
between duplications.
between duplications.
Enables
the IGP/PGL to ignore all characters after the Ignore Sequence On
command is sent until the Ignore Sequence Off command is sent.
See Note on Page 1–11.
and the spacing
dynamic
4–12
4–18
Chapter 5
4–36
4–44
4–46
4–65
Logo CallLOGOSpecifies the location of a previously defined logo.4–72
Multinational
Character Set
Page NumberPAGEDefines the location for automatically incremented page numbers.4–78
Printer ModePMODEIncluded only for compatibility; not recommended for use.N/A
ResetRESETDeletes all forms and logos from the IGP/PGL memory.4–85
Reverse PrintREVERSEDefines the location for white–on–black printing and selects the
ScaleSCALEDefines the vertical spacing and horizontal pitch for data positioning in
Scaling ModeSMODEIncluded only for compatibility; not recommended for use.N/A
Select Format
On/Off
ISETSelects one of the 32 Multinational character sets.Chapter 7
4–86
4–88
4–90
SFON
SFOFF
background shade.
character or dot columns and rows.
Ignores all host–generated paper movement commands.
See Note on Page 1–11.
1–10Introduction
Create Logo Mode
The Create Logo mode is used in the Create Form mode. The Create Logo
mode creates a logo design; this predefined logo is then “called” into a form
in the Create Form mode. (The logo must be defined before it is “called.”)
Execute Form Mode
The Execute Form mode prints forms created in the Create Form mode.
Execute Form mode commands are summarized in Table 1–3 and fully
described on the referenced pages. Carriage Return, Form Feed, and Line
Feed commands also operate in the Execute Form mode. Remember that the
EXECUTE Form command must be entered in UPPERCASE, and that a
single line spacing (or a line containing overlay data) must separate an
EXECUTE command from a NORMAL command.
NOTE: Some systems pad the data stream with characters and spaces. If the
IGP/PGL file on your system contains padded characters or spaces
before the SFCC, this data must be ignored before the IGP/PGL can
operate. The Ignore Sequence (IGON/IGPOFF) command,
discussed on page 4–65, is provided for this purpose.
Similarly, at times you may also need the IGP/PGL to ignore
host–originated paper movement commands (carriage return, line
feed, form feed, etc.) in lengthy data streams. Select Format
(SFON/SFOFF) discussed on page 4–90 is provided for this
purpose. In addition, the Quiet command, (page 4–84), can be used
to pass data unchanged to the printer.
1–11Introduction
Table 1–3. Execute Form Mode Commands
CommandMnemonicDescriptionPage No.
Compressed PrintDENSITYDefines the horizontal print density in characters per
Dynamic Alphanumeric
Data
Dynamic Bar Code DataBFnExecutes
Expanded PrintEXPANDExpands fonts vertically and horizontally.4–60
FontFONTSelects a specific typeface, bold, slant (italic) factor,
Ignore Sequence
On/Off
Incremental Alphanumeric
Dynamic Data
Incremental Bar Code
Dynamic Data
Line Spacing, VerticalLPIDefines the lines per inch (lpi) printing format.4–66
Multinational
Character Set
Normal ModeNORMALPlaces
AFnExecutes the dynamic alphanumeric data provided
IGON
IGOFF
IAFnExecutes the incremental dynamic alphanumeric data
IBFnExecutes the incremental dynamic bar code data
ISETSelects one of the 32 multinational character sets.Chapter 7
inch (cpi).
after the (cc) EXECUTE command.
(cc)EXECUTE command.
and symbol set.
Enables
Ignore Sequence On command is sent until the Ignore
Sequence Off command is sent.
See Note on Page 1–11.
provided after the (cc) EXECUTE command.
provided after the (cc)EXECUTE command.
not change the data stream but awaits the SFCC
followed by an IGP/PGL command.
the dynamic bar code data provided after the
the IGP/PGL to ignore all characters after the
the IGP/PGL in the
Normal mode, where it does
4–33
4–54
4–55
4–61
4–65
4–57
4–57
4–77
PaperPAPERSelects features such as paper cutter, print intensity,
ResetRESETDeletes all forms and logos from the IGP/PGL
Select Format
On/Off
SFON
SFOFF
sensor
, page
label
print speed.
memory.
Ignores all host–generated paper movement
commands. See Note on Page 1–11.
orientation (portrait/landscape), and
4–79
4–85
4–90
1–12Introduction
Configuration Mode
Selecting IGP/PGL options for running IGP/PGL files on your printer is
referred to as IGP/PGL configuration. You can select IGP/PGL configuration
parameters by sending commands from the host or by pressing keys on the
control panel.
Chapter 4 describes all the firmware commands.
Chapter 2 shows the control panel menu and describes all of the
configuration parameters. A list of the parameters is shown in Table 1–4.
Table 1–4. IGP/PGL Configuration Mode Options
NOTE:Parameters marked with an asterisk (*) indicate the factory default value.
The printer must be off–line to enter the configuration structure.
OptionParameter
Value
AutoEjectDISABLE *
ENABLE
Auto WrapDISABLE *
ENABLE
Define CR Code
Define LF CodeLF = LF *
CR = CR *
CR = CR + LF
LF = CR + LF
Comments
If
the last page of a job is only 1/2 full (the data does not fill
the entire page), you can instruct the printer to eject the
page
or leave it in the
to eject the last page after the entire page has been
processed and printed. DISABLE instructs the printer to
eject the page only if you send a Page Eject command or
when the printer receives the next print job.
Controls automatic “wrapping” of text to the next line
down when the text exceeds the right margin.
DISABLE truncates text beyond the page margin until a
CR
or CR + LF is received. ENABLE automatically
a CR + LF after a full print line.
If
a proportional spaced font is used, this
and the printer does not wrap text.
When
CR = CR + LF
after each CR received, otherwise data passes through
unchanged.
When
LF = CR + LF
each
line feed is
unchanged.
printer
. ENABLE causes the printer
inserts
option is ignored
, a line feed is automatically
, a CR is
processed, otherwise data passes through
automatically inserted before
inserted
1–13Introduction
Option
Parameter
Value
Comments
Ext Execute CopyDISABLE*
ENABLE
Host Form LengthDISABLE
ENABLE*
Power On IGP/PGLDISABLE
ENABLE*
Select SFCC1 – 255 decimal
126 *
UppercaseDISABLE*
ENABLE
If DISABLED, dynamic data, overlay data, etc. are not
allowed
as part of the Execute command.
If
within a form in which the Form Count parameter is
specified in the Execute command. In this case, the exact
same
whatever
a
DISABLE sets the form length to the value set from the
front
form length defined in the CREATE FORM mode.
DISABLE puts printer in QUIET mode at power–up,
otherwise ENABLE or LISTEN mode is active at
power–up.
Select any ASCII character from Table 1–5 on page 1–16
to set the binary pattern for the selected Special Function
Control Character. Default is decimal 126 (~).
If
if
the optional Form Count parameter is specified
ENABLED,
form (with identical dynamic
separate page.
panel. ENABLE sets the printer page size equal to the
ENABLED,
dynamic data, overlay data, etc. are allowed
data, etc.) is printed for
the Form Count is. Also, each form is printed on
all incoming data is converted to uppercase.
1–14Introduction
Option
Parameter
Value
Comments
Select Font0 *
1
2
3
4
5
6
7
8
9
10
Select LPI1 – 10Any integer value from 1 to 10. Default is 6.
Skip Cmd PrefixDISABLE
ENABLE*
Upc Descenders
DISABLE
ENABLE*
0 = US ASCII 11–23 = Undefined default to ASCII.
1 = German 24–31 = User–defined symbol set
2 = Swedish from the USET command.
3 = Danish
4 = Norwegian
5 = Finnish
6 = English
7 = Dutch
8 = French
9 = Spanish
10 = Italian
DISABLE
if a line feed preceded the command’s SFCC. ENABLE
ignores any text before a valid command.
If
ENABLED, human readable text for UPC and EAN bar
codes is embedded within the bar code.
If DISABLED, the text is printed below the bar code.
prints text before a valid
IGP/PGL command as
1–15Introduction
Table 1–5. ASCII Conversion Table
Binary
ASCIIDecHex
7
Pattern
NUL0 00 0000000
0000001
01
SOH
STX
ETX
EOT
ENQ
ACK
BEL
BS
HT
LF
VT
FF
CR
SO
SI
DLE
DC1
DC2
DC3
DC4
NAK
SYN
ETB
CAN
EM
SUB
ESC
FS
GS
RS
US
Based on the requirements of a specific application, you can use one of three
methods to print alphanumeric data on a form: Fixed data, Overlay data, and
Dynamic data. These methods are described in more detail in the
“Commands” chapter.
•Fixed data prints on each form in the same “prepositioned” location,
unless the location changes in the form definition. Company name,
address, logo, and phone number are typical examples of alphanumeric
data that can be “fixed” onto the form.
•Overlay data is variable alphanumeric data positioned on the page with
line feeds and spaces to fit into exact locations. For example, specific
data can be “overlayed” onto a blank form as if you were typing data
into the appropriate blanks on a preprinted form. Customer names,
addresses, and order numbers are examples of data overlayed onto a
form.
•Dynamic data is variable data entered into specific locations on each
form. Each time the form prints, a command enters new data in those
locations. Customer names, addresses, or any type of variable
alphanumeric or bar code data can be provided dynamically.
Incremental Data
The incremental data feature allows you to update alphanumeric and bar
code data fields in an alphabetical or numeric manner automatically with just
one set of data sent from the host computer.
Alphanumeric and bar code incremental fields can be used with fixed (static)
data input as part of the Create Form mode or with dynamic data supplied in
the Execute Form mode.
The incremental fields can be increased or decreased, repeated at specified
intervals before updating, and reset to the starting value after a specified
number of increments.
1–17Introduction
1–18Introduction
2
Chapter Contents
Configuration
Configuring the IPG/PGL with the Control Panel2–2. . . . . . . . . . .
Matching certain printer operational settings to those of the host computer is
known as “printer configuration.” The settings, or configuration parameters,
such as selecting the host interface, are adjusted according to the printer
function key descriptions in your printer’s user manual. Configure the
IGP/PGL in the same way you would configure the printer for other features.
You can select IGP/PGL default parameters directly from the control panel
as explained in this chapter, or by control codes as explained in the
“Commands” chapter.
The IGP/PGL parameters are described on page 2–4 and the following
pages. Parameters marked with an asterisk (*) indicate the default value. The
printer must be off–line to enter the configuration structure.
Enter and exit the IGP/PGL configuration menu according to your printer
user manual configuration procedures. Pressing an invalid key to enter a
parameter value may move you to another level in the configuration or exit
the configuration menu completely.
IMPORTANT
BEFORE you reconfigure the IGP/PGL, print a configuration sheet to
see all of the current settings. Refer to your printer user manual.
Configure the IGP/PGL according to your specific requirements. Please note
the differences associated with the following options.
•Left Margin Sign. The Left Margin Sign option no longer exists in the
IGP/PGL configuration menu. To establish a signed left margin and a
top/bottom margin, access the option from the LP+ configuration menu.
•Overstrike Data. Thermal printing uses a bold font to emphasize
overstrike data (e.g., data <carriage return> data <cr/lf> would
overstrike “data” so that it would be bolded.)
The IGP/PGL sub–menu is shown on the following page.
2–2
Configuration
The IGP/PGL Emulation Submenu
Emulation
IGP/PGL
Define CR
Code
CR = CR*
CR = CR + LF
Select
Font
0–31
0*
Define LF
Code
LF = LF*
LF = CR + LF
Autoeject
Disble*
Enable
Autowrap
Disable*
Enable
Select
LPI
1–10
6*
Select
SFCC
1–255
126*
Auto
Uppercase
Disable*
Enable
Skip Cmd
Prefix
Enable*
Disable
Power On
IGP/PGL
Enable*
Disable
Ext Execute
Copy
Disable*
Enable
Configuration
UPC
Descenders
Enable*
Disable
Host Form
Length
Disable*
Enable
IGP100
Compatibilty
Disable*
Enable
Figure 2–1. The Configuration Menu
2–3
Define CR Code (Carriage Return)
This parameter forces the printer to insert an automatic Line Feed code into
the data stream whenever a Carriage Return code occurs. This is to be used
only if the host computer does not send Line Feeds to the printer.
•CR = CR. The default. Does NOT perform a line feed. The next print
position will be print position 1 of the current line.
•CR = CR + LF. Performs an automatic line feed. The next print
position will be print position 1 of the next line.
Define LF Code (Line Feed)
This parameter forces the printer to insert an automatic Carriage Return code
into the data stream whenever a Line Feed code occurs. This can be used in
most installations, but it is required if the host computer does not send
Carriage Returns to the printer.
•LF = LF. The default. Does not perform an automatic carriage return.
The next print position will be the current print position of the next line.
•LF = CR + LF. Performs an automatic carriage return. The next print
position will be print position 1 of the next line.
Autowrap
This parameter determines if text will wrap to the next line when the line of
text exceeds the right margin.
•Disable. The default. Truncates the text beyond the right margin until a
CR or CR+LF is received.
•Enable. Automatically inserts a CR+LF after a full print line.
Select SFCC
You can specify which decimal code (1–255) will be used as the Special
Function Control Character (SFCC). The factory default setting is 126 (~).
The SFCC denotes that the following data is an IGP/PGL command.
2–4
Configuration
Select Font
This parameter allows you to select a font for the IGP/PGL feature. The
default is 0, which is U.S. ASCII. The following values are valid choices:
Values 11–23 are undefined and will default to 0. You can set values 24–31
to specific fonts; refer to the USET command.
Auto Eject
If the last page of a job is not full, that is, the data does not fill the entire
page, you can instruct the printer to eject the page or to stop and hold the
page at the last print position.
Enable. The printer ejects the last page after the entire job has been
processed and printed.
Disable. The default. The printer does not eject the last page unless you send
a Page Eject command or until the printer receives another print job.
Select LPI
This is the number of lines to be printed per inch. For example, at 6 lpi there
is 1/6–inch from the top of one print line to the top of the next print line.
Default is 6 lpi.
Configuration
2–5
Auto Uppercase
This parameter enables the printer to print text in all uppercase.
Disable. The default. The printer will print text in upper- and lowercase.
Enable. The printer will print text in uppercase only.
Skip Command Prefix
This parameter determines if a data string before an IGP/PGL command will
be ignored.
Disable. The printer will print any data before an IGP/PGL command.
Enable. The default. The printer ignores all text before an IGP/PGL
command.
Power On IGP/PGL
You can set the IGP/PGL feature so that it is enabled or disabled when the
printer is powered on.
Disable. The IGP/PGL is disabled when the printer is powered on. (The
IGP/PGL feature is initialized to the Quiet mode.)
Enable. The default. The IGP/PGL is enabled when the printer is powered
on. (The IGP/PGL feature is initialized in the Normal mode.)
Extended Execute Copy
Disable. The default. Dynamic data, overlay data, etc. are not allowed if the
optional Form Count parameter (number of forms to print) is specified as
part of the Execute command. (This setting is IGP
Enable. Dynamic data, overlay data, etc. are allowed within a form in which
the Form Count parameter is specified in the Execute command. In this case,
the exact same form (with identical dynamic data, etc.) is printed for
whatever the Form Count is. However, incremental data is not incremented
since the page that is printing is exactly the same. Also, each form is printed
on a separate page.
100 compatible.)
2–6
Configuration
UPC Descenders
This parameter allows you to leave a gap for human readable data in the
UPC/EAN bar codes.
Disable. The IGP/PGL does not leave a gap if there is no human readable
data.
Enable. The default. The IGP/PGL leaves a gap, even if there is no human
readable data.
Host Form Length
This parameter determines which page length setting (the one specified in
the Create Form mode or the one set on the printer) will be used when you
send an Execute (print) command.
Enable. The page length set in the Create Form mode is used. This is the
default.
Disable. The page length set on the printer will be used.
IGP100 Compatibility
This parameter is used to make PGL compatible to the original IGP100 in
cases such as exact positioning of text, etc.
Disable. Does not change PGL behavior. This is the default value.
Enable. Makes PGL behavior compatible to that of IGP
This cc is NOT the PGL SFCC. It is the “setup” SFCC
and is set under the Maint/Misc configuration menu.
PTX_SETUPThe trigger command. Must appear in capital letters.
Once the trigger is detected, all unprintable characters
and spaces (i.e., characters less than 21 hex) are
ignored.
<category – >This selects which category or type of command is
being entered: CONFIG, DISK_IO, ENGINE,
FORMAT or TEST_CHK. All categories must appear
in capital letters and must be followed by a dash (–).
<parameter;value:> Parameter and value pair for the current category. See
the listing of categories, valid parameters and ranges of
values beginning on page 3–4. The parameter and
value must be separated by a semicolon (;) and must
be terminated by either a colon (:) or a period (.).
The colon signifies that more parameter/value pairs for
the current category are to follow; therefore, more than
one parameter/value pair may be given for the current
category. The period denotes the end of parameter/
value pairs for the given category.
Parameter/value pairs must not exceed 25 characters
with the semicolon and terminator included.
3–2PTX_Setup
PTX_ENDThe end command for the PTX_SETUP. When the
PTX_END command is detected, any unprintable
characters following it will be ignored. Therefore, the
next printable character from the host will be sent to
the active emulation.
CommentsThe PTX_Setup feature will only manage those options that are common
between printer emulations. Each emulation is responsible for providing
host commands to set emulation–specific options. If input data is invalid or
causes an error, the PTX_Setup parsing is terminated and the next character
is passed to the active emulation.
PTX_Setup3–3
PTX_Setup Command Parameters and Values
The valid SETUP parameters and value ranges are listed below according to
category.
DISK_IO
Valid parameter/values for performing disk–related functions are listed
below. Filenames must follow the MS–DOS standard and be enclosed in
double quotation marks; for example, “a:filename.dat”.
An invalid filename will cause the PTX_SETUP function to exit and data
will be passed directly to the active emulation.
CAPTURE;“<filename>”
Stores the host data sent to the printer external memory module under the
given filename enclosed in double quotation marks before being given to the
emulation.
If the file previously existed, it is deleted and overwritten. Data capture is
terminated when the CAPTURE setup command is sent with a blank file
name (i.e., CAPTURE;“”. or CAPTURE;“”:).
NOTE: File capturing begins after the PTX_END is encountered and stops
when the next PTX–SETUP is received. Commands within
PTX_SETUP cannot be captured. Also, if no suffix is given, the
default of “.PTX” is assumed.
RUNFILE;“<filename>”
Reads the contents of the named file enclosed in double quotation marks and
passes the data as input to the active emulation. If the file is not found, no
action is taken.
DRIVE;“<char>”
Changes the drive used in capturing and running file data when the drive is
not explicitly given by the user. The power–up default drive is drive A. Enter
‘B’ to change the default to drive B.
3–4PTX_Setup
DEL;“<filename>”
Deletes the given file enclosed in double quotation marks from the printer
external memory. If the file is not found, no action is taken.
FONT;“[drive]<font number>”
Allows downloading of HP LaserJet II bitmap fonts into a memory module.
The syntax is as follows:
Note that when using the FONT command, it should be the only command
on the line (i.e., multiple DISK_IO commands should not be used along
with the FONT command on the same line). The <Font Data> follows
immediately after the command.
All data following the FONT command will be interpreted and stored as a
font on the proper module. The font will be stored on the drive specified in
the command, if it was included; otherwise, it will use the default drive. The
font number can be in the range of 1–99. The same font number should be
used when the font is activated (using the font command).
ENGINE
The following list contains the valid parameter/values for controlling the
print engine and setting the Paper Control menu options. Some parameters or
values are not available or do not apply to all engines. (Consult the engine
manual for specific ENGINE options.)
If a valid parameter is given but does not apply to the current engine, then it
is ignored. If a valid value is outside the available range for the current
engine, then the option will be set with the closest available value for that
engine.
ALM_WIDE;#
Defines the Automatic Label Mapping (ALM) wide–web width in 1/1000ths
of an inch increments from 0–65535.
PTX_Setup3–5
ALM_NARROW;#
Defines the Automatic Label Mapping narrow–web width in
1/1000ths–of–an–inch increments from 0–65535.
ALM_ENABLE;<value>
Enables or disables the ALM. The value ‘N’ or ’W’ enables the ALM. A
“D” disables the ALM. An ‘N’ defines a page as “narrow.” A ‘W’ defines a
page as “wide.”
IMAGE_SHFT_H;#
Defines the horizontal image shift in 1/1000ths–of–an–inch increments from
(–1000)–(1000).
IMAGE_SHFT_V;#
Defines the vertical image shift in 1/1000ths–of–an–inch increments from
(–1000)–(1000).
LENGTH;#
Defines the page length in 1/1000ths–of–an–inch increments. The range of
values is dependent upon the printer. (Refer to the Setup Guide for your
printer.)
REWIND;#
Enables or disables the rewind function. A zero value disables rewind and a
‘1’ value enables the rewinder.
WIDTH;#
Defines the page width in 1/1000ths–of–an–inch increments. The range of
values is dependent upon the printer. (See the printer manual.)
IGP/PGL commands have many options and a specific format that you must
follow to obtain the desired results. Certain elements are standard for all
IGP/PGL commands. These command standards are described in the
following sections. Familiarize yourself with the meaning and use of these
standards before operating the IGP/PGL.
Special Function Control Character (SFCC)
The SFCC identifies a command directed to the IGP/PGL to enable a specific
IGP/PGL function. Based on the host computer interface requirements,
various characters can be selected as the SFCC, such as the hat (^) or a tilde
(~). Use caution and be certain it is compatible with your host system, if you
use a nonprintable character as your SFCC. The SFCC must be placed before
a command or data is entered. The examples in this manual use the tilde as
the SFCC; always substitute the actual SFCC required by your system
wherever the tilde is shown. In the general command formats, the SFCC is
represented by (cc).
You can select the SFCC using the CONFIG command (page 4–34) or the
control panel (page 2–4).
Semicolon (;)
Each parameter (alpha data, options, etc) on the command line is separated
by a semicolon. Blank spaces between the semicolon and the next parameter
are not allowed. A missing or misplaced semicolon causes an error message.
Uppercase
The IGP/PGL is “case sensitive.” ALL commands must be entered in
uppercase.
Inline Commands
The SFCC, usually a “~”, was required to be the first character on a new line.
It may now appear anywhere on the command line.
4–3Commands
There is a configuration option that determines whether any data preceding a
command is printed or ignored.
All PGL commands begin with the Special Function Control Character
(SFCC). When the command is not followed by a valid line terminator, it
must also end with the SFCC. Any illegal command or non–terminated
command will print as text.
These features, when used in combination with the new dynamic data rule,
are useful for those whose systems count the number of lines printed and
automatically issue a form feed. Now, the line count can be maintained by
combining overlay data and commands in a single print line. For example:
Normal text ~FONT;BOLD ON~Bold text~FONT;BOLD OFF;SLANT
1~Slanted text~EXPAND;2:2~~FONT;SLANT 0~ Enlarged upright text
would yield:
Normal text Bold text Slanted text Enlarged
Upright Text
Line Terminator
Each command line must be terminated by a line feed (or a carriage return
with a line feed), or a paper motion command. When an inline command is
not followed by a valid line terminator, it must also end with the SFCC. The
command line will not be accepted if not properly terminated. Refer to your
system operator’s manual for your system keyboard and your printer
configuration codes to determine which key(s) (such as ENTER, LINE
FEED, RETURN, etc.) perform a line feed, carriage return with line feed, or
form feed function.
Printable Character
To print, alphanumeric and bar code data must be enclosed by a printable
character (a delimiter). This delimiter is represented by (D) in the command
format. In this manual, an asterisk (*) is used in most examples as the
printable character. (The parentheses are not entered.) Any printable
character can be used as this delimiter except a slash (/) or the SFCC.
Commands4–4
The same printable character must be used at both the beginning and end of
the text to be printed and cannot be used within the text.
Spaces
Spaces are used in the general command formats to visually separate
individual command parameters. Supply the appropriate information for the
command parameter, but do not enter the spaces in the command sequence;
they are shown simply as a visual aid to illustrate where one command
parameter ends and another begins.
Command Parameters
Most commands include a number of parameters. Some are optional, and
some are required. Each parameter must be separated by a semicolon (;)
unless noted otherwise. Throughout this manual, actual commands required
for input are shown exactly as they must be entered and all parameters
associated with that command are shown in italics. Optional parameters are
enclosed in brackets [ ], but do not enter the brackets.
Parentheses indicate variable data. You have a choice of what to enter, but
you must enter something. Do not enter the parentheses themselves.
Form Name
You must use alphanumeric characters to identify the document (form or
logo) you are creating (a maximum of 12 alphanumeric characters). The
Form Name is also used to identify the form during the Execute Form mode.
The valid Form Name characters are listed below and also apply to Logo
Name. The SFCC can also be used in the Form Name. No spaces are allowed
between any of the Form Name characters.
A to Z (upper and lowercase) Left and right parentheses ( )
0 to 9Tilde ~
Dollar sign $Single quotes ‘ ’
Percent sign %Exclamation point !
Dash –Pound sign #
At sign @Ampersand &
Left and right braces { }
4–5Commands
Prompt
The prompt is the symbol (e.g., a dollar sign, period or greater than symbol)
used to indicate that the host computer is ready for data input. In this manual,
the prompt is shown as a period (.).
Numeric Values
In this manual, a lowercase n in the command represents a numeric value. If
a command parameter includes a lowercase n, it must be substituted with an
appropriate numeric value. If the lowercase n is part of an optional parameter
and the option is not selected, a value for n is not required.
Comments in Command Lines
To aid in preparation or maintenance of a form or logo, comments can be
added to many command lines. Comments must be preceded by a slash (/).
However, do not use the /comment feature on lines containing an SFCC (i.e.,
CREATE, NORMAL, EXECUTE, etc.). Throughout this manual, comments
are provided in parenthesis beside most command lines for better
understanding of IGP/PGL operation but should not be included in your
IGP/PGL files.
Storing Data
To send data to the IGP/PGL, use a host system command, such as PRINT.
(Entering data through the keyboard does not store data in nonvolatile
IGP/PGL memory.) Once stored in memory, the data remains until deleted,
the IGP/PGL is reset with RESET command, or until the printer is turned off.
IGP/PGL files can be permanently stored to, deleted from, and retrieved
from the printer external memory modules by ending CREATE, CREATE
LOGO, DELETE FORM, DELETE LOGO, EXECUTE, and DIRECTORY
commands with ;DISK.
For example, the following command creates a form named ORDER and
stores it in the IGP/PGL printer external memory.
(cc)CREATE;ORDER;DISK
Commands4–6
NOTE: Executing a form or calling a logo will access the default printer
memory module automatically if the object is not found in memory.
Uncompressed and Packed Bits Compression
PGL logos support uncompressed and packed bits compression methods.
CCITT and LZR (used for color) compression methods are not supported.
Refer to your application’s documentation about TIFF files.
Character Position.Dot Position (CP.DP) Format
The CP.DP format is a special parameter available with the IGP/PGL
commands. CP.DP format allows two elements plotted at nearly the same
character location to be offset to eliminate overlapping. Specifying starting
and ending rows and columns is its most frequent use.
Each character location is a cell. Each cell is a grid 12 dot rows high by 6 dot
columns wide (printing at 6 lpi and 10 cpi). The CP.DP format allows a
character cell position (CP) and a specific dot position (DP) within the cell to
be identified as shown in Figure 4–1. The DP portion of the CP.DP format
specifies a location down (in reference to rows) and to the right (in reference
to columns) within the character cell position.
For example, refer to Figure 4–1. Suppose a line runs along character
position column 13 (CP = 13). At the same time, an alphanumeric string
must begin in column 13. With CP.DP format, the alphanumeric string can be
offset 2 dot positions (DP = 2) in column 13 to avoid overlap. Specify 13.2
(CP = 13, DP= .2) for the starting column of the alphanumeric string.
Similarly, to place a horizontal line 8 dot rows beneath another horizontal
line in character row position 11, specify row 11 for one line and row 11.8
for the other line.
4–7Commands
11.012.0
15.013.0 14.0
10.9
12.5
12.4
13.0
13.1
13.2
13.3
13.4
13.5
14.1
14.0
10.0
11.0
12.0
13.0
10.10
10.11
11.0
11.1
11.2
11.3
11.4
11.5
11.6
11.7
11.8
11.9
11.10
11.11
12.0
Figure 4–1. CP.DP Format Example
Commands4–8
Data Fields for Alphanumeric and Incremental Data
Based upon the requirements of a specific application, three methods are
used to print alphanumeric data on the form: fixed (or prepositioned) data,
overlay data, and dynamic data.
Fixed Data
Fixed data is entered during the Create Form mode as part of the form
definition. It appears as prepositioned information similar to other form
elements. The fixed data is printed on each form in the same location and can
only be changed by changing the form definition. Your company’s name,
address, logo, or phone number are typical examples of alphanumeric data
that can be fixed onto the form.
Overlay Data
Overlay data is variable alphanumeric data entered during the Execute Form
mode by positioning the information with line feeds and spaces into an exact
location. In general, a page of data is overlayed onto a form similar to typing
data in the appropriate blanks of a preprinted form. Each page of overlay data
is separated by form feeds to correspond to each form printed. Customer
names, addresses, and order numbers are examples of variable data that can
be overlayed onto the form.
Dynamic Data
Dynamic data is variable data entered by command during the Execute Form
mode. The dynamic data is entered into a location previously defined in the
Create Form mode. Up to 255 locations can be identified during the Create
Form mode as part of the form definition.
A command during the Execute Form mode enters new data in the identified
location(s) each time the form prints. Dynamic data is the most efficient
method of supplying variable data to the form. Again, customer names,
addresses, or any type of variable alphanumeric or bar code data can be
provided dynamically.
4–9Commands
Incremental Data Fields
The incremental data fields feature allows alphanumeric (and bar code) data
fields to automatically update numerically or alphabetically with just one set
of data sent from the host computer. A maximum of 65,535 forms can print
with incremental fields automatically updated.
Alphanumeric incremental fields can be used with fixed (static) data input as
part of the Create Form mode or with dynamic data supplied in the Execute
Form mode. Incremental data fields cannot be used with Overlay data.
Dark Printing
A DARK parameter, available in the Alpha, Reverse, and Bar Code
commands, is a double–strike feature which produces bolder, darker text,
denser black backgrounds for reverse print, and extra–dark, more readable
bar codes. The application of the dark feature differs between line-matrix and
thermal printers, as described in the following paragraphs.
Thermal Printers
Reverse and Bar Code commands automatically print in the DARK mode in
thermal printers; therefore, a DARK parameter in the command line is
ignored. However, a DARK parameter used with alphanumeric text in the
ALPHA command will print using a bold font. In any event, print speed is
not reduced when using the DARK parameter with thermal printers.
Line-Matrix Printers
The extra darkness provided by the DARK parameter improves the Print
Contrast Ratio (PCR) and effectively extends the life of the ribbon. For bar
codes, the PCR describes the difference in light reflection between the bars
and spaces as a measurement of light/dark contrast in order to judge when a
printed bar code will not be dark enough to be read with accuracy by a
scanner.
The extra dots used to produce the darker bar code do not change the overall
width of the wide bars. Figure 4–2 illustrates how the DARK parameter adds
two extra dot columns to wide bar code bars without increasing bar width.
Commands4–10
Because of the second hammer bank stroke required to plot the extra
columns of dots, print speed may be reduced up to half when the DARK
parameter is used with Bar Code commands. However, this decreased print
speed should be weighed against the significant increase in bar code PCR
and extended ribbon life.
ADDED COLUMNS OF DOTS
NORMAL MODE
DARK MODE
Figure 4–2. Dark Printing
NOTE: Depending on the printer used, the printed appearance and location
of your print samples may vary from to those shown in this manual.
The position of your print samples may also vary compared to these
examples, depending on the initial print position.
4–11Commands
Alphanumerics
PurposeDefines and positions alphanumeric data on a form as a “preprinted” static
NOTE:The D parameter, used in earlier line-matrix IGP/PGL versions, is ignored
in thermal IGP/PGL. In addition, the L parameter, also used in earlier
IGP/PGL versions to specify a long reverse field for descending characters
in dynamic alphanumeric data, is provided automatically in this IGP/PGL.
The IGP/PGL will ignore these parameters if found in a command line.
EThe optional elongated character parameter. Enter E to
specify elongated character printing. Elongated
characters are double height and single width. If used,
the VE and HE parameters must be set to 0, or an error
message will result. Elongated character printing is
also available with rotated alphanumerics.
CnThe optional horizontal compression parameter. Enter
C. Then enter n = 10-30 to specify the number of
horizontal characters per inch (cpi). 10 cpi is the
default value. 10A = 10 cpi OCR–A. 10B = 10 cpi
OCR–B. If used, the VE and HE parameters must be
set to 0, or an error message will result.
Commands4–12
AFn;LThe optional dynamic data field parameters for
identifying the alphanumeric string location on a form
and for designating the length of the alphanumeric
string. If these parameters are used, the actual text
cannot be entered during the Create Form mode; it
must be entered dynamically during the Execute Form
mode. Dynamically entering data during the Execute
Form mode permits changes to the alphanumeric text
without redefining or re–creating the form. To use this
field, perform the following steps:
a.Enter AF.
b. Replace n with a number ranging from 1 to 255
to identify the alphanumeric string location on
the form. The SR and SC parameters are used to
specify the exact location of the alphanumeric
field identified by n.
c.Replace L with a number equal to the number of
characters in the dynamic alphanumeric string
ranging from 1 to 255.
d. Dynamically enter the alphanumeric string itself
in the Execute Form mode. The length of the
alphanumeric string must be equal to or less than
the value assigned to the length (L) parameter.
Refer to “Execute Form: Dynamic
Alphanumeric Data” on page 4–54.
e.If the dynamic data field is used, do not enter the
ASCII TEXT parameter.
DIROptional parameter for rotating a character string. Use
the following codes to indicate the direction of
character rotation:
a.Enter CW for 90 degree clockwise rotation.
b. Enter CCW for 90 degree counterclockwise
rotation.
c.Enter INV for inverted characters (180 degree
rotation).
4–13Commands
The default orientation prints character strings in the
standard horizontal format.
NOTE:Alpha rotation parameters (CW, CCW, INV) require more memory to
implement than the default orientation. Thus, characters selected for
rotation may appear in the default orientation. Selecting a smaller font will
correct the problem.
UCEnter UC to specify uppercase–only characters. When
uppercase–only is specified, all lowercase alpha
character codes are converted automatically to
uppercase. Consequently, do not specify
uppercase–only characters if lowercase characters are
required.
POINTOptional parameter that changes the units for the
vertical and horizontal expansion values. When the
point parameter is present the VE value defines the
font height in 1/72 of an inch (i.e. points). If the HE
value is non–zero, it defines the character width in 1/72
of an inch, otherwise the character width is the
standard width for the chosen height. Cannot be used
with elongated (E) and compressed (Cn) parameters.
SRDefines the starting row of the alphanumeric data.
Enter a value ranging from row 1 through one less than
the length of the form. Character row or dot row is
specified based on the Scale command (page 4–88), or
use the CP.DP format (page 4–7).
SCDefines the starting column of the alphanumeric data.
Enter a value ranging from column 1 through one less
than the width of the form. Character column or dot
column is specified based on the Scale command (page
4–88), or use the CP.DP format (page 4–7).
VEDefines the vertical expansion factor to enlarge
characters vertically. Enter a value between 0 and 139.
Zero specifies the standard font (no expansion). A VE
value must be entered. Elongated (E) and compressed
(Cn) characters cannot be used with a vertical
expansion other than zero.
Commands4–14
HEDefines the horizontal expansion factor to enlarge
characters horizontally. Enter a value between 0 and
139. Zero specifies the standard font (no expansion).
An HE value must be entered. Elongated (E) and
compressed (Cn) characters cannot be used with a
horizontal expansion other than zero.
(D)The printable character (quotation marks for example)
identifying the start and finish of the alphanumeric
string. Enter any printable character other than a slash
(/), the SFCC, or a character used within the
alphanumeric string itself. You must use the same
character at both ends of the alphanumeric string, but it
will not print with the data.
textThe group of ASCII characters (the alphanumeric
string) to print. Enter any of the standard ASCII
printable characters (except the character used to
delimit the string in the D parameter). The data appears
as “prepositioned” information on the form beginning
at the location specified by SR and SC. This is the
“fixed” or static alphanumeric data; once defined on
the form, it is changed only by redefining the form
using the Alphanumerics command.
STOPStop indicates the end of the Alphanumeric command;
enter STOP, and the IGP/PGL will wait for a new
command. If not entered, the IGP/PGL will wait for
another set of Alphanumeric command parameters.
CommentsAs dynamic data, the location of the alphanumeric field is established in the
Create Form mode and the actual alphanumeric data is continuously
redefined before placement on the form in the Execute Form mode. You
can also rotate and reverse print the alphanumeric string using this
command.
ExampleThe following program and example in Figure 4–3 illustrates the
Alphanumeric command capabilities. To illustrate positioning, starting row
and column are indicated on the example but do not necessarily reflect
actual location on the page.
4–15Commands
Notice the same starting row is used for all “EXAMPLE” characters, and
they are all aligned on the same baseline (or bottom), regardless of
expanded or compressed parameters. The string rotates around the point of
intersection of the starting row and columns shown by the “pinwheel” E. A
rotated 10 cpi character establishes the baseline for all character sizes.
PurposeThe incremental fields feature updates alphanumeric (and bar code) data
fields in a numeric or alphabetical manner automatically using just one set
of data sent from the host computer. Incremental alphanumeric data fields
can be applied to fixed (static) data (page 4–22), or dynamic data (page
4–25).
ModeCREATE (for fixed data) or EXECUTE (for dynamic data)
NOTE:Throughout the discussion of incremental fields, the term “increment” or
“incremental” means the field is automatically updated by a specified
amount (or increment). The field can actually be increased/decreased in
specified increments/decrements within the command.
CommentsIncremental fields can increase or decrease, repeat at specified intervals
before updating, and reset to the starting value after a specified number of
increments. A maximum of 65,535 fields can print.
Using Incremental Alphanumeric Data
The IGP/PGL internally counts incremental static (fixed) alphanumeric
fields. A maximum of 255 incremental fixed alphanumeric fields are allowed
per form.
Incrementing is controlled with the STEPMASK and STARTDATA
command parameters as described in Table 4–1. The parameters are part of
the Incremental Alphanumeric Fixed Data command or part of the Execute
command when using incremental alphanumeric dynamic data.
The STEPMASK parameter performs the following three functions:
1.It defines the increment amount (step);
2.It defines the number of characters allowed in the data field
(STARTDATA); and
3.It provides a “mask” to link or unlink subfields of the data to be
incremented independently. The data provided in the STEPMASK field
combined with the data in the STARTDATA field determine the result of
these functions.
Commands4–18
The increment amount is defined by the numeric value of the STEPMASK
data. For example, a STEPMASK value of 1 increments the STARTDATA
by 1; a STEPMASK value of 2 increments the STARTDATA by 2.
The maximum number of characters allowed in the STARTDATA field is
defined by the number of characters in the STEPMASK field; the
STARTDATA field cannot contain more characters than used in the
STEPMASK field.
Linked and unlinked masking of subfields within the STARTDATA is
defined by the L value in the STEPMASK field. L indicates linked but
non–incremental data in the corresponding position of the STARTDATA
field; any alpha character other than L in the STEPMASK field indicates a
non–incremental, non–linked STARTDATA subfield.
Table 4–1. Increment Alphanumeric
STEPMASKSTART
0 – 9A – ZAlpha characters incremented by amount
0 – 90 – 9Numeric characters incremented by
0 – 9SpaceSame character type as character in the
0 – 9Not A – Z or 0 – 9Error
Not 0 – 9 or LAnyNon–incrementing alphanumeric
LAnyLinked, non–incrementing alphanumeric
DA
TA
Character T
in STEPMASK field
amount in STEPMASK field
next right adjacent, linked increment position. Character type will be numeric if in
least significant position.
character
character
ype and Function
The examples on the following pages illustrate incremental alphanumeric
data fields. All cases in the examples use a repeat count parameter value of 1
and a reset count parameter value of 0. The three vertical dots illustrate the
natural progression for each column and unit of data based on the
incremental count and its impact on linked and unlinked data fields.
4–19Commands
Value
Description
STARTDATA:
STEPMASK:
Printed Results:ABC123
STARTDATA:
STEPMASK:
Printed Results:1ABC123
ABC123
000001
ABC124
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
ABC999
ABD000
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
ZZZ999
AAA000
Value
1ABC123
0LLL001
1ABC124
.
.
.
.
.
.
.
.
.
1ABC999
2ABC000
Linked subfields:
RPT = 1
RST = 0
Description
T
wo separate but linked numeric
subfields: 1 and 123, while
fixed data
RPT = 1
RST = 0
.
.
.
ABC and 123
ABC is nonincr
ementing
Value
STARTDATA:
STEPMASK:
Printed Results:ABC123
ABC123
001XX1
ABD124
.
.
.
ABI129
ABJ120
Description
T
wo separate unlinked
subfields:
while fixed data 1 and 2 is
nonincrementing
RPT = 1
RST = 0
.
.
.
ABC and 3,
Commands4–20
Value
Description
STARTDATA:
STEPMASK:
Printed Results:___1
STARTDATA:
STEPMASK:
Printed Results:_AA98
STARTDATA:
STEPMASK:
Printed Results:_42AR
___1
0001
___2
.
.
.
.
.
.
.
.
.
__10
Value
_AA98
0LL01
.
.
.
1AA00
Value
_42ART
0LL01
_42AS
.
.
.
.
.
.
_42ZZ
A42AA
Single numeric field with
leading spaces (_)
RPT = 1
RST = 0
.
.
.
Description
T
wo separate but linked numeric
subfields:
space (_); fixed data AA
nonincrementing
RPT = 1
.
.
.
.
.
.
RST = 0
wo separate but linked alpha
subfields:
space (_); fixed data 42 is
nonincrementing
RPT = 1
RST = 0
AA and 98, with leading
is
Description
A and R, with leading
Value
STARTDATA:
STEPMASK:
Printed Results: 9AA02
9AA02
–XXX01
9AA01
9AA00
9AA99
.
.
9AA03
Description
Single numeric field decr
by 1, while fixed data 9 and AA
e nonincr
ar
RPT = 1
RST = 0
STEP = –1
.
.
ementing
emented
4–21Commands
Alphanumerics, Incremental: Fixed Data Fields
PurposeTo automatically increment/decrement fixed alphanumeric data fields.
ModeCREATE
NOTE:In the command format below, incremental alphanumeric command
parameters are shown in boldface type; standard alphanumeric command
parameters and optional nonincremental parameters are shown in italics.
Due to space constraints, the command parameters are separated into two
lines. During actual IGP/PGL input, DO NOT separate command
parameters.
idirThe optional increment direction parameter to specify
an increment (add) or decrement (subtract) to the data.
Enter a plus sign (+) or leave the field blank to
increment (the default). Enter a minus sign (–) to
decrement.
STEPMASKDefines the increment amount (step), the number of
character positions in the data field, and provides a
mask to control the increment function on specific
parts of the data. Enter STEPMASK, and enter the
appropriate value. Refer to Table 4–1 on page 4–19 for
complete information on STEPMASK parameter
values.
RPTnThe optional incremental repeat count parameter to
specify the number of times a particular field value is
repeated before it is incremented. A repeated field
value is useful when printing multiple rows/columns of
identical labels before increasing to the next value.
Commands4–22
To use the repeat count parameter, enter RPT and
replace n with a numeric value ranging from 1 to
65,535 to specify the repeat count. The default repeat
count parameter is 1, which will increment the field
value each time it prints.
RSTnThe optional incremental reset count parameter to
specify the number of times an incremented field is
printed (on one or more forms) before it is reset to the
starting value. A reset count is useful when printing a
hierarchy of fields where a low–level field generates a
sequence of numbers, is reset, and the next higher field
level is incremented (such as in a unit/box/carton
application).
To use the reset count parameter, enter RST and
replace n with a number ranging from 1 to 65,535 to
specify the reset count. The default reset count value
is 0.
STARTDATADefines the starting value of the incrementing field.
Enter STARTDATA and the appropriate value. Refer
to “Using Incremental Alphanumeric Data” on page
4–18 for complete information on STARTDATA and
STEPMASK parameter values.
The maximum amount of STARTDATA characters
must be equal to or less than the number of characters
in the STEPMASK field. If the number of data
characters is less than the number used in
STEPMASK, the data will print right justified with
preceding spaces.
Characters allowed for incrementing fields
(STEPMASK values of 0 – 9) are numeric 0 – 9 and
alpha A – Z (uppercase only). Any printable character
is allowed in nonincrementing fields (STEPMASK
values not 0 – 9).The STARTDATA must be enclosed
within standard printable character delimiters just as a
standard alphanumeric data field is enclosed within
delimiters.
4–23Commands
CommentsThe Incremental Alphanumeric Fixed Data Fields command is a revised
version of the standard IGP/PGL alphanumeric command, but it does not
replace the standard alphanumeric command.
~CREATE;TEST;288(Enters Create Form mode)
VDUP;3;6(Repeat alpha string)
ALPHA(Alpha command)
I;6;5;4;4;–00001;*12345*
STOP(Ends Alpha command)
VDUP;OFF
END(Terminates Create Form mode)
~EXECUTE;TEST(Prints form)
~NORMAL
Commands4–24
Alphanumerics, Incremental: Dynamic Data Fields
PurposeAutomatically increments/decrements dynamic alphanumeric data fields.
Specifies the location and size of the incremental dynamic data field during
the Create Form mode; STEPMASK and STARTDATA parameters are
supplied in the Execute command during the Execute Form mode.
ModeCREATE
NOTE:In the command format below, incremental alphanumeric command
parameters are shown in boldface type; standard alphanumeric command
parameters and optional nonincremental parameters are shown in italics.
Incremental Alphanumeric Dynamic Data Field
command. The command parameter string identifies
the incremental dynamic data field location on the
form and defines the length of the alphanumeric data.
If these parameters are used, the STEPMASK and
STARTDATA parameters cannot be entered in the
Create Form mode; they are entered dynamically
during the Execute Forms mode. To use the
incremental dynamic data field, perform the following
steps:
a.Enter IAF to specify an incremental
alphanumeric dynamic data field.
b. Replace n with a number ranging from 1 to 255
to identify the alphanumeric string location on
the form. The standard alphanumeric SR and SC
command parameters specify the exact location
of the field identified by n.
4–25Commands
c.Replace L with a number equal to the number of
characters in the dynamic alphanumeric string
(STARTDATA) ranging from 1 to 255.
d. Dynamically enter the STEPMASK and
STARTDATA parameters in the Execute Form
mode. The length of the data must be equal to or
less than the value assigned to the length (L)
parameter. Refer to “Execute Form: Incremental
Dynamic Data” on page 4–56 for more
information.
CommentsThe Incremental Alphanumeric Dynamic Data Fields command is a
variation of the standard IGP/PGL Alphanumeric command, but does not
replace the standard alphanumeric command.
As with standard dynamic data fields, incremental dynamic data fields
allow the starting data to be changed without changing the form definition
program. Increment parameters can also change with each new job without
changing the form definition program.
Duplicating Incremental Alphanumeric Fields – Incremental
alphanumeric fixed and dynamic data fields are duplicated horizontally
using the HDUP command and vertically using the standard VDUP
command. Duplicated incremental fields increment in left–to–right,
top–to–bottom order. The following examples illustrate the results of
duplicated incremental fields.
Commands4–26
Value
Description
STARTDATA:
STEPMASK:
Printed Results:
Page #1:
Page #2:
STARTDATA:
STEPMASK:
STARTDATA:
STEPMASK:
Printed Results:
Page #1:
01
01
010203
04
05
06
07
08
09
10
11
12
Field A
A01
X01
Field B
B01
X01
A01A01A01B01
A02
A03
A02
A03
A02
A03
Single numeric field (01)
RPT = 1
RST = 0
HDUP = 3
VDUP = 2
Incremental alphanumeric command;
SR of 1; SC of 1;
VE and HE are 0;
001 stepmask increments by 1;
RPT3 repeats each field value 3 times;
RST9 prints and increments each field 9 times before resetting;
*A01* is the starting value.
I;3;1;0;0;001;RPT1;RST0;*B01*
Incremental alphanumeric command;
SR of 1; SC of 1; VE and HE are 0;
001 stepmask increments by 1;
RPT1 repeats each field value once;
RST0 prints and increments each field 0 times before resetting;
*B01* is the starting value.
and to the right from the given row and column. (Note
the position of the ending row and ending column; they
do not include the line thickness.)
LTDefines the line thickness, measured in dots. Line
thickness is based on dot dimensions of 1/72”
vertically and 1/60” horizontally. Enter a value of 1 or
greater.
SRDefines the starting row of the box. Enter a value
ranging from row 1 through one less than the length of
the form. Character row or dot row is specified based
on the Scale command (page 4–88), or use the CP.DP
format (page 4–7).
SCDefines the starting column of the box. Enter a value
ranging from column 1 through one less than the width
of the form. Character column or dot column is
specified based on the Scale command (page 4–88), or
use the CP.DP format (page 4–7).
ERDefines the ending row of the box. Enter a value
ranging from row 2 through the last row of the form.
The ending row must be greater than the starting row.
Character row or dot row is specified based on the
Scale command (page 4–88), or use the CP.DP format
(page 4–7).
Commands4–30
NOTE: If the SCALE;DOT command is used to specify the dot resolution,
the line thickness will be specified in that dot scale, rather than as
the standard 1/72” line.
ECDefines the ending column of the box. Enter a value
ranging from column 2 through the last column of the
form. The ending column must be greater than the
starting column. Character column or dot column is
specified based on the Scale command (page 4–88), or
use the CP.DP format (page 4–7).
STOPStop indicates the end of the Box command; enter
STOP, and the IGP/PGL will wait for a new command.
If not entered, the IGP/PGL will wait for another set of
Box command parameters.
ExampleThe following program and example in Figure 4–4 defines two boxes. To
illustrate positioning, the starting row and column are indicated on the
example but do not necessarily reflect actual location on the page. (Note the
position of the ending row and ending column; they do not include the line
thickness.)
BOX
3;24;16;51;63(One box three dot rows thick)
2;44;48;46;58(One box two dot rows thick)
STOP
4–31Commands
ROW 24
COLUMN 16
COLUMN 48
ROW 44
ROW 46
Figure 4–4. Box Example
COLUMN 58
COLUMN 63
ROW 51
box.ex
Commands4–32
Compressed Print (Density)
PurposeDefines the horizontal print density in characters per inch (cpi).
ModeNORMAL, EXECUTE
Format(cc) DENSITY ;n
(cc)The Special Function Control Character.
DENSITYThe Density command; enter DENSITY.
nSelects the density in cpi, OCR–A, or OCR–B; enter a
value of 10, 12, 13, 15, 17 or 20 to specify the density
in characters per inch (the default is 10 cpi), or 10A to
select 10 cpi OCR–A or 10B to select 10 cpi OCR–B.
CommentsPrint density formats of 10, 12, 13, 15, 17 or 20 cpi are available. Default
print density is 10 cpi. After a Density command is entered, all subsequent
alphanumerics print at the specified density until another Density
command, a Normal mode command, or a Reset command is entered. The
Density command also permits the standard printer editing function
(carriage return editing). After the Density command is entered, data in the
print buffer can be edited.
ExampleThe following command selects 15 cpi printing format until another
Density command, a Normal mode command, or a Reset command is
entered.
~DENSITY;15
4–33Commands
Configuration
PurposePlaces the IGP/PGL in the Configuration mode, where changes to any or all
of the IGP/PGL configuration parameters via software control can be made
instead of from the printer control panel.
ModeNORMAL
NOTE:A separate line is required for the CONFIG command, the parameters and
values, and the END command.
Format(cc)CONFIG
parameter;value
END
(cc)The Special Function Control Character (SFCC).
CONFIGThe Configuration command; enter CONFIG.
parameter;valueThe parameter for which a configuration change is
ENDTerminates the CONFIG command; enter END.
Table 4–2. CONFIG Command Parameters
AUTO WRAP
AUTO EJECT
CARRIAGE RETURN DEF
desired, and the value associated with that parameter.
The available parameters are listed in Table 4–2, and
the associated values are shown in Table 1–4 on page
1–13.
LEFT
RESET
SFCC
MARGIN
SLEW RANGE
TOP/BOTT
UPPERCASE
OM MARGIN
LINE FEED DEF
SKIP PREFIX
Commands4–34
NOTE: All CONFIG parameters except RESET must be followed by a
semicolon (;). Any CONFIG parameters not entered in
UPPERCASE and exactly as listed in this table will result in an
Error 156. (Refer to the “Error Codes” chapter.)
CommentsThe IGP/PGL configuration parameters available are also defined in
Chapter 2.
Any or all parameters can be used within one CONFIG command, and they
can be listed in any order. List each parameter;value on a separate line,
terminating with the END command. Each CONFIG parameter, except the
RESET parameter, must be followed by a semicolon (;). Default
configuration values can be reset using the CONFIG command.
Parameters not followed by a value, and parameters followed by any
non–zero value are interpreted as “true” or “enabled” values. For carriage
return and line feed definitions, a zero value does not change the data
stream. However, for non–zero values, a carriage return character or line
feed character will be interpreted as a carriage return plus a line feed.
Parameters not listed in this command remain unchanged. If a parameter
error is detected for parameters other than 0 or 1 (i.e., SFCC, Top/Bottom
Margin, Left Margin), the value will default to the current configuration
from external printer memory.
Example 1The following command enables IGP/PGL Auto Wrap, disables Auto Eject,
and selects 6 lpi printing.
~CONFIG
AUTO WRAP;1
AUTO EJECT;0
LPI;6
END
Example2The following command resets all control panel IGP/PGL configuration
parameters back to default values.
~CONFIG
RESET
END
4–35Commands
Corners
PurposeDefines corner sets.
ModeCREATE
FormatCORNER
LT; SR; SC; ER; EC; VL; HL
STOP
CORNER Enter CORNER to expand corners down and to the
LTDefines the line thickness, measured in dots. Line
SRDefines the starting row of the corner. Enter a value
right from the given row and column.
thickness is based on dot dimensions of 1/72”
vertically. Enter a value of 1 or greater.
ranging from row 1 through one less than the length of
the form. Character row or dot row is specified based
on the Scale command (page 4–88), or use the CP.DP
format (page 4–7).
SCDefines the starting column of the corner. Enter a value
ranging from column 1 through one less than the width
of the form. Character column or dot column is
specified based on the Scale command (page 4–88), or
use the CP.DP format (page 4–7).
ERDefines the ending row of the corner. Enter a value
ranging from row 2 through the last row of the form.
The ending row must be greater than the starting row.
Character row or dot row is specified based on the
Scale command (page 4–88), or use the CP.DP format
(page 4–7).
Commands4–36
NOTE: If the SCALE;DOT command is used to specify the dot resolution,
the line thickness will be specified in that dot scale, rather than as
the standard 1/72” line.
ECDefines the ending column of the corner. Enter a value
ranging from column 2 through the last column of the
form. The ending column must be greater than the
starting column. Character column or dot column is
specified based on the Scale command (page 4–88), or
use the CP.DP format (page 4–7).
VLDefines the length of the vertical arm (including the
line thickness) of each corner in the set. Enter a value
of 1 or greater specified in character or dot rows based
on the Scale command (page 4–88), or use the CP.DP
format (page 4–7).
HLDefines the length of the horizontal arm (including the
line thickness) of each corner in the set. Enter a value
of 1 or greater specified in character or dot columns
based on the Scale command (page 4–88), or use the
CP.DP format (page 4–7).
STOPStop indicates the end of the CORNER command;
enter STOP, and the IGP/PGL will wait for a new
command. If not entered, the IGP/PGL will wait for
another set of Corner command parameters.
ExampleThe following program specifies a corner set as shown in Figure 4–5. To
illustrate positioning, the starting row and column are indicated on the
example but do not necessarily reflect actual location on the page. (Note the
position of the ending row and ending column; they do not include the line
thickness.)
CORNER
5;27;27;42;55;4;6 (Each corner in the set is 5 dot rows thick)
STOP(4 character rows high, 6 character columns wide)
4–37Commands
COLUMN 27
ROW 27
HORIZONTAL LENGTH
6 COLUMNS
ROW 42
COLUMN 55
VERTICAL
LENGTH
4 ROWS
Figure 4–5. Corner Example
corner.ex
Commands4–38
Create
PurposePlaces the IGP/PGL in the Create Form mode, where forms and form
elements can be defined using the appropriate commands.
ModeNORMAL
Format(cc)CREATE; [/]formname [;FL] [;DISK]
(cc)The Special Function Control Character.
CREATEThe Create Form mode command; enter CREATE.
/The optional debug character to check the program line
by line for incorrect parameters and print boundaries
using the current page size; enter the slash symbol (/)
to debug the program. No checks are made until the
completed program is sent to the IGP/PGL for storage
(when the form is executed by printing the file with the
IGP/PGL program). Then the form name is entered
into the directory, and the program is evaluated. If
errors are detected, the program will print, line by line
(including the error on the line where the error occurs),
followed by the error–free sections of the form.
Correct all errors and delete the slash. Refer to
“Solving Program Errors” on page 6–49.
formnameDefines the form name of the form being created. The
form name should be no more than 12 characters in
length. Refer to page 4–5 for a list of allowable form
name characters. If a form is created with the same
name as a form already existing in memory, the newly
created form will replace the existing form. All future
reference to the form (editing, executing, or deleting
the form from the directory) must be made using the
assigned name.
4–39Commands
FLThe optional forms length parameter to specify the
maximum length of the form. (Form length cannot
exceed the physical length of the page. Refer to
Appendix C). Specify the form length in one of three
ways:
a.Enter 0 to define a form of unspecified length.
The form will end after the longest element; that
is, the form length is automatically controlled to
contain all elements without extra length beyond
the longest element. This can be used to
eliminate wasted paper after producing short
forms.
b. Enter a value for the form length ranging from 1
to 65,535 to specify the forms length in dot
rows. (12 dot rows per line = 6 lpi spacing; 9 dot
rows per line = 8 lpi spacing.)
NOTE: Dot row range for setting the forms length depends on the forms
length configuration. Refer to page 4–64 for information on how to
configure the forms length.
When the host form length configuration option is enabled, the form
length and width values defined in this command, set the physical
length and width page size.
c.To specify the default forms length of 792 dot
rows (11 inches at 6 lpi), do not enter a value in
the form length parameter.
DISKOptional parameter to store the form on the IGP/PGL
external memory module. Enter DISK.
ExampleThe following command creates a form named ORDER with the default
forms length:
(cc)CREATE;ORDER
Commands4–40
Delete Form
PurposeDeletes the form identified by the form name from the directory and the
IGP/PGL memory.
ModeNORMAL
Format(cc)DELETE FORM; formname[;DISK]
(cc)The Special Function Control Character.
DELETE FORMThe Delete Form command; enter DELETE FORM.
formnameIdentifies the form to be deleted. Enter the name of the
form exactly as it was created. You can delete an entire
form directory by inputting *ALL as the form name.
DISKOptional parameter to delete the form from the printer
external memory module where it was originally
stored. Enter DISK.
NOTE: *ALL cannot be used in conjunction with DISK parameter.
CommentsFor more information, refer to the Directory Example and the Delete
Example on pages 6–47 and 6–48.
ExampleThe following command deletes the form named “PAY#” from the
directory, IGP/PGL memory, and the printer external memory.
~DELETE FORM;PAY#;DISK
4–41Commands
Delete Logo
PurposeDeletes the logo identified by the logo name from the directory and the
IGP/PGL memory.
ModeNORMAL
Format(cc)DELETE LOGO; logoname[;DISK]
(cc)The Special Function Control Character.
DELETE LOGOThe Delete Form command; enter DELETE LOGO.
logonameIdentifies the logo to be deleted. Enter the name of the
logo exactly as it was created. You can delete an entire
logo directory by inputting *ALL as the logo name.
DISKOptional parameter to delete the logo from the printer
external memory module where it was originally
stored. Enter DISK.
CommentsPrinting a form that contains a deleted logo will produce an error message.
For more information, refer to the Directory Example and the Delete
Example on pages 6–47 and 6–48.
ExampleThe following command deletes the logo named “MEMO” from the
directory, IGP/PGL memory, and the printer external memory.
~DELETE LOGO;MEMO;DISK
Commands4–42
Directory
PurposePrints the following information: (1) all defined forms and logos, (2) logo
assignment to forms, and (3) memory usage and availability.
ModeNORMAL
Format(cc)DIRECTORY
(cc)The Special Function Control Character.
DIRECTORYThe Directory command; enter DIRECTORY.
CommentsAs many forms and logos as printer memory allows may be stored in
IGP/PGL memory. If the memory is full, the form will not print; available
space in the memory must be at least the size of the form being executed.
For more information, refer to the Directory Example on page 6–47.
4–43Commands
Duplication, Horizontal
PurposeDefines both the number of times form elements are duplicated horizontally
and the spacing between each duplication.
ModeCREATE
FormatHDUP; dup#; offset#
elements to be duplicated
HDUP;OFF
HDUPThe Horizontal Duplication command; enter HDUP.
dup#Specifies the duplication number, which is the number
of times the entered form element(s) will repeat
horizontally. Enter a value ranging from 1 to 255.
offset#Specifies the horizontal offset to establish the
horizontal spacing between each duplication of the
form element(s) specified in the body of the command.
Enter a value in terms of dot or character columns
based on the Scale command (page 4–88), or use the
CP.DP format (page 4–7). The offset is from starting
column to starting column.
HDUP;OFFTerminates the Horizontal Duplication command; enter
HDUP;OFF. If not entered, the IGP/PGL expects
another form element to be defined for duplication. A
single HDUP command can define different types of
elements for duplication.
Commands4–44
ExampleThe following example is a horizontal duplication of a series of vertical
lines. To illustrate positioning, starting row and column are indicated on the
example but do not necessarily reflect actual location on the page.
HDUP;14;4(14 duplications with 4–character column spacing)
VERT(Command to duplicate horizontally)
1;10;59;59.6 (Note CP.DP format: 59.6)
1;10.3;58.9;59.9
1;11;58.6;60
1;11.3;58.3;60.3
1;12;58;60.6
1;12.3;58.3;60.3
1;13;58.6;60
1;13.3;58.9;59.9
STOP(Stops the command to duplicate element)
HDUP;OFF(Terminates the horizontal duplication)
COLUMN 10
COLUMN 11
COLUMN 12
COLUMN 13
COLUMN 13.3
COLUMN 12.3
COLUMN 11.3
COLUMN 10.3
DUPLICATING THE SET HORIZONTALLY
14
ROW 58
TIMES
ROW 60.6
hdup.ex
4–45Commands
Duplication, Vertical
PurposeDefines both the number of times elements are duplicated vertically and the
spacing between each duplication.
ModeCREATE
FormatVDUP; dup#; offset#
elements to be duplicated
VDUP;OFF
VDUPThe Vertical Duplication command; enter VDUP.
dup#Specifies the duplication number – the number of times
the entered form element(s) will repeat vertically. Enter
a value ranging from 1 to 255.
offset#Specifies the vertical offset to establish the vertical
spacing between each duplication of the form
element(s) specified in the body of the command.
Enter a value in terms of dot or character columns
based on the Scale command (page 4–88), or use the
CP.DP format (page 4–7). The offset is from starting
row to starting row.
VDUP;OFFTerminates the Vertical Duplication command; enter
VDUP;OFF. If not entered, the IGP/PGL expects
another form element to be defined for duplication. A
single VDUP command can define different types of
elements for duplication.
Commands4–46
ExampleThe following example is a vertical duplication of one horizontal line. The
line is duplicated three times. To illustrate positioning, the starting row and
column are indicated on the example but do not necessarily reflect actual
location on the page.
VDUP;3;2(3 duplications with 2–character row spacing)
HORZ(Command to duplicate vertically)
1;52;15;65
STOP(Stops the command to duplicate element)
VDUP;OFF(Terminates the vertical duplication)
ROW 52
ROW 54
ROW 56
COLUMN 15
COLUMN 65
vdup.ex
4–47Commands
End
PurposeTerminates the current mode of operation and must be used before entering
a new mode command (EXECUTE, LOGO, NORMAL, or even CREATE).
ModeCREATE
FormatEND
CommentsAfter the End command is received, the IGP/PGL flushes program errors,
stores the error–free portions of the form program just completed, and then
returns to the Normal mode. If the debug slash (/) is included in the Create
command, the program prints with any corresponding error messages.
Commands4–48
Execute Form Mode
How to Use the Execute Command
Forms are printed in the Execute Form mode. In addition to printing the form
in the Execute Form mode, variable data can also be entered onto the form
“dynamically” during the Execute Form mode. This dynamic data input
during the Execute Form mode includes page numbers, alphanumeric data
fields, and bar code data fields. Pagination, described on page 4–78, is
performed in the Execute Form mode. Dynamic alphanumeric and bar code
data require additional commands within the Execute Form mode.
The fastest method for repeated forms printing is to use the form feed
character. Rather than sending a series of Execute/Normal commands, which
slows the process by performing an open—print—close form sequence, the
form feed character instructs the IGP/PGL to start a new page with new
dynamic and overlay data using the existing Execute commands for the form.
The Dynamic Data—Overlay Data—Form Feed Character sequence can be
repeated indefinitely while maintaining the optimum print speed within the
original Execute command.
Remember, when a form count is not specified, a single line spacing (or a
line containing overlay data) must always separate an EXECUTE command
from a NORMAL command.
4–49Commands
To Execute Forms Rapidly
In order to save reloading time, the PGL remembers the last form executed.
However, a form must be loaded if it was not the last form executed, if it was
used with a CREATE command since the last EXECUTE, or if any logo has
been created.
Use the SETUP command to define forms at power up and execute them
from internal memory rather than from external memory.
When the form to be executed is not found in internal memory, the default
external memory module is automatically searched. If the form is found, it is
loaded into internal memory and execution resumes; otherwise, the “FORM
NOT FOUND” error is printed.
NOTE: If an older application uses the disk parameter for the execute
command, it is ignored and the above steps are taken.
Print Formats in the Execute Form Mode
The Execute Form mode has two print formats. The standard execute
command format, shown below, is used for executing nonincremental data
and incremental fixed data. An incremental Execute command format,
containing two additional parameters, is used for executing incremental
dynamic data and is discussed on page 4–56.
During the Execute Form mode, the IGP/PGL responds to regular print
format commands such as 8 lpi, and elongated characters. Some commands
can be used in other modes in addition to the Execute Form mode. For
example, Compressed Print, Expanded Print, Execute, Ignore, Select Format,
and Vertical Line Spacing, which are also Normal mode commands, can be
used in the Execute or Create Form modes. The IGP/PGL alternate character
set can also be used in the Execute Form mode.
formnameIdentifies a previously defined form by name. Enter the
form name exactly as used when created.
PAGE nThe optional Pagination command; enter PAGE and
replace n with the decimal number of the starting page
in a sequence of multiple pages. The number may be
eight digits long and range between 0 and 99999999.
The next page after 99999999 is 0. Leave a blank
space between the PAGE command and the n value.
The page number will print on the form in the location
defined by the Page Number command in the Create
Form mode. If the location of the pagination field was
not specified in the Create Form mode, the page field
is printed in the upper left corner of the form.
4–51Commands
FCThe optional form count parameter specifies the
number of copies of the form to print. Enter the
appropriate number.
When the last page prints, the IGP/PGL returns to the
Normal mode automatically. Donot use the form count
parameter if dynamic data (AFn and BFn parameters),
incremental data (ICNT or IRST parameters), overlay
data, or EVFU data are used in the Execute command.
ICNTnThe optional incremental form count. Enter ICNT and
the Incremental value as described in the Execute
Incremental Dynamic Data command described on
page 4–56.
IRSTnThe optional incremental reset count parameter. Enter
IRST and the reset value as described in the Execute
Incremental Dynamic Data command described on
page 4–56.
AFn;(D)ASCII text(D)
The Execute Dynamic Alphanumeric Data command.
Enter the dynamic alphanumeric data during the
Execute Form mode as described in “Execute Form:
Dynamic Alphanumeric Data” on page 4–54.
BFn ;(D)data(D)The Execute Dynamic Bar Code Data command. Enter
the dynamic bar code data during the Execute Form
mode as described in “Execute Form: Dynamic Bar
Code Data” on page 4–55.
The Execute Incremental Dynamic Bar Code Data
command. Supply the data as described on page 4–57.
Commands4–52
Overlay DataOverlay data can be entered during the Execute Form
mode. (The words “Overlay Data” are not part of the
Execute command. They are shown in the command
sequence to indicate that actual overlay data can be
entered following the Execute command.) Refer to
“Execute Form: Overlay Data” on page 4–59.
Form Feed Character
Optional command instructing the IGP/PGL to start a
new page with new EVFU, dynamic, and overlay data
using the existing Execute commands for the current
form. Using this EVFU Data—Dynamic Data andOverlay Data—Form Feed Character sequence can be
repeated indefinitely, while maintaining the optimum
print speed, within the original Execute command.
(cc)NORMALThe Normal mode command. If the form count
parameter was not used in the Execute command, enter
the SFCC and NORMAL to return the IGP/PGL to the
Normal mode.
The Normal mode command is input following all
other Execute commands to enter variable data. (Refer
to the following sections.) Input a line terminator to
leave a blank line before entering the Normal
command.
4–53Commands
Execute Form: Dynamic Alphanumeric Data
PurposeIncorporates the dynamic alphanumeric data into a previously identified
location on a form.
ModeEXECUTE
Format(cc)AFn; (D)ASCII text(D)
AFnIndicates a dynamic alphanumeric field (AF) and its
data (n). Enter AF and replace n with the number of
the data field corresponding to the number used to
identify the field when it was defined with the
Alphanumeric command in the Create Form mode.
DThe printable character identifying the start and finish
of the alphanumeric data. Enter any printable character
other than a slash (/), the SFCC, or a character used
within the data. The same character must be used at
both ends of the data field but will not be printed with
the data.
ASCII textThe group of ASCII characters (the alphanumeric
string) to print. Enter any of the standard ASCII
printable characters (except the character used as
delimiters described in the D parameter). The data
appears on the form at the location identified by n.
NOTE:Commands can appear anywhere in the overlay text with PGL.
CommentsThe location for the Dynamic alphanumeric data must have been previously
identified using the AFn;L parameters of the alphanumerics command in
the Create Form mode. Inputting individual commands enters the new data
into the identified location each time the form is printed.
You can repeat the (cc)AFn;(D)ASCII text(D) sequence to complete as
many data fields as you defined on the form in the Create Form mode. You
can also combine the Execute Dynamic Bar Code Data command in the
same Execute command sequence. Each “page” of dynamic data (the
dynamic fields, data, and overlay data) for the form must be separated from
the next page of new dynamic data by a form feed.
Commands4–54
Execute Form: Dynamic Bar Code Data
PurposeIncorporates the dynamic bar code data into a previously identified location
on a form.
ModeEXECUTE
Format(cc)BFn; (D)data field(D)
BFnIndicates a dynamic bar code field (BF) and its data
(n). Enter BF and replace n with the number of the
data field corresponding to the number used to identify
the field when it was defined with the bar code
command during the Create Form mode.
DThe printable character (quotation marks for example)
identifying the start and finish of the bar code data.
Enter any printable character other than a slash (/), the
SFCC, or a character used within the data. The same
character must be used at both ends of the data field
but will not be printed with the data.
data fieldEnter the characters for the bar code data. The type of
characters allowed in the data varies with the type of
bar code. Refer to the data field descriptions for the
selected bar code types.
NOTE:Commands can appear anywhere in the overlay text with PGL.
CommentsThe bar code location must have been previously identified using the
BFn;L or BFn parameters of a bar code command in the Create Form
mode. Then use the appropriate bar code command to enter the bar code
data in that location. Inputting individual commands enters new bar code
data into the identified location each time the form is printed.
You can repeat the (cc)BFn;(D)data field(D) sequence to complete as many
bar code data fields as were defined on the form in the Create Form mode.
You can also combine the Execute Dynamic Alphanumeric Data command
in the same Execute command sequence. Each “page” of dynamic data (the
dynamic fields, data, and overlay data) for the form must be separated from
the next page of new dynamic data by a form feed.
4–55Commands
Execute Form: Incremental Dynamic Data
PurposeIncorporates incremental/decremental capability to dynamic alphanumeric
or bar code data supplied as a part of the Execute Form mode.
ModeNORMAL
NOTE:In the command below, incremental Execute parameters are shown in
boldface type; standard Execute command parameters are shown in italics.
The general Execute format is shown on page 4–51.
Format (cc)EXECUTE; formname [;PAGE n] [;FC] [;ICNTn] [;IRSTn]
ICNTnIdentifies the incremental form count to specify the
number of forms to generate with the incremental
fields automatically updated. Enter ICNT and replace
n with a value ranging from 1 to 65,535 to specify the
number of forms.
IRSTnThe optional incremental reset count parameter to
specify the number of forms to generate before
resetting all incremental fields to their starting values.
The reset count parameter is useful in dividing the total
number of forms generated into multiple groups of
identical copies. To use this parameter, enter IRST and
replace n with a value ranging from 1 to 65,535 to
specify the reset count (how many forms generated
before resetting the incremental fields). If the reset
count value is equal to or greater than the incremental
count value, the reset will never occur.
ExampleThe following forms were generated from ICNT6, IRST2. (To duplicate
incremental fields within a form, refer to page 4–25.)
0
1
2
form1form2form3form4form5form6= ICNT6
3
4
5
0
1
2
3
4
5
0
1
2
3
4
5
Commands4–56
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.