XEROX Host Forms Description Language 3.2 for IBM MVS Creating Forms HFDL 3.
Xerox Corporation 701 South Aviation Boulevard El Segundo, California 90245 ©1995 by Xerox Corporation. All rights reserved. Copyright protection claimed includes all forms and matters of copyrightable material and information now allowed by statutory or judicial law or hereinafter granted, including without limitation, material generated from the software programs which are displayed on the screen such as icons, screen displays, looks, etc. Printed in the United States of America.
Table of contents Introduction vii About this manual vii Contents vii Conventions viii Related publications viii Xerox publications IBM publications 1. Overview viii ix 1–1 HFDL features 1–1 Prerequisites 1–2 Operating environment 1–2 Hardware requirements 1–2 Software requirements 1–2 Xerox laser printer support 1–2 Centralized printers 1–2 Decentralized printers 1–3 Contrasting HFDL with a typical forms application 1–3 Forms you can create with HFDL 1–4 2.
HOST FORMS DESCRIPTION LANGUAGE Variable data Fonts 2–7 Fixed and proportionally spaced fonts 2–7 Font orientation 2–7 Font orientation when using short–edge paper feed Virtual keyboard and font character maps 2–8 2–9 Virtual keyboard character maps 2–10 Font character maps 2–11 Adding color to forms 2–11 Ink color availability and control 2–11 Choosing paper size 2–12 Forms design ruler 2–12 Ruler scales 2–12 Suggested uses 2–13 3.
TABLE OF CONTENTS DO SECTION command 3–28 COLUMN command 3–30 INTERWORD command 3–30 The interword gap formula 3–30 Specifying the base gap 3–31 Specifying the interword multiplier 3–31 Using SPACING and INTERWORD together 3–31 DOT LEADER command 3–32 LET command 3–33 Relative coordinate 3–33 COMMENT command 3–34 END command 3–35 4. Creating a sample form 4–1 Setting up the form 4–2 Using the sample description command 4–3 5.
HOST FORMS DESCRIPTION LANGUAGE E. Glossary Index vi Supported paper sizes E–1 GLOSSARY–1 INDEX–1 HOST FORMS DESCRIPTION LANGUAGE 3.
Introduction This manual describes the Host Forms Description Language (HFDL) and how you use it to create an electronic version of your form. The HFDL commands and statements you use comprise the Forms Source Language (FSL). The host computer compiles the FSL and stores it in the database. Using the resources management utilities, you can access and print your forms on Xerox laser printing systems (LPS) connected to your host computer.
HOST FORMS DESCRIPTION LANGUAGE Appendix C “Approved abbreviations for reserved words” lists the abbreviations you can use for reserved words. Appendix D “Comparison of HFDL and FDL” compares the commands available for FDL, HFDL 2.1D, HFDL 3.1, and HFDL 3.2. Appendix E “Supported paper sizes” lists the paper sizes that HFDL supports.
INTRODUCTION Publication Number Xerox 4235 Laser Printing System Xerox Distributed Print Mode XES Printer Command Reference 720P82520 Xerox 9790/8790 Laser Printing Systems Reference Manual 720P90000 Xerox Host Forms Description Language 3.
HOST FORMS DESCRIPTION LANGUAGE x HOST FORMS DESCRIPTION LANGUAGE 3.
1. Overview The Host Forms Description Language (HFDL) operates in a standard IBM/MVS environment that includes Xerox high–speed, high–volume centralized printers. You use Xerox Print Resources Manager (XPRM) to store form files and resources in the XPRM database. This chapter describes the HFDL features, prerequisites, operating environment, and the supported printers. Refer to the Xerox Print Resources Manager/Host Forms Description Language 3.
HOST FORMS DESCRIPTION LANGUAGE • Conversion from .FRM to metacode. This feature is implemented as a stand-alone utility program. For details see Appendix D. HFDL also allows you to take advantage of the added features of the Xerox 4650 Printer (600 dpi forms). Prerequisites You should have a working knowledge of your Multiple Virtual Storage (MVS) operating system, and be able to perform the following procedures: • Create and edit a text file on your system. • Use JCL to compile a job on your system.
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.
HOST FORMS DESCRIPTION LANGUAGE only one set of forms at a time, and must remove and replace any forms currently loaded with the preprinted forms you want. The typical forms application usually requires a stock of preprinted forms. If there are different forms, storage costs can be high. If you have to modify preprinted forms, you usually must discard old versions, making your costs even higher.
2. Planning your forms This chapter describes the parameters you must determine and specify when designing your form. Careful planning and design are critical to creating electronic versions of your forms. Form planning and design specify such things as page size, orientation, layout, fonts, inks, and highlight colors. For additional information about designing complex forms and Xerox laser printer capabilities, refer to the “System considerations” appendix.
Figure 2–2. SYSTEM PAGE PHYSICAL PAGE VIRTUAL PAGE NOTE CORRESPONDING EDGES OF PHYSICAL AND SYSTEM PAGES. THIS IS IMPORTANT WHEN CONSIDERING EDGE–MARKING.
PLANNING YOUR FORMS If you decide to place marks along the edge of the physical page (edge–marking) in your form, be familiar with the edge–marking limitations. To accommodate edge–marking, the system page must be larger than the physical page. Since the system page boundaries correspond to at least two edges of the physical page boundaries for all paper sizes, you can only use edge–marking on the two edges of the physical page that do not correspond to the system page.
HOST FORMS DESCRIPTION LANGUAGE Figure 2–3 shows the location of the form origin of the virtual page in relation to the actual page size. Figure 2–3.
PLANNING YOUR FORMS Form element Element origin Fixed text (single line) Upper–left corner of the first character cell when the line appears upright. Fixed text (multiple lines) Upper edge of the topmost character cell and the leftmost edge of the leftmost character cell when viewed in an upright position. Graphics Upper–left corner of the image. Logos and signatures Upper–left corner of the first character cell. Sections (of a form) Upper–left corner of the section.
HOST FORMS DESCRIPTION LANGUAGE If you draw additional lines horizontally and vertically away from the form origin so that each additional line is one unit of measure apart, you create a grid. You can now position form elements by specifying a grid position. Negative coordinates You can use negative x and y values to place the form elements above and to the left of the form origin. You can only specify negative values within the system page boundaries.
PLANNING YOUR FORMS Fonts Fonts are character sets, each having a unique typeface (Times, Roman or Helvetica), type size (points), and type style (normal, bold, or italic). Fonts must reside in the host database and on the printer. Check with your System Administrator to identify the fonts available on your printer. If you specify a font that does not reside in the host database, you receive an error message when you compile the form.
HOST FORMS DESCRIPTION LANGUAGE Figure 2–6 shows the font orientations relative to the physical page. Figure 2–6. Font orientation PORTRAIT FONT LANDSCAPE FONT LANDSCAPE PAGE PORTRAIT PAGE Font orientation when using short–edge paper feed Normally, stock feeds into the printer moving in the direction of the page length.
PLANNING YOUR FORMS Virtual keyboard and font character maps You can create virtual keyboard and font character maps and store them in the XPRM database after installation. During the compilation of forms, you can set the compiler to use the character maps to enable keyboard–to–font character mapping. Use the KEYBOARD parameter of the COMPILE command to specify the keyboard map you want to use.
HOST FORMS DESCRIPTION LANGUAGE You can also use the mapping process to assign a different character to a key. Figure 2–8 shows you how to map a little used keyboard character, such as the cent sign (¢), to a new font character required in your form, the fraction one–half ( ). Figure 2–8.
PLANNING YOUR FORMS Font character maps Once the compiler equates a keyboard code point to a Xerox character identifier, another translation must locate the graphic representation of the character within the font. A font character map identifies the location of each graphic character within a font. The graphic representation is the actual bitmap that prints the character in the form. Usually the character is in ASCII format. For example, hexadecimal code point 41 is the ASCII code for the uppercase A.
HOST FORMS DESCRIPTION LANGUAGE For additional information regarding default ink palettes, catalogs, color models, ink priority and substitutions, and modifying output, refer to the Xerox LPS PDL/DJDE Reference Manual. Choosing paper size Once you determine the actual page size (physical page) available for your printer, you can specify any size within the physical page size for your form. Contact your System Administrator to determine available paper sizes.
PLANNING YOUR FORMS Suggested uses You can use the design ruler for character spacing or line spacing. For example, you can use scale 1 for 10 characters per inch (cpi) or 10 lines per inch (lpi). Typically, you use side 1 of the ruler for measuring impact–printed computer output reports in which the character spacing is 10 cpi (scale 1) and line spacing is 6 lpi (scale 2) or 8 lpi (scale 3). You use side 2 for measuring LPS output. The default spacing for the LPS is 13.6 cpi (scale 5) and 8.
HOST FORMS DESCRIPTION LANGUAGE 2–14 HOST FORMS DESCRIPTION LANGUAGE 3.
3. Using HFDL commands You use the Host Forms Description Language (HFDL) keyword commands to translate your form design into a format for the host computer. The command set representing your form becomes the Forms Source Language (FSL), which the host compiles and stores. You can download the compiled form to a Xerox LPS or XES printer. This chapter describes the HFDL commands and their functions.
HOST FORMS DESCRIPTION LANGUAGE Command format Each HFDL command consists of a command identifier, parameters, and reserved words associated with the function. The following conventions apply: • A semicolon (;) terminates a command. • A comment line begins with the word COMMENT, followed by a comment and semicolon (;). • A blank space separates reserved words and parameters. • Commas are legal only as shown in the command syntax flow charts.
USING HFDL COMMANDS produces 65°. No mapping or translation is done to these characters. You can substitute the exclamation point (!) with any other character by using the LITERAL operand at the COMPILE command. Refer to the "Command Syntax" section in the "Managing and printing sample forms" chapter for information on how to use this operand. • Special characters print only if you type them twice in succession. For example, ‘IT’’S HERE!!’ produces “IT’S HERE!” in the printed version.
HOST FORMS DESCRIPTION LANGUAGE commands, the defaults are used. If you want to include text on the form, you must specify the FONT command. FORM command You must first specify the FORM command when you describe your form. You must also completely contain it in the first record of the form description. Enter a form name between one and six characters. This is the only required parameter in the FORM command. FORM must be the first command of the form file and must precede any comments.
USING HFDL COMMANDS Refer to the output statement PAPER SIZE command in the Xerox LPS PDL/DJDE Reference manual. Figure 3–2 shows the command syntax flow. Figure 3–2. PAPER command syntax ; USLETTER PAPER SIZE IS USLEGAL A3 A4 B4 w units Parameters , BY l units SIZE and IS are optional words you can use for clarity in the long form of the language coding. USLETTER, USLEGAL, A3, A4, and B4 are the standard paper sizes you can use with the Xerox LPS.
HOST FORMS DESCRIPTION LANGUAGE Figure 3–3 shows the command syntax flow. Figure 3–3. LANDSCAPE/PORTRAIT command syntax ; LANDSCAPE PAGE PORTRAIT n SIZE WIDE n , units BY Parameters units IS HIGH LANDSCAPE specifies the landscape form orientation. If you only specify LANDSCAPE, grid units and form origin correspond to the standard grid format (FMT1). PORTRAIT specifies the portrait form orientation.
USING HFDL COMMANDS GRID command Use the GRID command to specify the dimensions of the grid unit and the location of the form origin with respect to the virtual page origin. All HFDL description commands create and place form elements (lines and boxes) relative to the form origin. Figure 3–4 shows the command syntax flow. Figure 3–4.
HOST FORMS DESCRIPTION LANGUAGE The GRID sizes must fall into the boundaries of the physical page. The smallest grid allowed is 1 XDOT by 1 XDOT. The largest grid allowed is 1 physical page by 1 physical page. Y specifies the form origin offset downward from the top–left corner of the virtual page. X specifies the form origin offset to the right of the left edge of the virtual page. units indicates the unit of measure you want when specifying the offset origin.
USING HFDL COMMANDS When you compile a form in LPS format, fonts convert to uppercase. When you compile a form in XES format, fonts do not convert. The system accepts them in uppercase and lowercase. Refer to the “Managing and printing sample forms” chapter. Defaults Examples None. Long form: FONT Font1; There is no short form. ICATALOG command Use the ICATALOG command to specify the ink catalog to be used on highlight and full color printers. The ink catalog is a file that contains color information.
HOST FORMS DESCRIPTION LANGUAGE management” chapter in the XPRM/HFDL 3.2 for IBM MVS Managing Resources manual. Figure 3–7 shows the command syntax flow. Figure 3–7. PALETTE command syntax 'name' PALETTE ; IS Parameter Default Examples name represents the ink palette you use for ink information. Your palette name must not exceed 32 alphanumeric characters, including spaces. Printer default catalog and palette, if you do not specify the PALETTE (highlight color only).
USING HFDL COMMANDS Parameters Inkname identifies all of the inks you use to create your form. If you use a reserved word such as BLACK as an ink name, you must enclose it in single quotes: ’BLACK’. You must also enclose ink names with embedded blanks in single quotes. NOSUBSTITUTION specifies that ink substitutes are not allowed for this ink. If you do not specify this parameter, the printer attempts to substitute another ink. Full color printers ignore this parameter.
HOST FORMS DESCRIPTION LANGUAGE IRESULT command The color result you receive from overlapping objects is either black or color for the entire page. The IRESULT command allows you to specify the result when objects imaged with different inks overlap. The IRESULT command appears in the HFDL, FDL, and PDL OUTPUT statements and DJDE. You can use the IRESULT command only on a Xerox highlight color printer. Figure 3–10 shows the command syntax flow. Figure 3–10.
USING HFDL COMMANDS • • COMMENT END. You must place coordinates within the boundaries of the physical page. If coordinates stay within the physical page, but extend beyond the virtual page, HFDL issues a warning message. The size of the lines table, currently set at 1,500, determines the maximum number of lines and boxes. Text must fit on the physical page. You can enter up to 4,096 characters in a text block.
HOST FORMS DESCRIPTION LANGUAGE represents the origin in the horizontal direction (x–axis coordinate). units indicates the unit of measure for specifying the line origin. The units are INCHES, CENTIMETERS, DOTS, and XDOTS. You can use two decimal places when you specify inches and centimeters. You must express DOTS and XDOTS in integers. DRAW is an optional reserved word. The number of lines you want drawn on your form is n. HORIZONTAL or VERTICAL specifies the direction of your lines.
USING HFDL COMMANDS the BOX command allows you to outline the frame of the box in color. Figure 3–12 shows the BOX command syntax flow. Figure 3–12. AT Cy , units BOX command syntax BOX Cx units p IN units units n DRAW q , WIDE BOXES units HIGH BY USING HAIRLINE 0 1 2 SOLID BROKEN DOTTED INK n USING n INK FILL USING AND SHADING USING LIGHT MEDIUM HEAVY ; EVERY REPEAT AND Ci units HORIZONTALLY VERTICALLY AT Ca units , HOST FORMS DESCRIPTION LANGUAGE 3.
HOST FORMS DESCRIPTION LANGUAGE Parameters Cy specifies the y–axis coordinate for the box origin location. Cx specifies the x–axis coordinate for the box origin location. units indicates the unit of measure for specifying the box origin. The units are INCHES, CENTIMETERS, DOTS, and XDOTS. You can use two decimal places when you specify inches and centimeters. You must express DOTS and XDOTS in integers. The number of boxes you want to draw is n.
USING HFDL COMMANDS TEXT AT command Use the TEXT AT command to incorporate text into your form. To include text in a form, you must specify at least one font. You use the FONT setup command to specify the font, and you can only specify one FONT command. The fonts you specify with the FONT command are referenced as an index number. They are not referenced as their font name. Font index numbers begin with 1 for the first font you specify, 2 for the second, and so on.
HOST FORMS DESCRIPTION LANGUAGE Figure 3–13 shows the TEXT AT command syntax flow. Figure 3–13. TEXT AT command syntax TEXT n HORIZONTAL VERTICAL units SPACED PER LINE POINTS LPI LEFT RIGHT ALIGNED COLUMN CENTER IN TOP BOTTOM JUSTIFIED FONT n USING AT AND Cy units n INK , USING Cx units ; ’text’ LEADER DOT 3–18 FONT USING n NEW LINE HOST FORMS DESCRIPTION LANGUAGE 3.
USING HFDL COMMANDS Parameters HORIZONTAL or VERTICAL specifies the direction of the text relative to the page orientation. SPACED defines the amount of vertical space (in n units) a line of text occupies. If you specify a value (not zero), it replaces the line spacing value of the font being used for this TEXT AT command. An LPI value specifies line height in terms of lines per inch. All other specifications are actual line height measurements. The n units value must be positive.
HOST FORMS DESCRIPTION LANGUAGE Example Text justified in a column: COLUMN 1 INCH WIDE; TEXT JUSTIFIED IN COLUMN AT 1,1 ‘four four four five five five six six six’ This produces the following text on the form: four four five five six six four five six FONT n specifies the index number of the font you selected. Refer to the FONT command for additional information. INK n specifies the index number of the ink color you selected from the ink list to use with a Xerox highlight or full color LPS printer.
USING HFDL COMMANDS Single dots repeated, if you do not use a DOT LEADER command to specify the DOT LEADER text string. Examples The following is an example of a DOT LEADER used between two text strings: TEXT AT 1,1 ’John Doe’ DOT LEADER ’987–6543’; This produces the following text on the form: John Doe......................................................
HOST FORMS DESCRIPTION LANGUAGE Figure 3–14 shows the TEXT IN BOX command syntax flow. Figure 3–14.
USING HFDL COMMANDS Parameters HORIZONTAL or VERTICAL specifies the text orientation of the text within the box. Do not confuse TEXT alignment with TEXT placement in the box. You can align horizontal text LEFT or RIGHT. You can align vertical text TOP or BOTTOM. SPACED defines the amount of vertical space (in n units) you want a line of text to occupy. If you specify a value (not 0), it replaces the line spacing value of the font being used for this TEXT AT command.
HOST FORMS DESCRIPTION LANGUAGE Do not use DOT LEADER in the JUSTIFIED mode. DOT LEADER overrides any alignment mode and places the text flush with the column boundaries. USING FONT n specifies a change of font for the next body of text which is not the dot leader string. When you specify dot leaders and a change of fonts together, the DOT LEADER keywords must precede the FONT n keywords. NEW LINE specifies a new line to follow a text string. You can only use the NEW LINE keyword once between text strings.
USING HFDL COMMANDS Examples Long form: HORIZONTAL TEXT SPACED 12 POINTS PER LINE USING FONT 1 AND USING INK 1 IN CENTER CENTER BOX 4 3 ‘FIRST’ ‘NATIONAL’ ‘TRUST’ IN NEXT HORIZONTAL BOX ‘FIRST’ ‘DEPOSIT’ ‘INSURANCE’; Short form: TEXT 12 POINTS INK 1 IN BOX 4 3 ‘FIRST’ ‘NATIONAL’ ‘TRUST’ BOX ‘FIRST’ ‘DEPOSIT’ ‘INSURANCE’; LOGO command Use the LOGO command to place logos in the form.
HOST FORMS DESCRIPTION LANGUAGE INK n specifies the ink number from the ink list that overrides the corresponding ink specified in the ink list of the logo file. If the logo has a NOSUBSTITUTION flag, then ink overrides are not allowed (highlight color only). When you incorporate a logo into your form, make sure you do not exceed the font memory capacity. Default None. Examples Long form: LOGO NEW1 AT 1,1 USING INK 3; There is no short form. GRAPHIC command A form may consist only of graphic images.
USING HFDL COMMANDS Examples Long form: GRAPHIC SYMBOL AT 1,1 SCALE IS 4 USING INK 3; There is no short form. SECTION command Use the SECTION command when a form consists of identical blocks of commands. You can save time by defining one section and then repeating it at the locations you want. You can also use this command to define an entire form as a section.
HOST FORMS DESCRIPTION LANGUAGE Examples Long form: BEGIN SECTION NUSEC; LOGO NEW0 AT 0,0 USING INK 2; TEXT AT 1,1 USING FONT 3 AND INK 1 ’Acme Weather Balloons’ END SECTION; There is no short form. SECTION definitions The BEGIN SECTION command informs the compiler that what follows includes the END SECTION command and lines up to form a logical collection of commands that may be invoked as needed to build a complete form.
USING HFDL COMMANDS Figure 3–20. DO DO SECTION command syntax name n SECTION Cy units AT , TIMES Cx units ; EVERY REPEAT AND Ci units HORIZONTALLY VERTICALLY AT Ca units , Parameters name specifies the name of the section you want to invoke. n TIMES specifies the number of times you want the section repeated. Cy specifies the y–axis where you want the section origin located. Cx specifies the x–axis where you want the section origin located.
HOST FORMS DESCRIPTION LANGUAGE COLUMN command Use the COLUMN command to establish the column width when you specify TEXT ALIGNED JUSTIFIED IN COLUMN. You can also use the COLUMN command to establish a right boundary for the DOT LEADER command. Parameters units indicates the unit of measure for the column width. The units are INCHES, CENTIMETERS, DOTS, and XDOTS. You can use two decimal places when you specify inches and centimeters. You can express DOTS and XDOTS only in integers.
USING HFDL COMMANDS Specifying the base gap The base gap for text not fully justified is always ASCII code point X‘20’, the “blank”. The base gap for fully justified text is determined by the SPACING operand of the COMPILE command. If SPACING is specified in the JCL for such a job, the base gap is the EN space. If SPACING is specified in the JCL for a job which does not include fully justified text, SPACING is not used, and the base gap remains ACSII code point X‘20’, the “blank”.
HOST FORMS DESCRIPTION LANGUAGE Table 3-1. Determining interword The interword multiplier: applied to the base gap, specified by: INTERWORD .5 no SPACING operand 0.5 * the width of ASCII code point X‘20’ INTERWORD .5 COMPILE SPACING1 0.5 * the EN space INTERWORD 1.0 no SPACING operand 1.0 * the width of ASCII code point X‘20’ INTERWORD 1.0 COMPILE SPACING1 1.0 * the EN space (no INTERWORD command specified, defaults to 1.0) no SPACING operand (1.
USING HFDL COMMANDS Sample strings you can use are as follows: ’ .’ ’*’ ’–.’ ’xo’ produces . . . . . . . . . . . . . . . . . . . . . . . . . produces ***************************** produces –.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–.–. produces xoxoxoxoxoxoxoxoxoxoxoxoxoxoxoxo LET command Use the LET command to define variable names. You can specify all x and y coordinates with either literal values or variable names. If you use variable names, you must first define them with the LET command.
HOST FORMS DESCRIPTION LANGUAGE down, you only have to change the initial values. You can shift text automatically when you add or delete text items. HFDL uses spaces to delimit keywords. Therefore, relative coordinates must not contain spaces between the variable name Y1 and the value +.5. Figure 3–25 shows the variable syntax flow. Figure 3–25. Relative coordinate syntax n – identifier + – Parameters n identifier is the variable name you specify for the relative coordinate.
USING HFDL COMMANDS Examples Long form: COMMENT ***HFDL IS ABLE TO DESCRIBE MANY TYPES OF FORMS***; There is no short form. END command Use the END command to terminate a form description. Figure 3–27 shows the command syntax flow. Figure 3–27. END command syntax END Parameter Default Example ; END specifies an end–of–file condition from the source input disk file or from the input data stream. There is no default for the END command. It is an optional command. Long form: FORM HFDL1; ...............
HOST FORMS DESCRIPTION LANGUAGE 3–36 HOST FORMS DESCRIPTION LANGUAGE 3.
aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaaaaaa aaaaaa
HOST FORMS DESCRIPTION LANGUAGE Setting up the form Follow these steps to set up the basic elements of your form: 1. Use the FORM command to specify both a unique form name that identifies the form to the system and a resolution. In this example, the form name is XEROX2 and the resolution is 300 SPI. FORM XEROX2, RESOLUTION IS 300 SPI; 2. Specify the physical paper size. This example specifies U.S. letter size: PAPER SIZE IS USLETTER; 3. Specify the grid unit and form origin.
CREATING A SAMPLE FORM Since the sample form uses the default resolution, default physical page size, and default grid format, you can omit these commands. This example shows entering all of the setup commands required in their short form: FORM XEROX2; FONTS UN214A, UN107A, UN104A; Using the sample description command After you finish setting up the sample form, follow these steps to enter descriptive data: 1. Draw 14 parallel horizontal lines as shown.
HOST FORMS DESCRIPTION LANGUAGE If you omit optional keywords and system defaults, the short form of the command looks like this example: AT 7 14 LINES –1 TO 132 EVERY 4; 2. -1 Draw 15 parallel vertical lines as shown.
CREATING A SAMPLE FORM 4. Position the title in the center of the invisible box. This example shows the long form of the TEXT IN BOX command: HORIZONTAL TEXT ALIGNED CENTER USING FONT 1 IN CENTER BOX 2, –1 ’COMPOSITE STOCK INVENTORY STATUS REPORT’; The TEXT IN BOX command places the title COMPOSITE STOCK INVENTORY STATUS REPORT in the center of the box whose upper left corner begins at character row 2, at character position –1.
HOST FORMS DESCRIPTION LANGUAGE This example shows the short form of the command: TEXT FONT 2 IN BOX 7, –1 ’CAT’ ’NO’ BOX ’ITEM’ ’NO’ BOX ’DESCRIPTION’ BOX ’REOR’ ’POINT’ BOX ’REOR’ ’QTY’ BOX ’OPEN’ ’STOCK’ BOX ’VENDOR’ ’RECEIPTS’ BOX ’STOCK’ ’ORDERS’ BOX ’COMM’ ’STOCK’ BOX ’SALES’ ’ISSUES’ BOX ’BACK’ ’ORDERS’ BOX ’VENDOR’ ’RETURNS’ BOX ’STOCK’ ’TRANSFERS’ BOX ’CURRENT’ ’STOCK’; 6. Apply shading to the form.
5. Managing and printing sample forms When you have created your form design using Host Forms Description Language (HFDL) commands, you can compile, batch process, store, and print a sample of it. After this process completes, your form becomes available for use. This chapter describes the COMPILE command and the job control language (JCL) to invoke the HFDL compiler.
HOST FORMS DESCRIPTION LANGUAGE Parameters FSL is the only valid resource you can use. FSL=DDname[(PDS member name)] where DDname = XFFSL and PDS member name is the member name of the PDS where the FSL is stored. The DDname can be either a sequential or a partition data set. When the DDname is sequential, the PDS member name is not applicable. Operands LISt produces the full compiler listing. To specify no listing, delete this operand. VERsion=Other specifies the form version you want to compile.
MANAGING AND PRINTING SAMPLE FORMS Table 5-1. Determining interword gap The interword multiplier: applied to the base gap, specified by: INTERWORD .5 no SPACING operand .5 * the width of ASCII code point X‘20’ INTERWORD .5 COMPILE SPACING1 .5 * the EN space INTERWORD 1.0 no SPACING operand 1.0 * the width of ASCII code point X‘20’ INTERWORD 1.0 COMPILE SPACING1 1.0 * the EN space (no INTERWORD command specified, defaults to 1.0) no SPACING operand (1.
HOST FORMS DESCRIPTION LANGUAGE MEMber=selection specifies which member(s) you want to compile. Specify only one member by using the exact member name for selection. Specify a group of members by using a DOS style command such as * and ?. Specify all members in the partition data set by substituting selection with *. FORm=selection specifies which member(s) you want to compile in a multi-form file. Specify only one form by using the exact form name for selection.
MANAGING AND PRINTING SAMPLE FORMS Command syntax examples Figure 5–3 shows an example of the command you use to compile a form called MYFORM where the DDname is XFFSL and the database will store the compiled form. Figure 5–3. Sample COMPILE syntax COMpile FSL=XFFSL(MYFORM) LISt OBJect This example compiles MYFORM with a full compiler report in version 2 format. The example in Figure 5–4 shows compiling MYFORM without a compiler listing.
HOST FORMS DESCRIPTION LANGUAGE Figure 5–7. BATCH command syntax BATCH DDname[(PDS member name)] The PDS member name identifies the file that contains the COMPILE commands. The PDS member must be in the same data set as the FSLs you are compiling. If you are compiling forms in the XYZFORMS data set, and the DDname is XFFSL, you can create the batch command statement. Figure 5–8 shows an example of the BATCH command with XFFSL as the DDname and BATCH01 as the PDS member name. Figure 5–8.
MANAGING AND PRINTING SAMPLE FORMS Table 5–5 identifies the DDnames that the compiler uses to reference data sets for decentralized printers. Table 5–5. Resource DDnames for decentralized printers DDname Description XSFNTATT Data set containing font and logo attributes. XSFORMS Data set containing forms. Each record contains a resource occurrence in Xerox LPS printer file format – XES. XSFRMATT Data set containing form attributes. XSCLRATT Data set containing color attributes.
HOST FORMS DESCRIPTION LANGUAGE Table 5–7 identifies the DDnames and the statements required in addition to the resource data sets for decentralized printers. Table 5–7. DDname HFDL execution DDnames for decentralized printers Description SYSPRINT Writes the compiler listings when the LIST parameter of the COMPILE command is coded. Compile errors and the copyright message are written to SYSPRINT as well. SYSTERM Indicates a malfunction. Contact your system administrator.
MANAGING AND PRINTING SAMPLE FORMS If you want to download and print a form sample following the compilation, the DDnames listed in Table 5–8 are required. Table 5–8. Data sets required to download and print DDnames Description XSUIN XPRM Utility commands are read from the file specified by the XSUIN DD statement. XSUIN may specify either instream data or reference a sequential data set or a member of a partitioned data set (PDS). XSUACTL All messages from the XPRM utility are written to XSUACTL.
HOST FORMS DESCRIPTION LANGUAGE Figure 5–9 shows an example of the JCL you use to compile a form and store it in the database. Figure 5–9. Invoking the HFDL compiler //LOGONIDX //* /*JOBPARM JOB ’RUN HFDL COMPILER’,REGION=8M user job card parameters //STEP1 //STEPLIB // EXEC PGM=HFDL32,PARM=’COMPILE FSL=XFFSL(XVERL) LIST OBJECT’ DD DSN=HFDL.V3R2M00.LOAD,DISP=SHR DD DSN=XPRM.V3R2M00.SASCRDLB.
MANAGING AND PRINTING SAMPLE FORMS Figure 5–10. Downloading and printing a sample //LOGONIDX //* /*JOBPARM JOB ’RUN HFDL COMPILER’,REGION=8M user job card parameters //STEP1 //STEPLIB // // EXEC DD DD DD //SYSPRINT //SYSTERM //* DD SYSOUT=* DD SYSOUT=* ****The following data sets are specific to the form compiler //* //XFLOG //* DD LINE=0 PGM=HFDL32,PARM=’COMPILE FSL=XFFSL(XVERL) LIST OBJECT’ DSN=HFDL.V3R2M00.LOAD,DISP=SHR DSN=XPRM.V3R2M00.SASCRDLB.C550,DISP=SHR DSN=XPRM.V3R2M00.
HOST FORMS DESCRIPTION LANGUAGE Accessing compiled forms Use the XPRMUTIL utility to access a compiled form for deletion, sample printing, or downloading to Xerox LPS printers. If you are not familiar with this utility, contact your System Administrator or refer to the Xerox Print Resources Manager/Host Forms Description Language 3.2 for IBM MVS Managing Resources manual.
6. Messages This chapter lists the error messages that appear when problems occur, an indication of the cause of the message, and the action you can perform to correct the problem. Message indicators The letters in the error numbers indicate the severity of the error as follows: XFG6001F Action Action F (fatal) indicates a serious error that can prevent you from compiling your form or may abnormally end (ABEND) your session.
HOST FORMS DESCRIPTION LANGUAGE XFG6005W Group name too long, using Indication Action XFG6006W Action Action Action Action Action Action Check and modify the JCL. the paper size incountered could no be identified. Make sure that the paper size value is one of the following: LT, LG, A3, A4, or B4, and then rerun the job. The compiler parsed a keymap id that exceeded the maximum eight characters. Specify a keymap id that is eight characters or less. There is a serious system error.
MESSAGES XFG6013F Cannot open FSL Indication Action XFG6014F Action There is a serious system error. The compiler was not able to obtain a scratch file used during compilation. Verify that the file name is correct and rerun the job. If the problem persists, contact your System Administrator. There are N forms compiled Indication Action XFM8nnn Verify that the file name is correct and rerun the job. If the problem persists, contact your System Administrator.
HOST FORMS DESCRIPTION LANGUAGE XFP1001W Action -013 Invalid format -014 Invalid format -015 Invalid format -016 Invalid format -017 Invalid format -018 Invalid format -019 Invalid format -020 Data overflow -021 Insufficient input parameters -022 Resources overflow -023 Error writing FRM file -024 Not found -025 Error opening IFF file -026 Error opening FRM file -027 Invalid
MESSAGES XFP1003W XFP1004W Character not in FDL alphabet Indication A character was found in the FSL statements that does not exist in the FSL alphabet. The character was ignored. Action Verify that the character does not belong in the FSL statements, then move or delete it. DRAW N and REPEAT EVERY disagree, using 2 Indication Action XFP1005W Action Action Action An invalid line weight was entered. The compiler substituted a value of HAIRLINE.
HOST FORMS DESCRIPTION LANGUAGE XFP1010W Box not found Indication Action XFP1012W XFP1014W Indication A fraction was entered where an integer was expected. The integer part of the number is used. Action Change fraction to an integer value and recompile the form. Invalid resolution, using 300 spi Action Action Action XFP1020W The terminating code character is missing at the end of the text string. If you entered the text correctly, this could indicate a damaged file.
MESSAGES XFP1021W Setup command out of sequence Indication Action XFP1022W Action XFP1025W The section name used exceeds the maximum 16 characters allowed. Action None required. The system truncates the section name at 16 characters. Logos not supported for XES forms You used the LOGO command while generating an XES form. In this release, logos are treated as fonts in XES forms. Do not use the LOGO command while generating XES forms or, if possible, enter the logo as a font.
HOST FORMS DESCRIPTION LANGUAGE XFP1029W No substitution allowed for Logo Indication Action XFP1030W Action Action Action Action Action Action Resize the column width to fit the physical page boundary. The specified command segment contains a syntax error. Correct the error and recompile the form. The DRAW and REPEAT AT counts do not agree. Correct and recompile the form. The number of TIMES and the REPEAT AT counts do not agree. Correct and recompile the form.
MESSAGES XFP3005E XFP3006E Vertical text inconsistent with left/right Indication Vertical text is aligned LEFT or RIGHT instead of TOP or BOTTOM. Action Correct the text direction with the proper ALIGNMENT. Identifier exceeds 6 characters Indication Action XFP3007E Action Action Action Action Move the setup command to the beginning part of the FSL. Some of the characters in this font have a zero width value. Reload the font. A DO SECTION command was found within a section.
HOST FORMS DESCRIPTION LANGUAGE XFP3014E Value out of range Indication Action XFP3015E XFP3016E Indication You sequenced a keyword incorrectly. Action Enter the keyword in the correct order. FONT command not defined Action Action Action Action Correct the font number to a value within the range of fonts defined, or define a new font if the font is missing from the font list. Inks are referenced in the form and there is no INK command specified.
MESSAGES XFP3021E Font name exceeds 20 characters Indication Action XFP3024E Action Action Action Action Action The width of the box was zero. Correct the box width and recompile the form. The height of the box was zero. Correct the box height and recompile the form. The text went off either the top, bottom, left, or right of the physical page. Correct the text coordinates so the text does not extend beyond the physical page.
HOST FORMS DESCRIPTION LANGUAGE XFP4006F Cannot open FSL Indication Action XFP4009F Action Action Action Action Action Action Delete the number of fonts used so the maximum of 32 is not exceeded and recompile the form. There is a serious system error. The compiler was not able to obtain a scratch file used during compilation. Verify that the file name is correct and rerun the job. If the problem persists, contact your System Administrator.
MESSAGES XFP4030F Database access fault: mode = Indication Action There is a serious system error. The compiler was not able to access the resource database for the reason based on the return code. Contact your System Administrator with the return code (rc) number.
HOST FORMS DESCRIPTION LANGUAGE 6–14 Return code Description -187 File not open -188 File system warning (see error codes) -189 Identifier already exists -190 Invalid array specification -191 Invalid array starting position -192 Invalid buffer length -193 Invalid buffer pointer -194 Invalid value, buffer pointer -195 Invalid CID -196 Invalid data list resource -197 Invalid data set name -198 Invalid element data -199 Invalid element for resource -200 Invalid element type -201
MESSAGES Return code Description -218 Invalid read mode -219 Invalid resource -220 Invalid resource pointer variable -221 Invalid return pointer variable -222 Invalid security type flag -223 Invalid element value -224 Lock request failed -225 Validation check failed -226 Maximum query lists has been exceeded -227 Maximum data lists has been exceeded -228 Missing data on a retrieval request -229 Missing segment number -230 Security request made on resource with no BLOBs -231 Upd
HOST FORMS DESCRIPTION LANGUAGE 6–16 Return code Description -247 Outstanding resource sharing already exists -248 Access security errors detected but processing continued -249 Data stack full -250 Duplicate element in list -251 Duplicate automatically generated data list -252 Verification routine has detected an invalid element value -253 Data dictionary not loaded -254 Caller supplied an invalid resource name -255 Caller supplied an invalid element name -256 Caller supplied too many
MESSAGES XFP4034F Return code Description -272 Physical files containing attribute records opened -273 Physical files containing attribute and secured BLOB opened -274 Physical files containing attribute and nonsecured BLOB opened -275 Partial deallocation has occurred -276 No outstanding resource sharing currently exists -277 Database verification KEY1 -278 Database verification DD name -279 Database verification file segment -280 Database verification key size -281 Database verifica
HOST FORMS DESCRIPTION LANGUAGE XFP4040F Text string exceeds buffer limits Indication Action XFP4050F Action Action Action Action Action Action Specify a keymap id that is eight characters or less. Your FSL uses more than the maximum 255 inks (colors) allowed. Reduce the number of inks in your FSL to 255 or less. You made an invalid use of the LET command. An identifier cannot be on both the right–hand and left–hand side of the assignment statement.
MESSAGES XFP4064F Query List Error Indication Action XFP4065F Action Action Action Action Action Action Contact your System Administrator. There is a serious system error. Contact your System Administrator. There is a serious system error. Contact your System Administrator. There is a serious system error. Contact your System Administrator. Can not add BLOB Indication Action XFP4080F There is a serious system error.
HOST FORMS DESCRIPTION LANGUAGE XFP4081F Can not open Database. Check DB reference. Indication Action XFP4082F Action Action Action Action Action Action Contact your System Administrator. You specified a virtual keyboard character map for this font which cannot be found. Contact your System Administrator. No character map has been specified for this font. Contact your System Administrator. There is a serious system error.
MESSAGES XFU4030F Database access fault: mode= Indication Action XFU4060F Action Action Action Action Action There is a serious internal error. Contact your System Administrator and indicate the error number. There is a serious internal error. Contact your System Administrator and indicate the error number. There is a serious internal error. Contact your System Administrator and indicate the error number.
HOST FORMS DESCRIPTION LANGUAGE XFU4067F Attribute data list Error Indication Action XFU4068F Action Action Action Action Action Action Contact your System Administrator and indicate the error number. There is a serious internal error. Contact your System Administrator and indicate the error number. There is a serious internal error. Contact your System Administrator and indicate the error number. The XES generator completed successfully. None.
MESSAGES XFX0002F Memory allocation error Indication Action XFX0003F XFX0004F Indication The system has failed to open a file. Action Contact your System Administrator. Invalid record format Action Action Action Action Action The system found an error in the IFF file. Contact your System Administrator. The system found an error in the IFF file. Contact your System Administrator. The system found an error in the IFF file. Contact your System Administrator.
HOST FORMS DESCRIPTION LANGUAGE XFX0011F Invalid record format Indication Action XFX0012F Action Action Action Action Action Action Action The system found an error in the IFF file. Contact your System Administrator. The system found an error in the IFF file. Contact your System Administrator. The system found an error in the IFF file. Contact your System Administrator. There is a programming error. Contact your System Administrator.
MESSAGES XFX0023F Error opening XES file Indication Action XFX0024F Action Action Action Action Action Action Contact your System Administrator. The system failed to open a temporary sorted IFF file. Contact your System Administrator. The system failed to open a temporary sorted work file. Contact your System Administrator. You specified a keyboard name of more than eight characters. Use the keyboard name specified when you invoke HFDL.
HOST FORMS DESCRIPTION LANGUAGE XFX0033W Possible print errors ... no character map for font Indication Action XFX0034F Action Action Action Action Action Action Action The system found an error in the IFF file. Contact your System Administrator. The system found an error in the IFF file. Contact your System Administrator. The system cannot locate an ink match in the XPRM color map database. The system is substituting black ink.
MESSAGES EXIT Terminating due to internal error Indication Action There is a serious internal error. Contact your System Administrator. HOST FORMS DESCRIPTION LANGUAGE 3.
HOST FORMS DESCRIPTION LANGUAGE 6–28 HOST FORMS DESCRIPTION LANGUAGE 3.
A. System considerations Consider the following items when designing and planning your form: • • • • • Line density limits Local density limits Superimposed edges when adjoining boxes Text size in boxes Lines with sections. These items are especially important when designing complex forms. You can avoid error messages and save the time it takes to correct the problems by being aware of the system considerations described in this appendix.
HOST FORMS DESCRIPTION LANGUAGE If you have described a form that causes a page setup error, examine both the form and the variable data to see if there are many lines or a large amount of text in a small area. If you encounter this type of error, reduce the density of the area by spreading the material out on the form or by deleting parts of the form. Boxes and their image You can draw boxes with just a single box statement or with line–by–line statements.
B. FMT grid format properties This appendix lists the FMT parameters you use in the LANDSCAPE/PORTRAIT and GRID commands. It includes the FMT properties for 8.5 by 11–inch paper, 8.5 by 14–inch paper, and A4 paper. The FMT defaults are FMT1 (landscape) and FMT6 (portrait). Table B–1 lists the grid and origin substitutions you can use when you print on 8.5 by 11–inch paper. Table B–1. FMT properties for 8.5 by 11–inch paper Specification Substitution FMT1 LANDSCAPE; GRID UNIT IS 13.6 CPI, 8.
HOST FORMS DESCRIPTION LANGUAGE Table B–2 lists the grid and origin substitutions you can use when you print on 8.5 by 14–inch paper. Table B–2. Specification FMT properties for 8.5 by 14–inch paper Substitution FMT12 LANDSCAPE; GRID UNIT IS 13.6 CPI, 8.1 LPI, ORIGIN 0.18 INCH, 0.66 INCH; FMT13 PORTRAIT; GRID UNIT IS 13.6 CPI, 8.1 LPI, ORIGIN 0.57 INCH, 0.58 INCH; Table B–3 lists the grid and origin substitutions you can use when you print on A4 paper. Table B–3.
C. Approved abbreviations for reserved words Abbreviations can be helpful in reducing the number of characters or lines you need to describe a function or command. However, while abbreviations are helpful, they can create problems if you do not use them properly. If you use abbreviated reserved words, make sure they are identical to those in the approved list. The following list contains approved abbreviations for reserved words.
HOST FORMS DESCRITION LANGUAGE C–2 HOST FORMS DESCRITION LANGUAGE 3.
D. Comparison of HFDL and FDL This appendix compares commands available for HFDL 2.1D, HFDL 3.1, HFDL 3.2, and FDL, as shown in Table D–1. Table D–1. Command/Feature Command comparison matrix HFDL 2.1D HFDL 3.1 BATCH HFDL 3.
HOST FORMS DESCRIPTION LANGUAGE D–2 HOST FORMS DESCRIPTION LANGUAGE 3.
E. Supported paper sizes You can design forms for a variety of paper sizes, however, you must be aware of the paper sizes your printer supports. Even though HFDL supports a paper size, it may not be available or supported by your printer. If you are not sure of the size of paper your printer supports, contact your System Administrator. Table E–1 lists the paper sizes that HFDL supports. Table E–1. Paper sizes available for HFDL Paper size (inches) HFDL designation 8.5 by 11 USLETTER 8.
HOST FORMS DESCRIPTION LANGUAGE E–2 HOST FORMS DESCRIPTION LANGUAGE 3.
Glossary 871 CM abort Xerox 871 Communications Module. Provides a low–cost, remote communication interface to Xerox printers. To prematurely terminate the printing of a job, execution of a program, or execution of a nonprinting task. algorithm A step by step procedure for solving a problem. alignment Positioning of an image on a page for printing. alphanumeric ASCII application application software Set of letters and whole numbers. American Standard Code for Information Interchange.
HOST FORMS DESCRIPTION LANGUAGE bit Binary digit. Smallest unit of information recognized by a computer. Numeric digits of 1 or 0 represent the binary scale of notation. In computers and related devices, the binary numeric values can be represented by a positive or negative electrical pulse. As a general rule, 1 equals ON, TRUE, or YES; and 0 (zero) equals OFF, FALSE, or NO. A number of bits strung together can represent a character to the computer.
GLOSSARY character cell Digitized space containing a single character within a font set. character code Code representing alphanumeric information, such as ASCII. character map Grid of blocks, where each block corresponds to a letter, number, punctuation mark, or special character.
HOST FORMS DESCRIPTION LANGUAGE control program Program that supports the operating system by monitoring the flow of jobs, tasks, processing, and so forth, within the system. coordinate Point on the x–axis and y–axis that determines a grid position. copy copy–sensitive Term used to indicate jobs in which multiple copies of a report will contain different data, such as paychecks and banking statements. data 1.
GLOSSARY duplex easy values elite embedded blanks enabler escapement EBCDIC Printing or copying on both sides of the paper. See also simplex. Font point sizes, orientations, and names explicitly defined in Font Interchange Standard (FIS). Smallest size standard typewriter type: 12 characters per horizontal inch. See also pica. Blank spaces within a command line. Hardware devices or software packages that allow the printer to perform as specified or better.
HOST FORMS DESCRIPTION LANGUAGE form form feed format Keyboard printer control character that causes the printer to skip to the top of the next page. 1. Layout of a document, including margins, page length, line spacing, typeface, and so forth. 2. In data storage, the way the surface of a disk is organized to store data. 3. To prepare the surface of a disk for the acceptance of data. FDL Forms description language.
GLOSSARY input devices input output (I/O) input processing insert interface Interpress Keyboards, magnetic media, or any device used to give a system information. General term encompassing the flow of data into and out of a computer system. Formatting control for the pages of a report. To add text or graphics to a document. Device by which two systems connect and communicate with each other. Xerox standard that defines digital representation of lines for printing.
HOST FORMS DESCRIPTION LANGUAGE library line One horizontal flow of characters. line feed Control character that causes the printing system to begin printing in the current character position of the next line (unless set to be interpreted as an end of line). line printer High–speed printer that prints an entire line of characters at the same time. line tables Internal data structures that provide a record in memory of the line to be drawn on a page.
GLOSSARY MVS national use characters nonimpact printer Multiple Virtual Storage. Operating system that supports the IBM System 370 hardware. MVS is designed to handle large scale production batch applications. Includes the @, $, and # sign. The system recognizes the hexadecimal representations of the U.S. national characters: @ as X‘7C’; $ as X‘5B’; and # as X‘7B’. In some countries, the keyboard–generated characters may generate different hexadecimal representation and cause errors.
HOST FORMS DESCRIPTION LANGUAGE pixel Acronym for picture element. Smallest addressable point of a bitmapped screen that can be independently assigned color and intensity. Pixels are definable locations on a display used to form images. For graphics displays, more pixels generally provide higher resolution. Spots, dots, and pixels are used interchangeably. point Unit of measurement equal to 0.0139 inch. Points are always used to express type, size, and leading.
GLOSSARY recovery remote access replace resolution resource RSTACK save scale simplex software sort source file Act of overcoming a problem or error during processing. Typically, a specialized software recovery routine gains control and attempts to resolve the error without crashing the system. Access to a central computer by terminals or devices geographically separated from the computer. Process of exchanging one portion of text or symbols with another.
HOST FORMS DESCRIPTION LANGUAGE syntax syntax error system system disk sysgen (system generation) system page system software System response to a mistake in structure of expression. 1. In data processing, a collection of parts and procedures organized to accomplish a set of specific functions. 2. Assembly of components united by some form of regulated interaction to form an organized whole. 3. Operation or procedures through which a business activity is accomplished.
GLOSSARY type size type style UCS variable Height of a typeface expressed in points (measured from the bottom of its descenders to the top of its ascenders). Italic, condensed, bold, and other variations of typeface that form a type family. Universal Character Set. Printer feature that permits the use of a variety of character arrays. Information of a changeable nature that is merged with a standard or a repetitive document to create a specialized or personalized version of that document.
HOST FORMS DESCRIPTION LANGUAGE GLOSSARY–14 HOST FORMS DESCRIPTION LANGUAGE 3.
Index Numerals 4135 printer, SEF, 2–2 4700 Color Document Printer, 2–3, 2–11 871 Communications Module (CM), 1–2 A abbreviating, reserved words , 3–2, C–1 accessing compiled forms, 5–12 alignment, 3–19 ASCII format, 2–11 B BARR SNA, 1–2 BATCH command, 5–5 to 5–6 batch processing, COMPILE command, 5–5 to 5–6 bitmaps, 2–11 BOX command, 3–14 to 3–16 boxes images, A–2 text, see TEXT IN BOX command BSC/RJE communications link, 1–3 C catalog, ink, 2–11 to 2–12 centralized font card, 3–8 printers, 1–2 to 1–3, 5–6
INDEX form elements, positioning, 2–4 to 2–5 orientation, 3–5 origin, 2–3 formats ASCII, 2–11 commands, 3–2 to 3–3 determining, 2–1 to 2–6 inkname, 3–11 XES, 3–9 forms color, 2–11 to 2–12 compiled, accessing, 5–12 data, 2–6 design ruler, 2–12 to 2–13 existing, editing, 5–12 HFDL application, 1–3 to 1–4 monochrome, specifying, 5–12 planning, 2–1 to 2–13 samples, 4–1 to 5–12 setting up, 3–3 to 3–12, 4–2 to 4–3 types, 1–4 FORMS command, 3–4 Forms Description Language, see FDL Forms Source Language, see FSL fr
INDEX P page frames, 2–2 to 2–3 orientation, 2–1 to 2–2 setup errors, A–1 to A–2 palette, 2–11 to 2–12 PALETTE command, 3–9 to 3–10 PAPER command, 3–4 to 3–5 paper size, 2–3, 2–12, 3–4 to 3–5, E–1 physical page , 2–2 to 2–3, 3–13 PORTRAIT command, 3–5 to 3–6, B–1 to B–2 portrait orientation, 2–1 to 2–2 prerequisites, 1–2 printer console, 3–4 grippers, 2–3 printers 4135 printer, SEF, 2–2 4700 Color Document, 2–3, 2–11 highlight color, 2–11 supported, 1–2 to 1–3 printing samples, 5–10 to 5–11 procedures desc
INDEX INDEX–4 HOST FORMS DESCRIPTION LANGUAGE 3.
Index There should only be one blank line above each top entry in the columns of this page. If there is NOT a blank line at the top (Remove this text and arrows.) of this 2nd column . . . put one in. This layout guide specifies the appearance of a desired index. There are several fields below, and by editing inside them you determine how the index will look. (Don't delete the fields or change their properties. Edit only their content.) The fields will not appear in the resulting index.
00 IT Main Entries Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) operating operating(1) AN orientation orientation(1) AN origin origin(1) AN page page(1) AN printer printer(1) AN printers printers(1) AN procedures procedures(1) AN requirements requirements(1) AN sample sample(1) AN size size(1) AN syntax syntax(1) AN system system(1) AN types types(1) AN virtual page virtual page(1) AN XES XES(1) AN
00 IT Main (see) entries Hint: To begin filling in a blank Index Table, press .
00 IT Subentries Hint: To begin filling in a blank Index Table, press .
000 IT Introduction Hint: To begin filling in a blank Index Table, press .
01 IT Overview Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) MVS/ESA SA ope OV MVS/XA S/X OV onm environment operating(1) OV he asso ating system s OV OSS ted OS prerequisites rereq OV ter sup supported printers(1) OV pported d OV protocol converter ocol con hardware re requ requirements(1) OV software ftw requirements(1) OV S/370 channel es on IB OV SNA/RJE communications link JE com OV software requirements are re OV forms ess fo Xerox F
02 IT Planning your forms Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM COMPILE command LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) OV LE com orm ele elements coordinates(1) OV coordinates(1) OV coordinates(1) OV ft corn negative ega Y coo X and Y cifying a g data types ta ty OV edge-marking dge–mar OV ning f OV elements, form orm elem fixed fonts OV ixe nt cha character maps ont chara fonts(1) OV fonts(1) OV fonts(1) OV fonts(1) OV ont char character sets er set nt ori orientation ient types d and p
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) origin m ori form(1) OV ASCII e ASC formats(1) OV formats(1) OV forms(1) OV forms(1) OV forms(1) OV ining forma daries asso ion (SY determining ace the foll ying bot a and var or to f color lor models, i data ta: fo ms des design ruler uler for m
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) ning your f opriate for a G rea you sp ise the o gh the f sider them wh planning riable d forms(1) OV ction of the p etting the co mal code poin es the loc gn ruler ca e side 2 fo ge fra OV frames, page ke sure Gri OV grids MT gr ght color p OV highlight color printer ns, and m catalog ontai ink(1) OV
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) k color av color ink(1) OV ult in yboar OV keyboard character maps al keybo KEYBOARD parameter OV OARD par pe ori OV landscape, orientation pe forma line(1) OV spacing g or li mapping process pping proc fonts nt character m maps(1) OV fonts iler equat maps(1) OV keyboard rd–to–f maps(1) OV negative coordinates ve co OV OV eir orien fonts orientation(1) OV orientation(1) OV origin(1)
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) ame i frames page(1) OV page(1) OV ude the are ienta orientation cape orie ette, an OV palette nd sub paper size aper s OV paper size osing pa OV hys OV physical page hysi er portr OV portrait orientation ait fo grippers rippe printer(1) OV 4135 printer, SEF rox 41 printers(1) OV 4700 Color Document r Doc printers(1) OV 4700 Color Document x 4700 C printers(1) OV highlight color hligh
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) OV SEF option d (SEF) m paper aper siz size(1) OV paper r siz size(1) OV system(1) OV types(1) OV types(1) OV ystem p page yste ach hav fonts gn ea t of bou page frames n never b unit value nit va OV variable data iable da OV irtual k virtual keyboard character maps rtual ke OV yboard and font c ual pa size rtual pag virtual page(1) OV o the actu rdina OV X and Y coordinates u can no Xero
ITEM VARIATIONS (Optional) LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) Xerox 4700 Color Document Printer ment Printer h OV Xerox 4700 Color Document Printer nter uses full co OV
03 IT Using FDL commands Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) escr • EN ts is a short re 3–12 w the li fy at leas ure 3–13 n center mu xt’ spec x with matc re 3–14 N COLU description commands, HFDL(1) ...
VARIATIONS (Optional) ITEM LIST UNDER (Optional) nd for format SORT AS (Optional) CODES (Optional) commands, HFDL(1) OV commands, HFDL(1) OV commands, HFDL(1) OV commands, HFDL(1) OV erstandi forms, creating reati ettin he fir w) and TS, and XD xes) re setup ntime 3–6 sho irst ink y RED, PI lack pix syntax and syn MMENT com OV COMMENT command ENT ***H COMPILE command t the COMP description commands rdi OV coordinates(1) OV coordinates(1) OV ativ relative + or – sp database abase
VARIATIONS (Optional) ITEM font card ard.
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) ipt axim nd (Ce) p ure 3–12 wo decima nd are refer ig uote i pted by a ’t T 1,1 ’Jo e 3–14 nt of ve OV description commands NT n k lue fo LE n sp ifies the nam alue * yGr Y Ci ind MN SIZE IS 3 ax” secti eed 12 c uces T Y2–4 –.–.
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) DO SEC OV DO SECTION command AT specifies th ADER co OV DOT LEADER command es *** DOTS ress DOT OV END command ND comm OV FDL commands guage (FD OV commands FDL comma features, HFDL(1) OV ONT com OV FONT command ONT Fon index number nt index nu fonts(1) OV names ies the stan fonts(1) OV orientation ntation of the f form(1) OV formats(1) OV wing conventi commands nder the c inkname nkna
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) g up y d a prede S USLET xceed th DL descripti forms(1) setting up OV mat FMT OG (hig ned is 25 ribe fo nly on a X FORMS command RM com OV FSL rce Lang OV APHIC co OV GRAPHIC command C SYM RID co OV GRID command 2 CPI BY 8
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) g HFDL com tiple com ses (..
VARIATIONS (Optional) ITEM ICATALOG command OG com catalog he ink c LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) OV ink(1) OV NK comma OV INK command his sta inkname format OV e forma RWO INTERWORD command OV X‘20’, t erwo formula ord ga interword gap(1) OV multiplier tiplie interword gap(1) OV interword gap(1) OV interword gap(1) OV CING op SPACING operand ACIN specifying base e base ga IRESULT command SULT com OV RAIT com OV LANDSCAPE/PORTRAIT command APE/PO
VARIATIONS (Optional) ITEM size table ze of the lin LIST UNDER (Optional) line(1) SORT AS (Optional) CODES (Optional) OV INE com OV LINE command RY 0.
VARIATIONS (Optional) ITEM console onsole LIST UNDER (Optional) printer(1) SORT AS (Optional) CODES (Optional) OV e coordi OV relative coordinate es show the lo reserved words eserv OV resolution ON: You OV CTION com OV SECTION command ECTION comman u enter setu m one to si SLETT rid format fo zontal size of OV setup commands d is 1 XDO alog is a file tha ALETTE ’PA mes with embe ixels coin lines, table s table, c size(1) OV size(1) OV ect pape paper R, USLE SPACING operand ACING is
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) pecial charac OV special characters rs print only if y command flow, HFDL x flow ch syntax(1) OV XT AT com EXT A TEXT AT command OV ustification is be dth of the colu st’ NEW L text block, size OV loc XT IN BOX com EXT IN B TEXT IN BOX command OV ne of text to occu xes must have a commo X 4 3 ‘FIRS description commands ond the vir virtual page(1) OV origin igin with re virtual page(1) OV XDOTS n
04 IT Creating a sample form Hint: To begin filling in a blank Index Table, press .
05 IT Managing and printing sample forms Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM compiled forms, accessing LIST UNDER (Optional) Acc SORT AS (Optional) CODES (Optional) OV ata sets sto nce data se OV data sets titioned da uential da database OV abas fies the DDna Dnam OV DDnames cution DD pilation, the DD mes for dec printers decentralized(1) OV ames for dec wnlo OV downloading, sample ownlo compiled, accessing ccess a compi forms(1) OV existing, editing diting an ex forms(1) OV monochrome, specifying fying monoc forms(1) OV
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) escription Lan St produ EN spac le 5-2 sh atches the indic ch in your compiler in samples forms(1) OV ble 5–6 id tten to SYSPR ted in Table 5–8 a ant to dow ding a ochrome mo FSL uage (FS OV ISPF editor r ISPF e OV FDL compi FNTA HFDL compiler FINP JCL(1) OV JCL(1) OV SUPTA gure 5–9 s requirements CL requireme monochrome mode, onochrome mode OV
VARIATIONS (Optional) ITEM LIST UNDER (Optional) d printing a sa SORT AS (Optional) CODES (Optional) OV printing samples ure 5–10 JCL ms in your JCL, as app requirements(1) OV sample(1) OV syntax(1) OV aging and prin ERsion=Oth 0) the EN sp HIFT=chara XC MEM=M BJECT VER=X forms, printing alfunctio FFR y the XSUI king the HF inting a sa put Parm (VE atch pr BATCH command ZFORMS da
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) MPILE com ersion XC on COMPILE command Oup=nam syntax(1) OV EMber=sele e DDname is XFFSL a toner consumption oner consump OV VSAM data sets Virtual Storage Access Me OV
06 IT Messages Hint: To begin filling in a blank Index Table, press .
VARIATIONS (Optional) ITEM LIST UNDER (Optional) SORT AS (Optional) CODES (Optional) message indicators ndicate OV indicators, messages age indi OV
Appendix A. IT System considerations Hint: To begin filling in a blank Index Table, press .
Appendix B. FMT grid format properties Hint: To begin filling in a blank Index Table, press .
Appendix C. IT Approved abbreviations for reserved words Hint: To begin filling in a blank Index Table, press .
Appendix D. IT Comparison of HFDL and FDL Hint: To begin filling in a blank Index Table, press .
Appendix E. Supported paper sizes Hint: To begin filling in a blank Index Table, press .
Xerox Corporation Attn: Documentation 280 Wekiva Springs Road, Suite #340 Longwood, Florida 32779-3606 FAX: 407 / 869-2098 Reader Satisfaction Survey We would appreciate your comments and suggestions for improving this publication. Publication title and number Current date Your name and title Telephone number Your company and address Very Satisfied 1. How satisfied are you with this manual’s ease of use? 2. How satisfied are you with the clarity and usefulness of the illustrations and tables? 3.
Tape here only — Do not staple Please fold here Place Stamp Here Post Office Will Not Deliver Without Proper Postage Xerox Corporation Printing Systems Software 280 Wekiva Springs Road, Suite #340 Longwood, Florida 32779-3606 Attn: Documentation Please fold here