DOC1 Programmer's Guide

Running PCE
Creating an initialization file
A PCE initialization file (INI) is a text file that can
be created using any standard text editor.
The file format consists of several distinct sections in
which can be coded a range of keywords and their
associated parameters. Section names are enclosed
in angle brackets. All code following a section name
is considered to belong to that section until the next
section name is encountered. For example:
CustomerName="SA Loans"
;keycode passed as a symbol
Keycode=%pcekey%
Messages=messages.dat
Input=doc1\pce\scripts\job1.txt
TranslationTable=c:\doc1\doc1ttab.ett
TextSubs=c:\doc1\resource\myets.ets
HIP=c:\doc1host\billjob.hip
AsciiToAfpds=27
;other System values in this include file
#include doc1static.ini
DisableColor=DOWNGRADE
Day1=Dimanche
Sections and keywords within sections can be coded
in any order. Most keywords have default parameters
that are used if the keyword is not coded in the file.
Parameters are normally coded as literal values but
can be specified dynamically if required by defining
them wholly or partly as symbols. Values can be
assigned to such symbols when starting the
DOC1PCE program. Within the INI file symbols
are referenced by coding the name to be used within
percentage signs as in the example above. Symbol
names can also be referenced within the PCE script
itself by using the symbol command.
You can also use an #include statement to add the
contents of an existing INI file to another. This
allows you to reuse common INI settings. The
contents of an include file are added at the point
where the #include statement is encountered.
IF SECTIONS OR KEYWORDS ARE REPEATED WITHIN AN
INI FILE OR #INCLUDE FILES THE LAST ELEMENT TO BE
ENCOUNTERED WILL BE USED (WORKING
TOP-TO-BOTTOM).
Text following a semi-colon up to the start of the
next line is as a comment.
At minimum a PCE INI must contain:
• a section with both
CustomerName and Keycode keywords
• a section with at least the Messages and
Input keywords
• a section with at least the
PrintStream and Resolution keywords
If your script uses functions that return regional
information (such as date, day or monthname) you
may often want to create one or more
sections to indicate how the values are to be
formatted. You may include up to 10 different
sections: , …
.
If your script adds presentation objects to existing
pages the INI will also often contain a section that
allows you to customize some aspects of the output
datastream being manipulated (for instance
or ) and/or a
section for non-standard environment settings.
The following pages provide a reference for all
available INI sections and their associated keywords.
100