Contrasting Hfdl with a typical forms application | Xerox Printer

OVERVIEW

Table 1±1.	Supported centralized printers

Centralized printers		OSS version

4050		V2.1, V3.5, or V3.8

4090		V2.1, V3.5, or V3.8

4135		V3.6

4650		V3.5 or V3.8

4850		V3.7, V3.8, or V5.0

4890		V4.0 or V5.0

8790		V2.1 or V3.9

9790		V2.1 or V3.9

Decentralized printers

HFDL also supports some Xerox decentralized printers. These printers are generally in remote locations away from the mainframe. An SNA/RJE communications link or a BSC/RJE communications link connects them to the host. Also, the Xerox Flex Box protocol converter allows you to connect the Xerox 4235 printer to the host.

Table 1±2 lists the decentralized printers that HFDL supports and the associated OSS.

Table 1±2. Supported decentralized printers

Decentralized printers	OSS version

3700	V5.2

4235	V1.2 or V1.5
	(XPPM and XDPM modes)

4700	V1.0 (XES mode)

HFDL 3.2 generates forms on the Xerox 4235 and Xerox 4700 printers operating in XES mode.

Contrasting HFDL with a typical forms application

HFDL allows you to create electronic versions of your forms, compile them, store them in your system database, and download them to your printer as needed. This eliminates the need to stock large quantities of preprinted forms.

Once you download your form to a Xerox LPS, the printer merges your form with variable data. This capability allows you to create, store, and print any number of forms, in any order, on plain paper.

In a typical forms application that does not use HFDL, you have to prepare and load preprinted forms (often printed in large quantities) on a printer connected to a computer. You can load

HOST FORMS DESCRIPTION LANGUAGE 3.2 FOR IBM MVS CREATING FORMS

1±3

Image 13

Xerox Printer Contrasting Hfdl with a typical forms application, Supported centralized printers, Decentralized printers

Contents

Xerox Page Table of contents Using Hfdl commands Managing and printing sample forms Creating a sample formMessages Appendices Index GlossaryINDEX±1 Introduction ContentsAbout this manual Conventions Related publicationsXerox publications LPI Publication Number IBM publicationsPage Overview Hfdl features Operating environment PrerequisitesHardware requirements Software requirements Supported centralized printers Contrasting Hfdl with a typical forms applicationCentralized printers OSS version Decentralized printers Forms you can create with Hfdl Determining format Planning your formsOrientation System Frames Physical Form originVirtual Form element Element origin Positioning form elements Y coordinates Grids Negative coordinates Data typesUnit value Forms data Fixed and proportionally spaced fonts FontsFont orientation ±6 shows the font orientations relative to the physical Font orientation when using short±edge paper feed Character Code point Identifier That prints 000/042 Virtual keyboard and font character maps Ascii Virtual keyboard character maps Font character maps Adding color to formsInk color availability and control Forms design ruler Choosing paper sizeRuler scales Suggested uses ±14 Creating forms with Hfdl commands Using Hfdl commandsAvailable specifications Reserved words Command formatSpecial characters Understanding the command syntax flow charts Setting up your form Paper command Form commandForm command syntax Default Paper Usletter Size Uslegal LANDSCAPE/PORTRAIT commandExamples Long form Paper Usletter High WideParameters Portrait page Size is 8.5 Inches Wide by 11 Inches High Grid Unit Grid commandCPI LPI Origin LANDSCAPE/PORTRAIT commands Font commandGrid Unit is 12 CPI by 8 LPI Origin 0.18 Inch 0.66 Inch Grid FMT1 Palette command Icatalog commandDefaults Icatalog Palette is PAL1 INK commandPalette PAL1 INK Inks RED, Pink Example Long formInkname format Inkname syntax Iresult command Description commandsOr Color Line command Inches to 10 Inches Using Solid 1 Using INK 3 BOX commandAT 3 Inches Draw 5 Horizontal Lines in Inches from Repeat Horizontally Every 0.50 Inches Using Dotted INK Fill Shading Light High Hairline Using Solid INK Hairline INK 2 and Repeat Every AT 4,6 Draw 4 Boxes 14 Wide by 4 High Using SolidAT 4,6 BOX 14 Wide by 4 High Text AT command DOT Using Line Font INK UsingText Horizontal Vertical Spaced PER Line INCHES, CENTIMETERS, CPI, LPI, DOTS, and XDOTS. You can When you use Text Aligned in Column or Text JustifiedCENTER, TOP, BOTTOM, JUSTIFIED. See the Xerox Laser Example Used with DOT Leader or Font n Column 1 Inch Wide Text AT 1,1 John Doe DOT Leader 987±6543 Text in BOX command Leader Font NEW DOT Using Line BOX Next Horizontal Font INK Using BOX TOPBottom Right Right Bottom Units are INCHES, CENTIMETERS, DOTS, and XDOTS. You can Use Justified in COLUMN, refer to the ªTEXT AT commandº Same applies for in Next HORIZONTAL/VERTICAL BOX For the in TOP, .......BOTTOM BOX.... for text placement INK Using Logo command Default None Examples Long form Graphic commandLogo NEW1 AT 1,1 Using INK Scale INK Using Graphic Symbol AT 1,1 Scale is 4 Using INK Section command Section command Do Section commandSection definitions Section invocation Repeat Horizontally Section TimesDo Nusec 3 AT 1,1 Repeat Horizontally Every Interword command Column commandInterword gap formula Specifying the base gap Using Spacing and Interword togetherSpecifying the interword multiplier Interword Spaceis DOT Leader Using Font DOT Leader commandGap, specified by Interword gap Relative coordinate LET command Comment Comment command END command syntax END commandComment ***HFDL is Able to Describe Many Types Forms ±36 Comment Define Titles Creating a sample form Form XEROX2, Resolution is 300 SPI Setting up the formForm XEROX2 Resolution is 300 SPI Paper Size is Usletter Paper Size is Usletter Form XEROX2 Using the sample description command AT 2, ±1 Draw 1 BOX 133 Wide by 5 High Using Solid Creating a Sample Form AT 11, ±1 6 Boxes 133, 4 Shading Vertically Every Horizontal Text Using Font 3 AT 61, ±1 XEROX2 5/93 Command coding conventions Using the Compile commandCommand syntax Managing and printing sample forms Operands FSL=DDnamePDS member name where DDname = Xffsl Gap, specified by To print When shift Characters To print When literal intro isCoding alternative literal introduction Key Batch processing Compile commands Command syntax examplesCOM FSL=XFFSL VER=XC MEM=MMBR?? FOR=FORM Compile FSL=XFFSL VER=X1 LITERAL=$ SHIFT=@ Object ±4. Resource DDnames for centralized printers Description Hfdl compiler JCL DDname Description Resource DDnames for decentralized printersHfdl execution DDnames for centralized Printers Xfifo Hfdl execution DDnames for decentralized DDnames Description Data sets required to download and printXsuin Xsuactl Invoking the Hfdl compiler Downloading and printing a sample Xsuin Downloading and printing a sample Editing an existing form Accessing compiled formsSpecifying monochrome forms Messages Message indicators XFG6006W Member/Form name name is too long XFG6005W Group name too long, using nameXFG6007F DDname name is not defined XFG6008F Dsname name does not exist XFG6014F Cannot open scratch file file name XFG6013F Cannot open FSLXFG6020I There are N forms compiled XFM8nnn Internal Failure XFP1002W Semicolon expected XFP1001W Discarding excess FDL XFP1005W Undefined Section Name name, command ignorned XFP1004W Draw N and Repeat Every disagree, usingXFP1006W Invalid line weight, using Hairline XFP1007W Invalid border weight, using Hairline XFP1014W Invalid resolution, using 300 spi XFP1012W Unexpected fraction, using integerXFP1010W Box not found XFP1015W Unexpected end of text terminating code expected XFP1022W Identifier name too long, using name XFP1021W Setup command out of sequenceXFP1024W Section name too long, using name XFP1025W Logos not supported for XES forms XFP1029W No substitution allowed for Logo logo name XFP3001E Syntax error on command segmentXFP1030W Can not close data base XFP1032W Column off right of physical XFP3005E Vertical text inconsistent with left/right XFP3008E Setup command not allowed within sectionXFP3006E XFP3007E Stacked text and justify conflict XFP3018E INK command not defined XFP3016E Font command not definedXFP3014E Value out of range XFP3015E Keyword out of context/sequence XFP3024E Line end coordinate = start coordinate XFP3021E Font name font name exceeds 20 charactersXFP3030E Box off top/bottom/left/right of physical XFP3034E Box width is zero XFP4009F Cannot open IFF XFP4006F Cannot open FSLXFP4010F Grid format not defined format name XFP4012F Too many fonts specified Return Description Code XFP4030F Database access fault mode =return code ±14 ±15 ±16 XFP4034F Invalid graphic scale factor XFP4063F Data List Error XFP4051F Keyboard map error rc= return codeXFP4040F Text string exceeds buffer limits XFP4050F Keyboard map not found XFP4066F Delete old Attribute Error XFP4064F Query List ErrorXFP4067F Attribute data list Error XFP4068F ADD Attribute Error XFP5000F Memory allocation fault rc= XFP4082F DB security fault. No access privilege for userXFP4081F Can not open Database. Check DB reference XFP4084F Invalid virtual keyboard character map name XFU4063F Data List Error XFU4030F Database access fault mode=return codeXFU4064F Query List Error XFU4060F Can not open FRM XFU4068F ADD Attribute Error XFU4067F Attribute data list ErrorXFU4069F Blob Data List Error XFU4070F Can not add 1st Blob XFX0003F Open file error XFX0002F Memory allocation errorXFX0007F Invalid resolution record format XFX0004F Invalid IFF version record format XFX0011F Invalid origin record format XFX0022F Error opening IFF fileXFX0012F Invalid grid record format XFX0013F Invalid line record format XFX0024F Error writing XES file XFX0023F Error opening XES fileXFX0025F Unexpected IFF command sequence XFX0026F Error sorting IFF File XFX0035F Fatal error return from Xprm API XFX0034F Error initializing to Xprm databasesXFX0036W Error terminating Xprm XFX0038F Error reading ink header record Exit Terminating due to internal error ±28 System considerations Local density and page setup errorsLine density limits Boxes and their image Using lines within sectionsText in boxes FMT grid format properties Specification SubstitutionFMT properties for 8.5 by 11±inch paper FMT properties for A4 paper FMT properties for 8.5 by 14±inch paper Approved abbreviations for reserved words Page Comparison of Hfdl and FDL Table D±1. Command comparison matrix Command/FeatureExtension Page Paper sizes available for Hfdl Supported paper sizesPaper size inches Hfdl designation Page Glossary Host Forms Description Language Glossary Host Forms Description Language GLOSSARY±5 Host Forms Description Language GLOSSARY±7 Line LibraryLine feed Line printer GLOSSARY±9 Host Forms Description Language GLOSSARY±11 Host Forms Description Language GLOSSARY±13 Page Numerals IndexBarr SNA, 1±2 Operating IBM XES Page Sig & Bld Ex tertiary entry JCL IBM XES1 FDL Palette, see Palette command Public Elated publi Feat Ng envirAsting H Ardwa Rereq Onm Ddi MapEr map Ter map Nt cha Or to f Ining formaMs des Ori Ge fra Ning your fGri Age o Color av Ienta Osing paOrtiona Uler sca Irtual k SizRtual ke Xerox 4700 Color Document Ment Printer h Nter uses full co Com Rved wEcia MN com Pro Escr Reati Nd forEttin Font card Ard. Us Decentralized1 1 Jo IptNT n k LE n sp Ader co FDL commaND comm ONT com RM com Up yAphic co RID co Ax DOT LE Hfdl com NK comma OG comSult com Rait com GO com INE comEtte com Aper com Coordi Ction comOn You Ection comman XT AT com Flow chXT in BOX com St NEW L Up the fo SamMple description com Sing the C Essing compiled fSsing Compile co Oding conve Wnlo AccDiting an ex Fying monoc FDL compi CL requiremeDing a Printing a sa Aging and prinAtch pr Oup=nam Mpile comEMber=sele FP4034F FP4051F FP4066F FP4084F Essa Age indi Em conside MT prope MT grid fCape GR Ortrait and G Eserved wo Oved abb Nd FD Arison of HF Orted paper si Reader Satisfaction Survey Please fold here