For OS/390, VM, VSE. Extended Reporting Facility Guide 6.2 SP3

Transcription

1 For OS/390, VM, VSE Extended Reporting Facility Guide 6.2 SP3

2 Release 6.2, May 1996 Updated: April 1999 This documentation and related computer software program (hereinafter referred to as the Documentation ) is for the end user s informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. ( CA ) at any time. THIS DOCUMENTATION MAY NOT BE COPIED, TRANSFERRED, REPRODUCED, DISCLOSED OR DUPLICATED, IN WHOLE OR IN PART, WITHOUT THE PRIOR WRITTEN CONSENT OF CA. THIS DOCUMENTATION IS PROPRIETARY INFORMATION OF CA AND PROTECTED BY THE COPYRIGHT LAWS OF THE UNITED STATES AND INTERNATIONAL TREATIES. TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. THE USE OF ANY PRODUCT REFERENCED IN THIS DOCUMENTATION AND THIS DOCUMENTATION IS GOVERNED BY THE END USER S APPLICABLE LICENSE AGREEMENT. The manufacturer of this documentation is Computer Associates International, Inc. Provided with Restricted Rights as set forth in 48 C.F.R. Section , 48 C.F.R. Sections (c)(1) and (2) or DFARS Section (c)(1)(ii) or applicable successor provisions Computer Associates International, Inc., One Computer Associates Plaza, Islandia, New York All rights reserved. All trademarks, trade names, service marks, or logos referenced herein belong to their respective companies.

3 Contents Chapter 1: About This Guide Purpose and Audience Organization Other CA-Easytrieve/Plus Publications Documentation Conventions Variable Parameters Chapter 2: Overview Introduction Extended Reporting Facilities Extended Reporting Sample System Overview Printer Support Printer Identification Font Identification Chapter 3: System Concepts Terminology Font Print Item Print Record Unit of Measure Font Sizes Character Cell Height Width CA-Easytrieve/Plus Reporting Characteristics Print Lines Print Records Contents iii

4 Printer Characteristics Printer Type Page Printers Line Mode Overprint Codes Function Codes Overprint and Function Codes Overprint Techniques Merge Overprint Print Overprint Supported Printers Paper Control Codes - Carriage Control Page Printers Start Page End Page Format Page Line Mode ANSI Carriage Control plus a Forms Control Block Machine Carriage Control Codes Plus a Forms Control Block ANSI Carriage Control with no Forms Control Block Point Skip Vertical Spacing Control File Type Record Format - Page Printers File Header Records Start Page Record(s) End Page Record(s) Format Page File Trailer Records Record Format - Line Mode File Header Records Print Records File Trailer Records File Format Blocked Records Unblocked Records Concatenated Records Concatenated Records - Structured Fields Concatenated Records - Line Mode iv CA-Easytrieve/Plus Extended Reporting Facility Guide

5 Font Characteristics Data Type Height and Width Overprint Code Function Header and Function Trailer Space Replacement Double Byte Alignment Line Complexes Report Layout Processing LINE Element Processing MIXED Field Printing MIXED Field Font Selection MIXED Field Support of Merge Overprint Print Item Positioning Considerations Overprint Gap Item Placement Restrictions Chapter 4: Extended Reporting Options Module Introduction Installation Steps For OS/390: OS/390 Installation Notes: For VSE Pre SP VSE Pre SP2.1 Notes: For VSE SP2.1: VSE SP2.1 Notes: XRPT Commands Overview XRPT COMMANDS - Syntax Overview Syntax Rules Example Printer Control Code Specification SYSPRINT Command Syntax Keywords PRINTER Command Syntax Keywords FONT Command Syntax Keywords Contents v

6 EZTPX04 Error Diagnostics Introduction Diagnostic Message Format Message ID Diagnostic Message Message Supplement Diagnostic Messages Chapter 5: Extended Reporting Introduction FILE Statement DEFINE Statement DISPLAY Statement Syntax Format Format Report Processing REPORT Statement Syntax Report Definition Statements TITLE Statement Syntax HEADING Statement Syntax Example LINE Statement Syntax Chapter 6: Extended Reporting Models Introduction IBM3800A Model IBM3800B Model IBM3800C Model IBM3800D Model IBM3800E Model IBM3800F Model SHOWA7 Model SHOWA8 Model M8250 Model vi CA-Easytrieve/Plus Extended Reporting Facility Guide

7 M8290 Model T8500 Model IBM3200 Model H8196 Model F6715D Model Chapter 7: Extended Reporting Usage Introduction Working with Page Mode Working with Line Compatibility Mode Printers Working with XEROX Printers Index Contents vii

8

9 Chapter 1 About This Guide Purpose and Audience The CA-Easytrieve/Plus Extended Reporting Facility Guide provides the technical details for generating the extended reporting options module. It also discusses concepts of extended reporting and how to create multiple font reports. The CA-Easytrieve/Plus Extended Reporting Facility Guide is intended primarily for technical personnel at your site. Organization This guide is divided into several chapters: Overview introduces the user to the use and intent of the documentation and the Extended Reporting Facility. System Concepts discusses concepts related to the use of Impact Dot, Ink Jet, and Electro-Photographic printers and how the Extended Reporting Facility deals with them. Extended Reporting Options Module discusses the procedures you must follow to generate your customized extended reporting options module. Extended Reporting includes the CA-Easytrieve/Plus syntax you must use to produce extended (multiple font) reports. Extended Reporting Modules contains a series of printer models for commonly used printers intended as examples for setting up the extended reporting options module. Extended Reporting Usage provides further explanation on printer definitions, JCL usage, and CA-Easytrieve/Plus program examples. The Index provide listings to facilitate references to terms and procedures. About This Guide 1 1

10 Other CA-Easytrieve/Plus Publications Chapters 2, 3, 5, 6, and 7 of the CA-Easytrieve/Plus Extended Reporting Facility Guide should be referenced only when generating the extended reporting options module or when changing extended reporting options. Chapter 5 contains CA-Easytrieve/Plus syntax for using extended reporting but this syntax is also included in the CA-Easytrieve/Plus Reference Guide. Other CA-Easytrieve/Plus Publications In addition to this CA-Easytrieve/Plus Extended Reporting Facility Guide, Computer Associates provides the following CA-Easytrieve/Plus documentation: Name CA-Easytrieve/Plus Reference Guide CA-Easytrieve/Plus Installation Guide CA-Easytrieve/Plus CA-Activator Supplement CA-Easytrieve/Plus User Guide CA-Easytrieve/Plus Application Guide CA-Easytrieve/Plus Interface Option Guides Contents Contains descriptions of all product features and functions as well as summaries of each CA-Easytrieve/Plus version. Describes the process of installing and tuning the CA-Easytrieve/Plus system. Explains how to install and maintain CA-Easytrieve/Plus on your OS/390 system, using the CA-Activator. Provides new users with the information they need to become productive quickly. It includes a six lesson tutorial and a format designed to make the material more interesting and easier to comprehend. Describes basic syntax (a subset of the syntax in the CA-Easytrieve/Plus Reference Guide) and operation, and provides a series of actual applications, from single examples to full systems. The Application Guide is an excellent tool for the business-oriented professional. Short guides available for users of various system options. These consist of manuals for IMS/DLI processing, CA-IDMS and IDD processing, TOTAL processing, SQL processing, CA-Datacom/DB processing, SUPRA processing, and other CA-Easytrieve/Plus options. 1 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

11 Documentation Conventions Documentation Conventions The following conventions are used throughout this guide for illustrative purposes: Notation {braces} [brackets] Meaning Mandatory choice of one of these entries. Optional entry or choice of one of these entries. (OR bar) Choice of one of these entries. (parentheses) Multiple parameters must be enclosed in parentheses.... Ellipses indicate that you can code the immediately preceding parameters multiple times. CAPS lowercase All capital letters indicate a keyword, name, or field used in a program example. Lowercase letters represent variable information in statement syntax. If the same variable types recur within a statement, they are made unique by adding a numeric suffix, such as literal-2. About This Guide 1 3

12 Documentation Conventions Variable Parameters Parameter field-name file-name index name integer job-name letter literal proc-name program-name record-name report-name sort-name Meaning A data field defined in your program. A unique file name defined in the library section of your program. Name of an INDEX data item. A numeric literal (a whole number greater than zero). Name of a JOB activity. A single alphabetic character (such as an edit mask identifier). A text string enclosed in quotes or a numeric constant. Name of a procedure. Name of a program written in a language other than CA-Easytrieve/Plus (such as COBOL or Assembler). Name of an IMS/DLI or CA-IDMS entity. Name of a REPORT. Name of a SORT activity. 1 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

13 Chapter 2 Overview Introduction A major function of CA-Easytrieve/Plus programs is to produce printed reports. To print reports, CA-Easytrieve/Plus uses a reporting mechanism that provides a number of automatic features. Many of these automatic features rely on assumptions that CA-Easytrieve/Plus makes about your printer. CA-Easytrieve/Plus assumes that: Printed data belongs to the EBCDIC character set. EBCDIC characters belong to the same FONT. This means that each character that CA-Easytrieve/Plus prints has one size, style, and design. The ANSI paper control codes are standard. Printer files are sequential with fixed length records that can be blocked or unblocked. Each record represents a logical print line that CA-Easytrieve/Plus builds during the generation of a report or through the execution of the DISPLAY statement. These assumptions restrict the use of Impact Dot, Ink-Jet, and Electro-Photographic printers that have extended reporting capabilities. Extended Reporting Facilities CA-Easytrieve/Plus Extended Reporting Facility provides support for Impact Dot, Ink-Jet, and Electro-Photographic printers. This facility interacts with the CA-Easytrieve/Plus reporting mechanism to provide support for additional features permitting CA-Easytrieve/Plus to: 1. Mix two different character sets on the same logical print line. For example, in the same report the extended reporting option can process EBCDIC fields and literals, and data containing DBCS (Double Byte Character Set) format codes. Double Byte Character sets represent writing systems that use more than 256 characters, such as Kanji (Japanese characters). 2. Process fields and literals belonging to different fonts. For example, in the same report you can use multiple fonts. Overview 2 1

14 Introduction A font is a complete set of images of characters and symbols having common characteristics (such as style, height, width, weight). In a CA-Easytrieve/Plus report, each character within a font must have the same amount of lateral space. That is, CA-Easytrieve/Plus supports only Fixed Pitch fonts. CA-Easytrieve/Plus automatically formats a report compensating for fields and literals that produce characters of different height and width. CA-Easytrieve/Plus automatically calculates the size of elements on Title, Heading, Detail, and Summary lines. You can use the CA-Easytrieve/Plus extended reporting options module EZTPXRPT to define the character widths that CA-Easytrieve/Plus uses. The module can define the widths as either characters per inch (pitch) or a point size where the term point defines the size of a character as a multiple of 1/72nd of an inch. For more information on the CA-Easytrieve/Plus extended reporting options module, refer to Chapter Support control codes in addition to the ANSI paper control codes. 4. Support printer files that use non-standard record formats, block sizes, and record lengths. Extended Reporting Sample With extended reporting, you can use multiple print fonts in a report. This enables you to highlight fields of special significance. For an example of what the Extended Reporting Facility can do, take a look at the sample report shown below. (The CA-Easytrieve/Plus program that produced the report is shown next.) 2 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

15 Introduction Sample Report BRANCH DEPT EMPLOYEE NUMBER REGION PAY SCALE SUMMARY REGION: 1 GROSS PAY NET PAY DEDUCTIONS , , , , END OF REGION 1 4, , , Overview 2 3

16 System Overview Sample Program The following CA-Easytrieve/Plus program created the report on the previous page. Note the fields and literals preceded by a pound sign (#) and integer. FILE FILEA REGION 1 1 N BRANCH 2 2 N HEADING ( #5 'BRANCH') < EMP# 9 5 N HEADING ('EMPLOYEE' 'NUMBER') NAME A HEADING ('EMPLOYEE' 'NAME') STREET A CITY A STATE 69 2 A ZIP 71 5 N NET 90 4 P 2 HEADING ('NET' 'PAY') GROSS 94 4 P 2 HEADING ('GROSS' 'PAY') DEPT 98 3 N DEDUCT W 4 P 2 HEADING ('DEDUCTIONS') JOB INPUT FILEA NAME BASIC DEDUCT = GROSS - NET PRINT REPORT1 REPORT REPORT1 LINESIZE 130 PAGESIZE 45 SUMCTL NONE SEQUENCE REGION BRANCH CONTROL REGION NEWPAGE BRANCH TITLE 01 #3 'REGION PAY SCALE SUMMARY' < TITLE 02 #5 'REGION :' -2 #2 REGION < LINE 01 #5 BRANCH DEPT EMP# GROSS NET DEDUCT < AFTER-BREAK. PROC IF LEVEL = 2 DISPLAY SKIP 3 COL 20 #5 'END OF REGION ' #5 REGION < END-IF END-PROC System Overview Printer Support The Extended Reporting Facility supports a variety of printers. Each printer has its own characteristics, especially with respect to the identification of the font, the presentation of print records, and the distinction between character sets. To support each printer's characteristics, CA-Easytrieve/Plus uses an extended reporting options module. The extended reporting options module defines the type of printer that CA-Easytrieve/Plus supports, and the font codes that the CA-Easytrieve/Plus program supports. The extended reporting options module, called EZTPXRPT, is not provided as part of the normal installation of CA-Easytrieve/Plus. Therefore, the CA-Easytrieve/Plus reporting mechanism uses the default mode of operation. CA-Easytrieve/Plus programs can use the Extended Reporting Facility only after your systems programmer generates the extended reporting options module. For information on how to generate the module, see the CA-Easytrieve/Plus Installation Guide and Chapter 4 of this guide. 2 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

17 System Overview The extended reporting options module can provide support for the following printers: IBM 3800-I, IBM 3800-II IBM 3800-III, IBM 3800-VIII IBM 3820 IBM 3200 XEROX 2700, XEROX 8700, XEROX 9700 FACOM 6715D, FACOM 6716D MELCOM 8250, MELCOM 8270, MELCOM 8290 HITAC 8196 TORAY 8500 SHOWA INFORMATION SYSTEM SP7, SP8 MEMOREX 1500/1520 Printer Identification The extended reporting options module identifies the type of printers that the CA-Easytrieve/Plus system use. A unique extended printer name (XRPT-name) identifies each printer in the module. This name not only identifies the characteristics of the printer but also enables you to define up to 256 different font codes for use in CA-Easytrieve/Plus programs. The font codes cause fields and literals to be correctly formatted into output lines so that the printer can print them using the correct font sets. The extended reporting printer name is an option on the FILE statement of the CA-Easytrieve/Plus program. Once you define an extended reporting printer name on a CA-Easytrieve/Plus FILE statement, any output, whether it is from a report or from the DISPLAY command, directed to that file, is formatted based on the characteristics defined for that extended reporting printer. The following exhibit illustrates the CA-Easytrieve/Plus syntax supported by the Extended Reporting Facility. Note: The EXTENDED keyword on the CA-Easytrieve/Plus FILE statement enables you to associate the extended reporting printer to a CA-Easytrieve/Plus printer file. Overview 2 5

18 System Overview Also, the following exhibit illustrates the use of the CA-Easytrieve/Plus DISPLAY statement within the processing logic of a program to direct print lines to that printer file, thereby taking advantage of the extended reporting facilities that the printer provides. Font Identification The final exhibit illustrates the definition of two extended reporting printer names in the extended reporting options module. Both printers are using the same MODEL definition while associated with each extended reporting printer is a different set of fonts. The FILE statement in the previous exhibit illustrated the association of an extended reporting printer named IBM38002 to a file called NEWPTR. The DISPLAY statement in the exhibit illustrates the use of different fonts on the same print line. The fonts used in the previous exhibit are defined for the extended reporting printer called IBM This definition is illustrated in the next exhibit. As a result, FIELD1 is output at 10 characters per inch (the default, since no override was coded) and FIELD2 is output, using a font of 15 characters per inch. If a field or literal is to use a different font, then you must precede the field with the character '#' followed by an integer. This integer defines the number of the font in the font table of the extended reporting printer that you are using. 2 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

19 System Overview The entry must exist for the data type of the field or literal, that is EBCDIC, DBCS, or MIXED. The DBCS data type defines data associated with a Double Byte Character Set (DBCS). Use this data type to output characters for languages such as Japanese, Chinese, Korean, and so on. Overview 2 7

20

21 Chapter 3 System Concepts Terminology This chapter defines terminology used throughout this guide. It is important that you thoroughly understand these terms before reading the later chapters in this guide. Font A font is an assortment of character images belonging to one data format (EBCDIC or DBCS). Fonts have one size, shape, style, and design. In CA-Easytrieve/Plus, a font defines all of the information necessary to create character images of that font on a specific extended reporting printer. This information includes the characteristics of the font that CA-Easytrieve/Plus requires to format a report (height, width, and so on). It also includes the printer control codes that specific extended reporting printers require for output records that use the font. If any of this information changes between two character images, CA-Easytrieve/Plus regards the two characters as belonging to different fonts. Print Item A print item defines a field or literal that you code on CA-Easytrieve/Plus statements that produce printed output (for example, the LINE, TITLE, and DISPLAY statements). CA-Easytrieve/Plus associates each print item with a font. CA-Easytrieve/Plus uses the height and width characteristics of the font to position a print item on a line. CA-Easytrieve/Plus merges the printer control codes of that font with the contents of a print item to form a print record. A print item can contain single byte character format data (EBCDIC), double byte character format data (DBCS), or a mixture of both (MIXED). System Concepts 3 1

22 Terminology Print Record A print record is a stream of data that CA-Easytrieve/Plus sends to the printer. This data consists of printer control codes and the contents of print items. Unit of Measure Prior to the Extended Reporting Facility, when processing printed text CA-Easytrieve/Plus assumed that each character was to be printed using the same font. This meant that each character had the same height and width. Furthermore, it meant that each print item (field or literal) on a print line occupied an amount of horizontal space that was directly proportional to the number of characters in that print item. In other words, all the calculations that determined the positioning of print items on a print line did not need to consider the size characteristic of the font being used to print that particular item. The size was assumed to be fixed. CA-Easytrieve/Plus still uses this methodology when using one font for a report. With the Extended Reporting Facility, you can use multiple fonts within the same report where each font can have a different height or width. As a result, a print item now occupies an amount of vertical space equal to the height characteristic of the font and an amount of horizontal space (equal to the number of characters in the item multiplied by the width characteristic of the font). Therefore, CA-Easytrieve/Plus must position items on a print line using both the size of the print item and the size of the font associated with that print item. To do this, you must define the size characteristic of each font as a multiple of a unit of measure that is standard for all the fonts within a given extended reporting printer. The specific unit of measure assigned to a particular extended reporting printer is of no consequence for the extended reporting mechanism. What is important is that the sizes of all fonts assigned to a particular extended reporting printer be defined in terms of the selected unit of measure. Sample units of measure include points, dots, and PELs. Points Points are a linear unit of measurement normally associated with the width (or height) of typefaces. A point is approximately equal to 72 dots per inch. 3 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

23 Terminology Dots A dot is the fundamental unit of imaging and digitization for electro-photographic printers. The size of a dot varies depending upon the resolution of the printer. The resolution is normally expressed as the number of dots per inch. The larger the number of dots, the higher the resolution quality of the printer. For example, the Xerox 8700 and Xerox 9700 support 300 dots per inch; the MELCOM 8290, IBM 3200, and HITACHI 8196 support 240 dots per inch; the TORAY 8500 supports 140 dots per inch. PELs A PEL (Picture Element) is the IBM term used to refer to the fundamental unit of imaging on the IBM 3800 printing systems. A PEL is the same as a dot but it is also used as the addressable unit for All Points Addressable printing on the 3800 Model III and VIII, and the For these printers, 240 PELs per inch are supported. In the majority of cases, any one of the units of measure can give the same results. The following table illustrates this: There are certain characteristics regarding particular printers that you must consider when determining the unit of measure. These characteristics are: 1. The definition of the height and width characteristic of a font can only be accurate to two decimal positions. If a font requires greater accuracy than that, then you must re-evaluate the unit of measure. System Concepts 3 3

24 Terminology 2. For printers that are All Points Addressable (like the IBM 3800 Model III and VIII, and the IBM 3820), CA-Easytrieve/Plus must assign positions to print items in terms of the unit of measure known by that printer. These printers require control information (item positioning, item sizes, page sizes, line sizes) in one unit of measure (PEL's for example). For CA-Easytrieve/Plus to meet these requirements, you must use the same unit of measure to define the printer characteristics that the extended reporting options module identifies. For example, if you define all the fonts in terms of a number of points, then CA-Easytrieve/Plus cannot support a printer that supports PEL's as the unit of page addressing. In this case, CA-Easytrieve/Plus positions items on a page by using values that are multiples of points but the printer interprets these values as a number of PELs. This produces incorrect results. Therefore, for All Points Addressable printers, CA-Easytrieve/Plus restricts the selection of the unit of measure to the unit used to address positions on the page of a report. 3. Some printers require CA-Easytrieve/Plus to merge a value with the printer function code. These printers use this value for Paper Control Codes (Carriage Control) where the amount of vertical space to be skipped is defined as a multiple of a certain unit of measure. For example, the SHOWA SP-7, SP-8, and the MELCOM 8250 all require the skip amount be defined in terms of a number of points. For printers having this characteristic, the unit of measure selected to define the other characteristics of the printer must be the same. Using more than one unit of measure causes the printer to interpret the value CA-Easytrieve/Plus merges by a unit of measure different from the one with which it was defined. Font Sizes As illustrated earlier, a variety of units of measure can define a printer's characteristics. From the CA-Easytrieve/Plus view, any unit of measure is fine. To simplify the discussion of fonts, assume a standard unit defines a font's width (W-unit) and another defines a font's height (H-unit). Therefore, independent of the actual unit of measure selected (points, dots, pels, and so on), a number of H-units and a number of W-units define a font. Using these base units, this chapter discusses the meaning of the size of a font. CA-Easytrieve/Plus must know the characteristics of a font to accurately determine the positioning of print items on a line or page. The definition of the size of a font is expressed as the height and width of the character cell assigned to the font. 3 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

25 Terminology Character Cell CA-Easytrieve/Plus associates each Fixed Pitch font with a character cell. The character cell defines the area required to encompass the images of the characters of a particular font. The following example illustrates that the height and width of a character cell is not always the same as the height and width of the actual character image. This is because the character cell includes any additional vertical and horizontal spacing required to encompass images of the font's characters. An important reference line in any font definition is the baseline. The definition of the baseline changes between extended reporting printers. The more commonly accepted definition of a baseline is an imaginary line supporting the bottom of capitals. In CA-Easytrieve/Plus, the baseline is an imaginary line supporting the bottom of character cells. The formatting of a print line containing a mixture of fonts is based on the positioning of the bottom of each character's cell on that baseline. The amount of vertical space between one print line and the next is the vertical distance between baselines. This distance is the height of a line. Height A font's height is the amount of vertical space (in H-units) that a printed character occupies. This means that the height of the font is the height (in H-units) of the character cell associated with the font. Some printers are able to adjust the vertical position of a font. These printers can move the base of the character cell up or down a number of H-units from the baseline. You can incorporate this adjustment into the printer control codes associated with a CA-Easytrieve/Plus font. CA-Easytrieve/Plus supports the definition of an adjust vertical position font, but you must make the appropriate adjustment to the height to compensate for the font's movement. System Concepts 3 5

26 Terminology Upward Adjustment For upward adjustment, the height of the font must include the adjustment amount. That is, the height of the font is equal to the height of the character cell plus the amount of vertical adjustment. Therefore, an upward adjustment is like extending the length of a character's cell. If the font's height is not adjusted up, there exists the possibility of generating a vertical line feed that is too small to include the upward adjustment. For example, assume that a font normally prints with a height of 12 points. If you defined this font to CA-Easytrieve/Plus so that the printer performed an upward adjustment of 4 points, you need to define the height of the font as 16. You define the height of the font on the FONT command. See Chapter 4 for information on the FONT command. Downward Adjustment For downward vertical adjustment, the bottom of the character cell is actually positioned below the baseline. To support this adjustment, you must calculate the height of the font as the character cell's height minus the vertical adjustment. This defines the correct height that CA-Easytrieve/Plus requires. It is then your responsibility to ensure that the next baseline is vertically displaced a sufficient amount to permit room for the portions of characters that CA-Easytrieve/Plus prints below the current baseline. For example, assume that a font normally prints with a height of 12 points. If you define this font to CA-Easytrieve/Plus in such a manner that the printer performs a downward adjustment of 4 points, then you have to define the height of the font as 8. You define the height of the font on the FONT command. See Chapter 4 for information on the FONT command. Width A font's width is the amount of horizontal space (in W-units) that a printed character occupies. This means that the width of the font (in W-units) is the width of the character cell associated with the font. The Extended Reporting Facility supports only fixed pitched fonts in which all of a font's character patterns occupy the same horizontal or lateral space. Some printers support special horizontal adjustment functions that you can use to expand the horizontal size of a character or squeeze the character. If you select either of these options, the width of the font that these function codes identify must incorporate the horizontal adjustment factors. For example, assume that a font normally prints with a width of 12 points. If you define this font to CA-Easytrieve/Plus in such a manner that the printer performs an expansion of 4 points, then you have to define the width of the font as 16. You define the width of the font on the FONT command. See Chapter 4 for information on the FONT command. 3 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

27 Terminology CA-Easytrieve/Plus Reporting Characteristics CA-Easytrieve/Plus provides a non-procedural language for defining the sets of lines that form a report. The language consists of the TITLE, LINE, and DISPLAY statements. Each statement specifies the items that are to appear on the report. CA-Easytrieve/Plus must then process these items and automatically determine the layout of the report. Any one statement (for example, the LINE statement) can result in more than one set of print lines, as the following example shows. LINE STATEMENT DETAIL HEADING SUMMARY CA-Easytrieve/Plus uses the resultant layout to determine the correct set of print lines that produce the report. The set of print lines include title lines, heading lines, detail lines, and summary lines. The previous example illustrates CA-Easytrieve/Plus creating three sets of print lines from the one statement. In addition, the use of different fonts for the print items to be formatted on the report requires the generation of multiple print records that are combined by the extended reporting printer to form a print line. As the following example illustrates, to process the initial statement, CA-Easytrieve/Plus must create two detail records, four heading line records, and two summary line records. DETAIL (2) LINE STATEMENT HEADING (4) SUMMARY (2) CA-Easytrieve/Plus then determines the format of the print records required to generate these print lines on the appropriate extended reporting printer. The following example illustrates CA-Easytrieve/Plus determining the format of the print records. DETAIL (2) {PRINT RECORD { {PRINT RECORD {PRINT RECORD { {PRINT RECORD LINE { STATEMENT HEADING (4) {PRINT RECORD { {PRINT RECORD SUMMARY (2) {PRINT RECORD { {PRINT RECORD System Concepts 3 7

28 Terminology The following chart illustrates the relationships between these various components and the structure of print records that the Extended Reporting Facility supports. Print Lines In terms of CA-Easytrieve/Plus reporting, the statements that define printed output define that output as a series of print items (fields and literals) that are to appear on specific lines of a report. As a result, the CA-Easytrieve/Plus system produces printed output as a series of print lines. Print Records In terms of the CA-Easytrieve/Plus Extended Reporting Facility, a Print Record is the base unit for a print output request. After CA-Easytrieve/Plus builds the record, CA-Easytrieve/Plus outputs it to the print data set. 3 8 CA-Easytrieve/Plus Extended Reporting Facility Guide

29 Terminology Standard CA-Easytrieve/Plus reporting associates the production of one print line with the output of one print record. This is appropriate for non-extended reporting printers. With the Extended Reporting Facility, CA-Easytrieve/Plus no longer associates the production of one print line with the output of one print record. This is because some extended reporting printers do not permit you to mix print items from different fonts on the one print line. Multiple print records must be output by CA-Easytrieve/Plus and the printer combines these records to form a single print line. Print records that the Extended Reporting Facility builds have four components. They are: Paper Control Codes (PCC) Overprint Codes Function Codes Print Items. Paper Control Codes (PCC) - Carriage Control Overprint Codes At the start of each print record is a control field that defines the required vertical movement that occurs before printing the text that follows. If you are combining multiple print records to form a single print line, then the first print record contains the carriage control information that specifies the start of a new line. Additional print records for the same logical print line use a SKIP 0 carriage control. This control field follows the PCC. Printers that output multiple print records to form a single print line use this control field. It indicates the characteristics of the font(s) that this particular print record uses. Multiple print records destined for the same print line use different Overprint Codes to output text using different fonts. Not all printers require Overprint Codes. Therefore, they only incorporate into print records when the assigned extended reporting printer requires them. Overprint Codes are called TRC (Table Recognition Codes) on IBM printers that support multiple fonts while running in Line Compatibility mode. System Concepts 3 9

30 Printer Characteristics Function Codes Printers that require one print record to support the printing of multiple fonts on the same print line process print records as a combination of two data types: Text Control information. The text is that portion of the print record that is to actually appear on the printed page. Function Codes consist of control information that instructs the printer how to process the text. To do this, they define the type of font, size of the characters, data type (single or double byte data), and special operations such as repeating a character, and underlining text. CA-Easytrieve/Plus processes Function Codes before data (Header Function Codes), or after data (Trailer Function Codes). CA-Easytrieve/Plus assigns Function Codes to a font that the Extended Reporting Facility uses. When you use the font to which Function Codes are assigned, CA-Easytrieve/Plus combines the appropriate Function Codes with the item in the print data. Print Items This term refers to the actual text or data that appears on the report. In terms of CA-Easytrieve/Plus syntax, it is either a field or a literal. Printer Characteristics This section discusses the printer characteristics that CA-Easytrieve/Plus uses to generate the correct print data set for the appropriate extended reporting printer. There are three types of printer characteristics that CA-Easytrieve/Plus supports. They are: 1. Printer Type - defines the method CA-Easytrieve/Plus uses to build print records and how CA-Easytrieve/Plus combines different fonts onto the same print line. 2. Paper Control Code - identifies the method CA-Easytrieve/Plus uses to control vertical positioning on a page. 3. File Type - defines the attributes of the print data set that CA-Easytrieve/Plus creates as it outputs print records CA-Easytrieve/Plus Extended Reporting Facility Guide

31 Printer Characteristics Printer Type The printers that CA-Easytrieve/Plus supports use different techniques to identify fonts and print items within a print record. The seven categories of printers that CA-Easytrieve/Plus supports are shown in the following diagram. System Concepts 3 11

32 Printer Characteristics Page Printers In contrast to Line Mode devices, which associate one print record with one print line, Page Printers are devices that process a Data Stream containing printer commands and print data. Page Printers use Structured Fields and provide support for All Points Addressable printing. Print records contain structured fields. Structured fields are self-identifying strings of bytes containing control information, control information parameters, and a print item's data. Page printer's process data on a page basis (as opposed to line by line). Therefore, CA-Easytrieve/Plus positions a print item on the page by defining the coordinates of the start of the item. These coordinates consist of a vertical displacement from the top of the page (Y-direction) and a horizontal displacement from the left side of a page (X-direction). At compile time CA-Easytrieve/Plus assigns each print item its appropriate X-direction coordinate based on the coding of the CA-Easytrieve/Plus program. CA-Easytrieve/Plus cannot determine the Y-direction coordinate until execution time because the vertical displacement from the top of the page of a particular print line is dependent upon the vertical space already occupied by print lines printed before the current print line. As a result, CA-Easytrieve/Plus determines the appropriate X-direction coordinate at compile time and builds the appropriate print records leaving room for the insertion of the correct Y-direction coordinate during the execution of the user program. To perform this function, CA-Easytrieve/Plus uses a set of printer control codes that normal line mode printers do not support. These control codes are: Set Vertical Position This is a control code that defines the Y-direction coordinate for the data that follows in the current print record. CA-Easytrieve/Plus supports two ways of defining this coordinate. The first is to establish the Y-direction coordinate relative to the current Y-direction coordinate. This means that CA-Easytrieve/Plus must merge the control code with a value in H-units that specifies the distance that the new line is to be positioned relative to the current Y-direction coordinate. The second method of establishing the Y-direction coordinate is by setting an absolute Y-direction coordinate. In this case CA-Easytrieve/Plus merges the control code with the new Y-direction address on the page (in H-units) and adds this value to the print record prior to performing any horizontal (X-direction) positioning CA-Easytrieve/Plus Extended Reporting Facility Guide

33 Printer Characteristics Set Horizontal Position This is a control code that defines the X-direction coordinate for the data that immediately follows in the print record. This code precedes the data for each print item. Like the Set Vertical Position, the X-direction coordinate can be defined as either a relative offset from the current coordinate, or as an absolute address on the current line. In either case, the control code nullifies the need for blank spacing between print items. Line mode printers use this blank spacing to position one item to the right of another print item on a print line. This is no longer required as each item can be uniquely assigned its print position independent of any other print item. Function Codes These are additional, printer specific codes that can be added to the print records to identify the characteristics of the font to be used for a print item's data. Examples of the characteristics that such codes define include the character's height, width, style, shape, data format (EBCDIC or DBCS), and so on. CA-Easytrieve/Plus inserts these codes into print records after the Set Horizontal Position control code (for Function Header codes) and after the print item's data (for Function Trailer codes). Note: CA-Easytrieve/Plus only inserts the Function Trailer when the next print item's font is different from that of the current print item. Where the fonts are the same, CA-Easytrieve/Plus does not insert the Function Trailer code and the Function Header code (for the next print item). System Concepts 3 13

34 Printer Characteristics The following example illustrates the construction of print records for Page Printers S S F d S d S F d S F d F V H C a H a H C a H C a C P P t P t P t P t a a a a Function Code(s). At this point, the font has changed so the Function Trailer code for the current font is inserted prior to the Function Header for the font of the third print item --- Set Horizontal Position code to set the X-direction coordinate for the next print item. Note that the lack of a Function Code indicates that the font is the same for the second print item. --- Header Function code for the font assigned to the first print item on this record. --- Set Horizontal Position code merged with the X-direction coordinate value. --- Set Vertical Position code merged with the Y-direction coordinate value. Line Mode Line Mode printers support print data sets whose print records contain data and control information particular to a line. Line Mode printers restrict control of mapping print items to a page permitting only the positioning of items along the current line. At the start of each print record carriage control codes control the vertical position on a page. Line printers can be further divided into six more finite classifications based on their ability to support Overprint and Function codes in the print record CA-Easytrieve/Plus Extended Reporting Facility Guide

35 Printer Characteristics Overprint Codes Printers that support only one font per print record use Overprint Codes. Therefore to combine more than one font on a print line CA-Easytrieve/Plus must build multiple print records. However, a print item is only output on the print record whose Overprint Code matches the Overprint Code of that print item's font. Line spacing occurs prior to the first print record. Each additional print record overprints the first. The printer then merges all these print records to form one print line. CA-Easytrieve/Plus uses two methods of merging print records depending on the extended reporting printer's characteristics. The two methods are Merge Overprint and Print Overprint. The following topics discuss both of these overprint methods. The overprint feature is a function of the printer hardware. For both overprint techniques, CA-Easytrieve/Plus generates multiple print records containing the required data and printer control codes. However, the layout of the data in the print records that CA-Easytrieve/Plus produces for each overprint technique must be different in order for the print items on the report to line up properly. This becomes evident upon examining the different techniques. The following example illustrates the overall structure of the print records built for printers that support Overprint Codes. System Concepts 3 15

36 Printer Characteristics Function Codes Printers that support both control and print data in the same print record use Function Codes. Printer manufacturers assign the control information special values (function codes) that identify it from the normal print data. The printer does not print function codes on the report but uses them to define the function that is to be performed. A function code defines the format of the data (EBCDIC or DBCS), the size of the characters, and so on. The following example illustrates the structure of print records supported by function code printers: Overprint and Function Codes The third major category of Line Mode printers are those that support both Overprint and Function Codes in the same print record. These printers use the Overprint Code to establish the font of the characters to be printed (size, style, shape, and design). They use Function Codes to distinguish one Data Type from another, that is, to distinguish EBCDIC from DBCS. Because these printers support an Overprint Code, the printer combines multiple print records to form a single print line when CA-Easytrieve/Plus requires a mixture of fonts on one line. As has already been mentioned, there are two techniques applicable to combining multiple print records: Merge Overprint and Print Overprint. These same two techniques are also applicable to this category of printer. The following section compares the two overprinting techniques CA-Easytrieve/Plus Extended Reporting Facility Guide

37 Printer Characteristics The following example illustrates the format of the print records built for this type of printer: Overprint Techniques The two techniques that CA-Easytrieve/Plus supports for overprinting multiple print records to form a single print line are Merge Overprint, and Print Overprint. The printer hardware defines the technique that CA-Easytrieve/Plus uses. CA-Easytrieve/Plus automatically compensates for the characteristics of the appropriate technique that the extended reporting printer uses. The first overprint technique, Merge Overprint, merges the print records by character position in the print record. The second technique, Print Overprint, combines the print records by their physical position in the final print line. The results of the Print Overprint technique are similar to those obtained when overprinting on an impact line printer. Merge Overprint When merging multiple print records into a single print line, the merge process combines the data on a character by character basis. The 12th character in a print record, for example, merges with the 12th character in another print record. This happens regardless of where those characters might otherwise appear (as a result of differences in character width) on the print line. The rules that the printer uses to merge print records (of the same or different font widths) into one print line are: A printable character in a following record replaces an identical character or a blank. A blank in a following record does not replace either a blank or a printable character. A printable character trying to replace a previous printable character different from itself results in a data check, and the character in the new record does not replace the character in the previous record. System Concepts 3 17

38 Printer Characteristics When merging blanks of different W-units, the resulting blank has the W-unit of the first one. When a printable character is merged with a blank, the resulting character has the W-units of the printable character. To illustrate this process, assume that three print records are being merged and the W-units are in points. The first record contains 7-point characters, the second contains 12-point characters, and the third contains 9-point characters. Each print record contains four characters (three blanks and one printable character in each case). The following example illustrates the three print records and the resulting print line CA-Easytrieve/Plus Extended Reporting Facility Guide

39 Printer Characteristics Print Overprint The Print Overprint technique overprints print records the same as does a normal impact line printer. The printer develops the image (or images) each print record independent of any other print record for the same line. It is the imaged or physical lines that are combined. With this technique you can have one character from one print record overlay another character because the physical images of the two records occupy the same position on the line. To illustrate this technique, the same three records that demonstrate the Merge process are used. That is, 7, 12, and 9-point print records. As the following example demonstrates, the independent imaging of the three records results in an overlap of character boundaries. For example, the character from the first record is overprinted by the character on the second imaged record because they occupy the same physical space on the print line. System Concepts 3 19

40 Printer Characteristics In addition, there is a 3-point gap between the character on the third imaged record and the 12-point character on the second imaged record. To overcome the problem of characters overlaying one another, CA-Easytrieve/Plus must build the print records to provide the necessary spacing to separate the characters in the different print records. Each print record must provide sufficient spacing characters so that when the record is imaged, the characters on the physical lines do not overlay each other. CA-Easytrieve/Plus automatically compensates for this characteristic CA-Easytrieve/Plus Extended Reporting Facility Guide

41 Printer Characteristics The next example uses the same 7, 12, and 9-point print records to illustrate the format of the print records that do not cause overlaying of characters. In this case though, the print records have been built compensating for the attributes of the Print Overprint technique. Note: The first record requires four blanks in front of the printable character. When imaged, the four blanks of 7 points each give 28 points of lateral spacing in front of the character, thus positioning the character to the right of the second character. Not only must CA-Easytrieve/Plus take this additional spacing into account when building the print records, but it also must compensate for the gaps that appear between characters. For example, the 3-point gap between the 9- and the 12-point character and the 4-point gap between the 12- and the 7-point character. System Concepts 3 21

42 Printer Characteristics 3 22 CA-Easytrieve/Plus Extended Reporting Facility Guide

43 Printer Characteristics Supported Printers Based on the set of characteristics that the Extended Reporting Facility supports, the following table illustrates the various printing systems that CA-Easytrieve/Plus can support. This list is not restrictive as printers that fit into one of the seven categories defined previously can still be supported through the extended reporting options module. See the discussion on the generation of the options module in Chapter 4. System Concepts 3 23

44 Printer Characteristics Paper Control Codes - Carriage Control The printers that CA-Easytrieve/Plus supports use different techniques to control the vertical position on a page. The majority of the printers support the ANSI carriage control and provide support for a Forms Control Block to enable the definition of line spacing. In addition to the ANSI system, the Extended Reporting Facility supports four other techniques. The following chart illustrates each of the techniques that CA-Easytrieve/Plus uses to control the vertical position on a page. This document explains each technique before discussing the technique that each printer supports CA-Easytrieve/Plus Extended Reporting Facility Guide

45 Printer Characteristics Page Printers Page Printers use Structured fields to provide support for All Points Addressable printing. Page Printers do not support carriage control like a normal line printer because Page Printers perform positioning on a page by page basis. The three basic record types that All Points Addressable printers require are: Start Page, End Page, and Format Page. The following chart illustrates the relationships between these three components: Start Page A Start Page record tells the printer to build a new logical page. A start page record contains information that establishes the base coordinates for a page, the fonts used on the page, any overlays required, and so on. For the IBM 3800 Advanced Function Printing System, the majority of this information is defined in elements termed FORMDEFs and PAGEDEFs. You can use these elements for reports that the CA-Easytrieve/Plus Extended Reporting Facility produces but IBM-supplied software defines and maintains them, not CA-Easytrieve/Plus. These records are output whenever a report requires a request for a new page. System Concepts 3 25

46 Printer Characteristics End Page End Page records define the end of a page. These records follow the Format Page records to delimit the end of a page. They are output when the current report requires a request for a new page, except of course before the first page of the report. Format Page Format Page records contain a mixture of printer control codes and data (structured fields). They contain the information required to select a font for a print item and then position the data for a print item on the current page. CA-Easytrieve/Plus positions the print text at an address on a page. During compilation, CA-Easytrieve/Plus determines the horizontal position, as was discussed previously under Page Printers. During the execution of the user's program, CA-Easytrieve/Plus determines the vertical position for a print line. At this time CA-Easytrieve/Plus can map each print line to the appropriate vertical position on the current page based on the print records that have printed previous to this print record. CA-Easytrieve/Plus then uses this current position to determine the vertical coordinate for the new line. CA-Easytrieve/Plus then merges this coordinate with the Set Vertical Position code (discussed under Page Printers) and adds the coordinate to the front of the current print record before being output to the print data set. CA-Easytrieve/Plus maintains the current position on a page by using the H-units of fonts used on print lines. Through the following process CA-Easytrieve/Plus determines the amount of vertical space to assign to each print line: 1. Determine the largest H-unit from all the H-units of the fonts used on a print line. 2. Using the default H-unit defined in the extended reporting options module as the Base Height of each print line for this extended reporting printer, round the H-unit of the tallest font up to a multiple of this Base Height. This gives the amount of vertical space to assign to this print line. The Base Height is defined by the DEFAULT-SIZE keyword of the PRINTER command used to define a printer in the extended reporting options module. Chapter 5 explains how to generate the options module. 3. Then, by dividing the vertical space amount by the Base Height value, CA-Easytrieve/Plus obtains the amount to add to the line counter. Therefore, CA-Easytrieve/Plus maintains the line counter as a multiple of the Base Height setting in the extended reporting options module CA-Easytrieve/Plus Extended Reporting Facility Guide

47 Printer Characteristics The skipping of blank lines is in multiples of the defined Base Height setting for the extended reporting printer. This means that a request to skip 1 (one blank line) and then print a line containing 8-point characters where the Base Height setting defines 9-point lines (8 Lines per Inch), results in the baseline for the new line being positioned 18 points below the old baseline. Line Mode When using a printer that processes print records corresponding to print lines, CA-Easytrieve/Plus uses the Paper Control Code to define the vertical positioning to be performed before printing a print record. CA-Easytrieve/Plus positions the Paper Control Code at the start of each print record. The Extended Reporting Facility supports these four Paper Control Codes. 1. ANSI Carriage Control plus a Forms Control Block. 2. Machine Carriage Control Codes plus a Forms Control Block. 3 ANSI Carriage Control with no Forms Control Block. 4. Point Skip vertical spacing control. ANSI Carriage Control plus a Forms Control Block This form of line mode Carriage Control indicates that the extended reporting printer supports a Forms Control Block and that print records can use ANSI Carriage Control Codes for paper control. When using an FCB, values in the FCB define the line spacing that the printer is to use. A print record then provides the appropriate ANSI code for skipping the appropriate number of lines. The printer determines the vertical spacing from the line sizes defined in the FCB. From the CA-Easytrieve/Plus point of view, control over the paper is restricted to the ANSI codes. The values set in the FCB dictate the amount of space skipped for any one line. The FCB parameter on the OS/390 JCL DD or OUTPUT statement for the report data set specifies the FCB that any CA-Easytrieve/Plus extended reporting output uses. For VSE, the LST JCL statement defines the FCB. CA-Easytrieve/Plus maintains a line counter of a report output to an ANSI plus FCB printer by incrementing the line counter by the number of lines skipped for a particular print record. Therefore, the line counter indicates the number of lines processed on the current page. This value does not indicate the vertical spacing in H-units. You could obtain this value by multiplying the value of the line counter by the H-units for each printed line defined in the FCB. System Concepts 3 27

48 Printer Characteristics Machine Carriage Control Codes Plus a Forms Control Block CA-Easytrieve/Plus processes this form of line mode Carriage Control exactly like ANSI codes except that the value of the Carriage Control codes are the Machine code equivalents of the ANSI codes. ANSI Carriage Control with no Forms Control Block This printer supports ANSI codes but the height of each line is dependent upon the height of the tallest font in the current line and the height of the tallest font in the previous line. The larger of these two values is the amount of vertical space that is allocated to the current line. In other words, the height of the current line is determined by the height of the tallest font in use in the previous line except when the height of the tallest font on the current line is greater. In this situation, the height of the tallest font in use on the current line defines the height of the current line. Therefore, if printing fonts of different heights on the same report, the height of each line on the report varies. Fonts of equal height result in equal spacing between lines on the page. For this category of printer, CA-Easytrieve/Plus uses the ANSI carriage control characters but it outputs all line skipping using the font that defines the printer's default height (see the DEFAULT-SIZE KEYWORD of the PRINTER command in the Extended Reporting Facilities Installation chapter for more details). This means that all blank lines print at the default height of the extended reporting printer. In addition, to ensure that the first line on any new page has the same displacement from the top of the form, CA-Easytrieve/Plus prints a blank line as the last record prior to the top of form print record. This print record uses the font that defines the printer's default height. CA-Easytrieve/Plus maintains the line counter for a report on this type of printer by maintaining the vertical positioning as a count of H-units. CA-Easytrieve/Plus determines the value of the line counter by performing the following calculation: (Total number of H-units printed) (Base height value assigned to this extended reporting printer) CA-Easytrieve/Plus always rounds this value up to give the maximum displacement down a page CA-Easytrieve/Plus Extended Reporting Facility Guide

49 Printer Characteristics Point Skip Vertical Spacing Control If the printer does not support the ANSI Carriage Control then to space vertically, the printer uses a special Function Code that instructs the printer to start a new line. The largest H-unit of the fonts defined to appear on the new print line determines the spacing between the baseline of the current line and the baseline of the new line. The new line request can include vertical spacing in addition to the vertical spacing generated by the new line request. This function is referred to as Point Skip processing. CA-Easytrieve/Plus uses the following steps to perform line feed operations: 1. Obtain the H-unit for the highest font to be printed on the line. 2. Using the H-unit defined as the Base Height for this extended reporting printer, CA-Easytrieve/Plus rounds the H-unit of the tallest font up to a multiple of this Base Height. This gives the amount of vertical space assigned to this print line. The value that the largest font H-unit was adjusted up is the value of the Point skip operation. That is, all the print lines occupy a vertical space amount that is a multiple of the Base Height. 3. Then, by dividing the vertical space amount by the Base Height, CA-Easytrieve/Plus obtains the amount that it adds to the line counter for this line. Therefore, CA-Easytrieve/Plus maintains the line counter as a multiple of the Base Height setting in the extended reporting options module. System Concepts 3 29

50 Printer Characteristics The skipping of blank lines is in multiples of the defined Base Height for the extended reporting printer. This means that a request to skip 1 and then print a line containing 8-point characters where the Base Height is set to 9-point lines (8 Lines per Inch), results in a point skip of 10 points (9 points for the blank line and 1-point for the adjustment to the print line to round it up to a multiple of the Base Height). File Type CA-Easytrieve/Plus outputs reports to data sets. CA-Easytrieve/Plus is not concerned with whether the data sets are be under the control of a spooling system, like JES and POWER, or whether the data sets are normal disk and/or tape files not controlled by a spooling system. A data set that CA-Easytrieve/Plus builds as a result of printing operations using the Extended Reporting Facility must contain the records in a format that the extended reporting printer supports. The format of this data set varies depending upon the printer you are using CA-Easytrieve/Plus Extended Reporting Facility Guide

51 Printer Characteristics Record Format - Page Printers The next chart illustrates a print data set for a Page Printer. The print data set incorporates five record types: File Header Records File Header Records are defined in the extended reporting options module. File Header Records output control information necessary to initiate the printer for the print records that follow. CA-Easytrieve/Plus outputs these records to the print data set immediately after opening the file but before outputting any print records. Start Page Record(s) A Start Page record tells the printer to build a new logical page. A Start Page record contains information that establishes the base coordinates for a page, the fonts used on the page, any overlays required, and so on. For the IBM 3800 Advanced Function Printing System, the majority of this information is defined in elements termed FORMDEFs and PAGEDEFs. You can use these elements for reports that the CA-Easytrieve/Plus Extended Reporting Facility produces but IBM supplied software defines and maintains them -- not CA-Easytrieve/Plus. These records are output whenever a report requires a request for a new page. System Concepts 3 31

52 Printer Characteristics End Page Record(s) End Page records define the end of a page. These records follow the Format Page records to delimit the end of a page. They are output when the current report requires a request for a new page, except of course before the first page of the report. Format Page Format Page records contain a mixture of printer control codes and data (structured fields). Format page records contain the information required to select a font for a print item and then position the data for a print item on the current page. Format Page records can contain up to five components: Format Record Header This component defines a string of control information that CA-Easytrieve/Plus adds to the front of each Format Page record that it outputs to the print data set. CA-Easytrieve/Plus only adds the string of control information if it is defined in the extended reporting options module. Otherwise, CA-Easytrieve/Plus does not add anything to the print record. Set Vertical Position The Extended Reporting Facility uses this control code to establish the Y-direction coordinate for the print items that follow. CA-Easytrieve/Plus merges the control code with value that defines either an incremental offset for the new line relative to the current position, or an absolute Y-direction coordinate. Function Codes If a printer requires special control codes in the print record to identify different fonts and data types, then in the print record CA-Easytrieve/Plus mixes Function Codes with Print Items. For those printers that do not require such control information the Function Codes are not present. Set Horizontal Position This control code defines the X-direction coordinate along the current baseline (as established by the last Set Vertical Position code). By combining these two coordinates, CA-Easytrieve/Plus establishes an absolute address on the current page for the print items that follow. CA-Easytrieve/Plus merges the control code with a value that defines either an incremental offset for the new item relative to the current position on the current line, or an absolute Y-direction coordinate CA-Easytrieve/Plus Extended Reporting Facility Guide

53 Printer Characteristics Print Items This component includes the fields and literals that contain the data for the final print line. The maximum length of a Format Page record is the maximum record length of the print data set that receives the record. Should a record exceed that size, a runtime error results. This error stops the execution of the program and results in the printing of an error message. File Trailer Records File Trailer Records are similar to the File Header Records. The extended reporting options module defines File Trailer Records. Each File Trailer Record is a logical record on the print data set. CA-Easytrieve/Plus outputs these records to the data set after the last print record, but immediately before closing the file. Record Format - Line Mode For Line Mode printers, a print data set consists of three types of records. The following chart illustrates these records: File Header Records File Header Records are defined in the extended reporting options module. File Header Records output information necessary to initiate the printer for the print records that follow. CA-Easytrieve/Plus outputs the file header records immediately after opening the file but before outputting any print records. System Concepts 3 33

54 Printer Characteristics Print Records Print data sets consist mainly of print records. Each print record that the Extended Reporting Facility builds can contain up to four components, which are: Carriage Control The Carriage Control code always starts the record. Overprint Code The Overprint Code is only required for printers that use multiple print records to support mixed fonts on one print line. If required, this code always follows the Carriage Control code. Function Codes If a printer requires special control codes in the print record to identify different fonts and data types, then CA-Easytrieve/Plus mixes Function Codes with Print Items in the print record. Function Codes are not present for printers that do not require such control information. Print Items Print Items include fields and literals that contain the data for the final print line. When the printer requires Function Codes, CA-Easytrieve/Plus mixes print items with Function Codes in the print record. If the printer does not require Function Codes, the print record only contains Print Items. The maximum length of a print record is the maximum record length of the print data set that receives the record. Should a print record exceed that size, a runtime error results. This error stops the execution of the program and results in the printing of an error message. File Trailer Records File Trailer Records are similar to the File Header Records. File Trailer Records contain control information and are defined in the extended reporting options module. Each File Trailer Record is a logical record on the print data set. CA-Easytrieve/Plus outputs these records to the data set after outputting the last print record but immediately before closing the file CA-Easytrieve/Plus Extended Reporting Facility Guide

55 Printer Characteristics File Format The format of a print data set defines the relationship between print records that CA-Easytrieve/Plus builds and the physical records CA-Easytrieve/Plus outputs to the data set. The three formats for a print data set that the Extended Reporting Facility supports are: Unblocked Records, Blocked Records, and Concatenated Records. The following chart illustrates the three formats. Blocked Records This file type supports logical records that are either fixed or variable in length. CA-Easytrieve/Plus combines the records to form a block. CA-Easytrieve/Plus builds variable length print records. Their size is the minimum required to contain the components required to produce the print line. For print data sets that support variable length records, the length of the print record remains the same. For files requiring fixed length records, CA-Easytrieve/Plus must pad the print record to fit into the defined record length. The padding operation uses two attributes of the extended reporting printer that you must identify in the extended reporting options module. A Record-End string defines the control character(s) that delimits the print record. The Report-Pad string defines the character(s) that begin immediately after the Record-End and continues to the end of the record. System Concepts 3 35

56 Printer Characteristics Unblocked Records This file type is very similar to the Blocked records format except that each logical record is also a physical record. CA-Easytrieve/Plus builds variable length print records. Their size is the minimum required to contain the components required to produce the print line. For print data sets supporting variable or undefined record lengths, CA-Easytrieve/Plus outputs the print record using the length of the original print record. For fixed length record print data sets, CA-Easytrieve/Plus must pad the print record to fit into the defined record length. The padding operation uses two attributes of the extended reporting printer that you must identify in the extended reporting options module. A Record-End string defines the control character(s) that delimits the print record. The Report-Pad string defines the character(s) that begin immediately after the Record-End and continues to the end of the record. Concatenated Records Externally, this file type looks like the unblocked file format. In contrast though, this file type concatenates logical records of varying lengths into one long data stream of print records. Each time CA-Easytrieve/Plus outputs a print line, it concatenates the associated print records onto the end of the file's current physical record. CA-Easytrieve/Plus outputs the physical record only when a print record does not fit into the remainder of the file's physical record area. This process is similar to the building of a block consisting of variable length records except with concatenated records, the four-byte RDW (Record Description Word) that contains the record's length is not added to the start of the record. When a print record's length exceeds the maximum record length of the print data set, a runtime error occurs. For file types using Variable and Undefined record formats, the length of the output record equals the total of all the concatenated print records that fit into the maximum physical record. To support the Fixed length physical record (that is F lrecl ) with the concatenation option, the extended reporting options module must identify a Record-End and a Record-Pad string. Because CA-Easytrieve/Plus generates print records that are variable in length, there is no guarantee that each block terminates at the end of the fixed length physical record. Therefore, to fill out a block, CA-Easytrieve/Plus inserts a Record-End string immediately after the last print record. CA-Easytrieve/Plus adds the pad string to the end of the physical record starting immediately after the Record-End string CA-Easytrieve/Plus Extended Reporting Facility Guide

57 Printer Characteristics This file format requires separate consideration with respect to Structured Field printers and Line Mode printers. Concatenated Records - Structured Fields For All Points Addressable printers, the concatenation process is only applicable to Format Page Records. The other four types of records required by this type of printer are output in separate blocks. The following chart illustrates this characteristic. System Concepts 3 37

58 Printer Characteristics Concatenated Records - Line Mode For Line Mode printers CA-Easytrieve/Plus concatenates output records except for File Trailer Records. For Concatenated Records, the File Trailer Records are output at the start of their own physical record. Before closing the print data set, CA-Easytrieve/Plus outputs the last physical record containing print records. Then, CA-Easytrieve/Plus concatenates the File Trailer Records at the start of a new physical record. This new record, once built and output, is the last one on the print data set. The following chart illustrates this relationship for Line Mode print data sets requiring Concatenated Records: 3 38 CA-Easytrieve/Plus Extended Reporting Facility Guide

59 Font Characteristics Font Characteristics In addition to defining the characteristics of the extended reporting printers, you also must define the fonts that CA-Easytrieve/Plus can use in a print line. In terms of this discussion, a font is a collection of graphic characters of a given typeface and size. You must define fonts in the extended reporting options module. Fonts are associated with an extended reporting printer and each one is given a unique font identifier number (1 to 256). It is the font identifier that you code in a CA-Easytrieve/Plus program to associate the characteristics of a font to a print item, such as a field or a literal. Using these characteristics the Extended Reporting Facility is able to position the item correctly on the print line (using the W-unit and H-unit assigned to the font) plus build the print record(s) to produce the correct results. The following example illustrates the use of the font identifier: Data Type The three types of data that CA-Easytrieve/Plus supports are EBCDIC, DBCS, and MIXED data types. 1. The EBCDIC data type consists of characters defined using a single byte. For CA-Easytrieve/Plus, this data type includes the field types of Alphabetic, Packed, Zoned Numeric, Unsigned Packed, and Binary, plus numeric and quoted EBCDIC literals. 2. The DBCS (Double Byte Character Set) data type consists of those characters defined using two bytes. This data type represents non-phonetic languages such as Japanese. This data type supports the DBCS field type, plus the DBCS and Conversion literals. 3. The MIXED data type is for fields containing a combination of EBCDIC and DBCS data types. Special Shift Codes identify one data type from the other. This data type supports MIXED fields and MIXED format literals. System Concepts 3 39

60 Font Characteristics You can define a font to support any one of the above data types. For EBCDIC and DBCS data types, the definition of the font must include all the characteristics of that font. A font for MIXED data types defines two other fonts. It defines the font that CA-Easytrieve/Plus uses to process the EBCDIC portion of the MIXED field and the font that CA-Easytrieve/Plus uses to process the DBCS portion of the field. When using a font, the data type of the field or literal to which the font has been assigned must match the data type that the font supports. If this is not the case, a syntax error results. Height and Width For each font that the extended reporting options module defines, you must define the width of the font as a number expressed in terms of the selected W-units. CA-Easytrieve/Plus only requires the definition of the height of a font when the Carriage Control system of the extended reporting printer does not support the ANSI or Machine systems in association with a Forms Control Block (FCB). When CA-Easytrieve/Plus requires the height definition, you must define it as a number expressed in terms of the selected H-units. Overprint Code If the extended reporting printer supports Overprint Codes, all of the fonts associated with that printer must include the Overprint Code. The FONT command defines the overprint code. Chapter 4 discusses the FONT command in detail. Function Header and Function Trailer If the extended reporting printer supports Function Codes, you must specify either the Function Header, the Function Trailer, or both. You specify these attributes by using the FONT command. Chapter 4 discusses the FONT command in detail. Space Replacement For printers that support Overprint Codes and use the Merge Overprint technique to combine print records, the space character (X'40') is important. This includes the occurrences of the EBCDIC space or the occurrences of the IBM DBCS code system space (X'4040'). From the point of view of certain printers, there is no difference between them CA-Easytrieve/Plus Extended Reporting Facility Guide

61 Font Characteristics The reason that the space is important is best demonstrated by an example. In the following example, a DISPLAY statement builds a print line containing three literals. The first and third literals are to be output as 7-point characters and the second is to be output at 9-point. Assuming the printer supports Overprint Codes and uses the Merge Overprint technique, CA-Easytrieve/Plus builds two print records. The following example also demonstrates these records and the resultant print line. Note: Spaces in the first print record are replaced by non-blank characters in the second. Also, that a space in all the print records prints a space whose size is that defined by the font of the first print record. System Concepts 3 41

62 Font Characteristics CA-Easytrieve/Plus automatically compensates for space replacement when it assigns fields to print positions on a print line and when it determines the spacing between print items. However, CA-Easytrieve/Plus cannot directly control the occurrence of spaces in the fields or literals that it moves into print records. CA-Easytrieve/Plus assumes that each character in a print item is output at the same size; that size being defined by the width of the print item's assigned font. CA-Easytrieve/Plus prints the size of space characters in an overprint record as the size of the space in the first record. The following example displays this CA-Easytrieve/Plus Extended Reporting Facility Guide

63 Font Characteristics The previous example illustrates that a space in the second literal results in the character being positioned on the print line using the 7-point space (as opposed to the 9 point space that was requested for the print item). The result of this process is demonstrated by comparing the print line produced by this example with the next example. The previous example illustrates that the size of the second character in the second literal coded on the DISPLAY statement now prints at 9 point (as opposed to the space character in the previous example that printed at only 7 point). The impact of the presence of the space in the literal (as opposed to a non-blank character) cause the characters that follow the space character to shift left 2 points on the print line. This is not an error but a feature of the printer. CA-Easytrieve/Plus cannot prevent this from occurring. System Concepts 3 43

64 Font Characteristics CA-Easytrieve/Plus compensates for spaces between print items, but does not compensate for spaces occurring within a print item. There are three approaches that you can use to solve this problem. Ensure that the fonts being mixed on one print line all have the same W-unit width. Ensure that any field or literal that occurs on a print record other than the first does not contain spaces. Define an alternative space within each font set that CA-Easytrieve/Plus uses. Nothing prohibits you from modifying a font set to replace one of the unused graphic characters with a space character. Once this replacement space has been assigned to a font defined in the extended reporting options module, CA-Easytrieve/Plus automatically scans the contents of each field or literal that uses this font. The scan occurs after CA-Easytrieve/Plus moves the field or literal to the print record. The scan replaces all occurrences of the normal space character with the replacement space. This ensures correct spacing on the report. For printing DBCS data using the IBM DBCS code system, an alternative DBCS space is already provided. CA-Easytrieve/Plus associates this character (X'4242') with every DBCS font defined in the extended reporting options module for IBM printers that use the Merge Overprint technique. CA-Easytrieve/Plus then scans each DBCS field or literal and replaces the normal DBCS space X'4040' with this alternative space. Double Byte Alignment Some printers that support Function Codes require Function Codes to occur on Double Byte boundaries within Print Records. The only components of a Print Record that this alignment problem affects are EBCDIC print items. For printers that require double byte alignment, DBCS data and the function codes are all two bytes in width. It is only those EBCDIC print items (fields and literals) whose length is not a multiple of two that must have their length increased by one. Some printers provide a special character for this function and others do not. For printers that provide a special NOP (No Operation) control character, CA-Easytrieve/Plus adds the special NOP to the end of the print item. The width of the additional character is not taken into account when the printer positions the print item on the print line. For printers that do not provide a special control character for this function, CA-Easytrieve/Plus adds a space character to the field. If this is the case, CA-Easytrieve/Plus must incorporate the width of the space character into the positioning of the print item on the print line. Where possible, CA-Easytrieve/Plus incorporates this space increase into the space following the print item on the print line. If no spacing follows this item, the net affect of double alignment is to increase the size of the field or literal by one CA-Easytrieve/Plus Extended Reporting Facility Guide

65 Font Characteristics Line Complexes A special printing feature of some extended reporting printers is the ability to define Line Complexes. For example, the IBM 3200 and the HITACHI 8196 support the ability to expand a print item across multiple lines (2 or 4). This means that the print items height is multiplied by the number of lines that the print item includes but its width remains the same. The best way to describe a Line Complex is by a diagram. As shown in the following example, a print item involved in a line complex must be included in all of the print records that generate the print lines that the Line Complex covers. For a two-line Line Complex, the print item must be included in the two print records that are combined to form the line complex. For four-line complexes, the print item must be included in four print records. System Concepts 3 45

66 Font Characteristics A font defined for an extended reporting printer that supports Line Complexes can include the Line Complex attribute. CA-Easytrieve/Plus then positions the print item assigned to such a font on the appropriate number of print lines. It is up to you to ensure that no other print items are positioned in the same area of those print lines that a Line Complex element occupies. If this occurs, a syntax error results CA-Easytrieve/Plus Extended Reporting Facility Guide

67 Report Layout Processing Report Layout Processing You request printed output from a CA-Easytrieve/Plus program by using either the TITLE, LINE or DISPLAY statements. CA-Easytrieve/Plus then interprets the appropriate statement(s) and based on a set of user modifiable parameters (SPACE, SKIP, LINESIZE, PAGESIZE, and so on), automatically formats the print line(s). From this format, CA-Easytrieve/Plus builds the print records that produce the correct lines. The Extended Reporting Facility does not change this process. CA-Easytrieve/Plus still automatically formats the print line(s) and builds the print records. The impact of the Extended Reporting Facility concerns the processing that CA-Easytrieve/Plus must perform to format a report. Because CA-Easytrieve/Plus now supports multiple fonts and extended reporting printers, CA-Easytrieve/Plus can no longer rely on the same formatting algorithm that supported line printers. The CA-Easytrieve/Plus process to format a print line still supports all the standard line printer report generation options, but a number of considerations influence the format of the resultant print line. This section discusses these considerations. Reading this section ensures that you can analyze and explain the results that you obtain by using an extended reporting printer, when they differ from the results that you obtain when using a standard line printer. This section discusses the following subjects: LINE element processing. MIXED field printing. Print Item positioning considerations. LINE Element Processing. The standard CA-Easytrieve/Plus reporting system positions items on a print line using three rules: 1. LINE 01 items and their associated headings are centered in an area whose length is controlled by the longer of the following: a. The line item entry. This item is expanded by the value of SUMSPACE if the item is a field that is summarized. b. The longest heading entry. The resulting value is called the item length or item window. 2. The first line item other than on LINE 01 (that is LINE 02 through LINE 99) is positioned under the first item of LINE 01. The data is left-justified under the LINE 01 data regardless of the heading size. System Concepts 3 47

68 Report Layout Processing 3. Blank characters (spaces) separate all line items according to the value of the SPACE parameter of the REPORT statement. In addition, the number of spaces can be altered by the +/- spacing options plus the effect of the SPREAD operation. The Extended Reporting Facility changes this process in one way. CA-Easytrieve/Plus must calculate the length of each of the elements associated with LINE 01 line items (namely the heading, detail and summary line elements) as: (number of chars in element) X (width of font assigned to element) Where the width of the largest element defines the size of the item's window. This process can result in some change to the format of a CA-Easytrieve/Plus report when the print item has heading and detail elements that use fonts of different width. This situation impacts the process CA-Easytrieve/Plus uses to determine the appropriate window for the print item. When you are using fonts of different widths for the elements of any item coded on the LINE 01 statement, CA-Easytrieve/Plus must determine a window for the item. This window includes any adjustments necessary to ensure that all the elements of the item fit within the window after each element has been positioned on its applicable print record. This means that the window can be larger than CA-Easytrieve/Plus originally determined. The next five examples illustrate the effect of mixing fonts of different sizes in a report. The following example illustrates CA-Easytrieve/Plus syntax that uses multiple fonts. CA-Easytrieve/Plus Syntax: DEFINE TEST-FIELD A + HEADING (#1 'THE FIRST LINE' 'THE SECOND LINE') DEFINE TEST-FIELD A + HEADING (#2 'SECOND FIELD HEADING').. JOB INPUT.. LINE 1 #1 TEST-FIELD-1 TEST-FIELD-2 The following syntax describes the fonts that the above example references. FONTS W-UNIT SIZES default 10 #1 8 # CA-Easytrieve/Plus Extended Reporting Facility Guide

69 Report Layout Processing To create a print line, CA-Easytrieve/Plus must analyze the heading lines and the detail lines (the contents of TEST-FIELD-1 and TEST-FIELD-2) taking into account the size of the fonts. CA-Easytrieve/Plus then calculates a window that is large enough to encompass each of the elements of the print item that is to be output to the print line. The following example illustrates the windows that CA-Easytrieve/Plus creates using the syntax in the CA-Easytrieve/Plus Syntax example. System Concepts 3 49

70 Report Layout Processing After calculating the windows, CA-Easytrieve/Plus determines the format of each of the print lines. To do this, CA-Easytrieve/Plus must center each print element within its own window and then determine the correct amount of space between those elements that occur on the same print line. This step is illustrated in the following example. As is shown above, there are four gaps that must be filled with spaces by CA-Easytrieve/Plus. CA-Easytrieve/Plus attempts to fill each gap using a combination of the fonts assigned to print items on the original CA-Easytrieve/Plus statement CA-Easytrieve/Plus Extended Reporting Facility Guide

71 Report Layout Processing In this example, not only does CA-Easytrieve/Plus use the default font (size of 10 points), but also font #1 (8 points in width) and font #2 (7.2 points). CA-Easytrieve/Plus analyzes each gap individually and tries to determine the spacing factors that positions an element as close as possible to its assigned print position. For the current example, the following example illustrates the results produced by CA-Easytrieve/Plus. As illustrated by the previous example, the first gap on Heading Line 1 was filled by 2 spaces using the 7.2-point font. This is as close to print position 14 as was possible with the available fonts. For the gap on Heading Line 2, the insertion of 3 spaces using the 10-point font filled the gap exactly. On the Detail Line, the first gap was filled by 6 spaces using the 7.2-point font. The second gap to be filled on the Detail Line was originally 95 points wide but because the first gap on this same line actually increased, the second gap was reduced by 0.2 points (the increase in the first gap). The resultant gap of 94.8 was then filled exactly by CA-Easytrieve/Plus using a combination of 9 spaces of 7.2 points in width and 3 spaces of 10 points in width. Consequently, CA-Easytrieve/Plus was able to position the second element on the Detail Line exactly at its assigned print position. As was illustrated by Heading Line 1 in the previous example, when CA-Easytrieve/Plus cannot position an element at its assigned print position, CA-Easytrieve/Plus positions the element as close as possible to its assigned position. If this movement of the element results in the element moving outside the item window for the element, the window expands and all the elements to be positioned in that window are re-centered. The spacing between elements on the same print line are then re-calculated. System Concepts 3 51

72 Report Layout Processing When CA-Easytrieve/Plus expands the size of a window, CA-Easytrieve/Plus ensures that a window does not overlap another window. This technique ensures that no two elements on the same print line ever overlap. MIXED Field Printing True Print Width Base Print Width CA-Easytrieve/Plus supports EBCDIC, DBCS (Double Byte Character Set), and MIXED data types. MIXED data types contain both EBCDIC and DBCS data, with the Shift Codes identifying the DBCS data (EASYTRIEVE supports two shift code systems, see the DBCS Option User Manual for more details). Because MIXED fields contain DBCS data, you can only define them on print lines that are to be directed to extended reporting printers that support DBCS data. The length of the MIXED field does not directly determine the size of the print item on the print line. Normally, the number of bytes in an Alphabetic type field multiplied by the print width of each character (in W-units) gives the size of that print item on the print line. CA-Easytrieve/Plus automatically performs this calculation during its compile phase and is thus able to position the field within its appropriate window. For MIXED format fields, CA-Easytrieve/Plus cannot perform the same calculation. This is because: The support of a MIXED field requires the support of two fonts for the same print item. One for the EBCDIC data and a second for the DBCS data. CA-Easytrieve/Plus cannot determine the number of EBCDIC and DBCS characters in the field at compile time. It must analyze the actual contents of the field during execution of your program to determine the actual mix of EBCDIC and DBCS data. As a result, CA-Easytrieve/Plus uses a special algorithm to analyze the length of a MIXED field along with the size of the EBCDIC and DBCS fonts assigned to that print item. This algorithm calculates two print widths for the field: This W-units value defines the minimum print width of the MIXED field. This print width is calculated so that any combination of EBCDIC and DBCS data in the field plus the appropriate combination of EBCDIC and DBCS padding always prints at the one True Print Width. This W-units value defines the maximum print width of the data in the MIXED field. From all the combinations of EBCDIC and DBCS data in the field, one combination has the largest print width. CA-Easytrieve/Plus determines this combination and calculates the Base Print Width CA-Easytrieve/Plus Extended Reporting Facility Guide

73 Report Layout Processing The Base Print Width is always less than or equal to the True Print width. Any difference between these two values is always formatted as spaces by CA-Easytrieve/Plus. The additional spacing is added by CA-Easytrieve/Plus to ensure that any combination of EBCDIC and DBCS data in the MIXED field prints at the one width - the True Print Width. By filling out the MIXED field to the same length irrespective of the field's contents ensures that print items that follow the MIXED field on a print line always start at their assigned print position. For printers that support Structured Fields (All Points Addressable printers), the Base Print Width is always equal the True Print Width. The ability to position a field on the print line independent of any other field permits a MIXED field to be formatted at any print width. It does not disturb the positioning of other print items on the same print line. CA-Easytrieve/Plus always uses the True Print Width when allocating the MIXED field's window as this value represents the print space required to format and print the field's contents. CA-Easytrieve/Plus only uses the Base Print Width when the MIXED field is followed by another print item on the same print line and the second print item is positioned some number of spaces to the right of the end of the MIXED field. In this situation, CA-Easytrieve/Plus reduces the spacing between the two print items by the difference between the True Print Width and the Base Print Width. CA-Easytrieve/Plus is able to do this as the difference between these two values is always spaces. This means that the MIXED field can be formatted correctly into its True Print Width yet appear on the output as though only the Base Print width was allocated to the field. The print width of the MIXED field on the report appears to be smaller than the True Print Width calculated by CA-Easytrieve/Plus. To help illustrate this process, assume that a 50-byte MIXED field is to be printed followed by 3 DBCS spaces and then a 10-byte DBCS field. The EBCDIC font for the MIXED field produces 6-point characters and the DBCS font for the MIXED field, the spacing and the DBCS field produces 9.6 point characters. For the MIXED field, CA-Easytrieve/Plus calculates the True Print Width as 324 points while the Base Print Width is the print width of an all EBCDIC field or 300 points (50 characters at 6 points each). System Concepts 3 53

74 Report Layout Processing The DBCS field prints at 48 points with 28.8 points of spacing between the two print items. The following example illustrates the results of positioning the DBCS field to the right of the MIXED field and ignoring the Base Print Width. Note: There is always spacing from print position 300 through to Now, examine the next example. Note: The 28.8 points of spacing between the two print items has been reduced by the difference between the MIXED field's True and Base Print Widths. Instead of 52.8 points of spacing between the MIXED field and the DBCS field (in the previous example), there is only 30 points (24 points being the difference between the True and Base Print Widths plus one EBCDIC space to get as close as possible to the required gap of 28.8 points). As demonstrated by the previous example, the apparent print width of the MIXED field is smaller than the print space required for the field. Not all situations give the same results. If the spacing between the MIXED and DBCS field is smaller than the difference between the True and Base Print Widths of the MIXED field, the actual spacing between the two fields increases. The True Print Width of the MIXED field must always be allocated so that CA-Easytrieve/Plus can format the field correctly CA-Easytrieve/Plus Extended Reporting Facility Guide

75 Report Layout Processing For example, assume that only two DBCS spaces are allocated between the two fields, that is, 19.2 points. The next example illustrates that the DBCS field is positioned adjacent to the end of the MIXED field's True Print Width. This means that the spacing between the two items is actually 24 points, an increase over the requested 19.2 points. This spacing cannot be overcome. CA-Easytrieve/Plus must have the True Print Width allocation on the print line so that it can correctly format the MIXED field when your program executes. Also, you must understand that the DBCS field has been positioned in this way. The fact that you requested two DBCS spaces between the MIXED and DBCS fields, yet the two fields are positioned adjacent to each other, can give results that are at first not obvious. For example, take the following CA-Easytrieve/Plus syntax: DEFINE ADDRESS W 50 M DEFINE NAME W 10 K : : : : REPORT NOADJUST SPACE 2 : LINE 1 ADDRESS NAME LINE 2 ADDRESS POS 2-1 NAME System Concepts 3 55

76 Report Layout Processing The result of formatting LINE 1 of the report, defined in the previous syntax, is the same as that illustrated in the previous example. This assumes that the default W-unit font for the report is the DBCS font with characters of 9.6 points. The result of processing LINE 2 of the same report is a syntax error. The error indicates that NAME overlapped a print item, namely the ADDRESS field. The reason for the error is not obvious as there should be two DBCS spaces between the two items on LINE 1, and the LINE 2 syntax specifies NAME to be positioned in only one of these spaces to the left of the position occupied by the second LINE 1 item. There should be space available to do this, so why the error? The error occurs because the two DBCS spaces on LINE 1 were absorbed into the MIXED field's True Print Width. As a result, the DBCS field on LINE 1 starts at position 324 on the print line. This is the POS 2 value. When CA-Easytrieve/Plus reduces POS 2 by the -1 DBCS space, the start position for NAME on LINE 2 is This print position is occupied by the ADDRESS field on LINE 2 as it starts at print position 0 and has a True Print Width of 324. The NAME field overlaps the ADDRESS field on LINE 2. MIXED Field Font Selection When you generate the extended reporting options module, you can define the fonts to be used by CA-Easytrieve/Plus when processing a MIXED field. For each MIXED font that you define, you must identify an EBCDIC and DBCS font that is to be used to format the respective data types of a MIXED field. An important factor that you must consider when selecting the EBCDIC and DBCS fonts are the print widths of these two fonts. When CA-Easytrieve/Plus calculates the Base and True Print Widths of a MIXED field, the size of the MIXED field and the print widths of the assigned EBCDIC and DBCS fonts are the chief inputs. The degree to which the True Print Width exceeds the Base Print Width (and thus results in additional spacing to the right of the MIXED field) is primarily dependent on the Lowest Common Denominator of the print widths of the applicable EBCDIC and DBCS fonts. A rule of thumb dictates that a Lowest Common Denominator, which is small relative to the print widths of the two fonts, denotes a smaller difference between the Base and True Print Widths than does a Lowest Common Denominator, which is large relative to the print widths of the two fonts. When the Lowest Common Denominator is small relative to the print widths of the two fonts, there exists many other common denominators greater than the Lowest Common Denominator. This means the algorithm that calculates the True Print Width has a greater possibility of calculating a True Print Width that is very close to the Base Print Width. The next example shows the relationship between the print widths of the two fonts, their Lowest Common Denominator and the resultant True Print Width CA-Easytrieve/Plus Extended Reporting Facility Guide

77 Report Layout Processing Note: The fonts at the top of the table produce better True Print Widths than those towards the bottom. In addition, the worst case situation is illustrated by the EBCDIC 7-point font and the DBCS 7.2 font. Because the Base Print Width of the 20-byte field does not exceed the Lowest Common Denominator of 252, the maximum True Print Width of has been calculated by CA-Easytrieve/Plus. The maximum True Print Width for any MIXED field is calculated by summing the maximum number of EBCDIC characters times the EBCDIC font size (20 7 = 140) and the maximum DBCS characters times the DBCS font size (9 7.2 = 64.8). The maximum True Print Width occurs when the two font sizes do not have a relatively small Lowest Common Denominator and as a result, are a poor combination for MIXED fields. As the relationship improves (the Lowest Common Denominator becomes relatively smaller), the True Print Width falls from the maximum True Print Width to the Base Print Width. The best MIXED font combinations are those that result in the True Print Width equaling the Base Print Width. Also, the next example illustrates the impact of an EBCDIC font that requires double byte alignment. Double byte alignment is a requirement of certain extended reporting printers. The alignment attribute means that CA-Easytrieve/Plus, when calculating the True Print Width, must take into account the addition of an EBCDIC space to any odd length EBCDIC subfield in the MIXED field. Automatically, CA-Easytrieve/Plus incorporates this attribute into the True Print Width calculation. The impact of this attribute is also related to the Lowest Common Denominator of the print widths of the assigned EBCDIC and DBCS fonts. System Concepts 3 57

78 Report Layout Processing MIXED Field Support of Merge Overprint The algorithm, which CA-Easytrieve/Plus automatically uses to determine the size of a MIXED field, must use two fonts. One font is for the EBCDIC portion of the MIXED field, and the second font is for the DBCS portion. This algorithm means that some combinations of EBCDIC and DBCS data within a MIXED field do not completely fill the window assigned to the field in the print record. Therefore, CA-Easytrieve/Plus must pad the MIXED field on the right with spaces. To determine the minimum window for the field while incorporating the padding factor, CA-Easytrieve/Plus uses the size of the space characters of EBCDIC and DBCS fonts assigned to that MIXED field. This process generally does not present a problem as the majority of the printers support the printing of multi-sized EBCDIC and DBCS spaces. The printers that do not support function codes but support the Merge Overprint technique for combining multiple print records on the same print line are the exception. As presented earlier, when examining the functions of the Space Replacement character, merge processing ignores the fact that the character X'40' represents an EBCDIC space in one print record and represents part of a DBCS space in a different print record. The final size of the space is always the first space output. This means that the fonts assigned to the EBCDIC and DBCS portions of a MIXED field can have different widths. If the space character is the same, the size of both spaces on output are the same. As a direct result of this, support of MIXED fields on a print line directed to a printer supporting such an attribute is restricted to those DBCS fonts assigned a Space Replacement character. If this is not the case, CA-Easytrieve/Plus cannot support MIXED fields. Print Item Positioning Considerations The various characteristics of the numerous printers, which the CA-Easytrieve/Plus Extended Reporting Facility supports, has given rise to a number of limitations with respect to item positioning on a print line that the Extended Reporting Facility cannot overcome. These limitations are primarily caused by the techniques required by printers to build print records. This section describes each of these limitations in turn. Overprint Gap This output consideration was introduced by the discussion regarding the Print Overprint technique for combining multiple print records on the one print line. The Overprint Gap results from the printer imaging each print record independent of other print records that can appear on the same line. Once the printer images the records, the printer combines the records to form the print line that is output to the page CA-Easytrieve/Plus Extended Reporting Facility Guide

79 Report Layout Processing As a result of imaging each line separately (as opposed to the Merge Overprint technique which does not suffer from this limitation), the ability to position print items of different fonts (thus different print records) adjacent to each other is restricted. The following example illustrates the reasons. Assume that three characters of different fonts must be printed adjacent to each other. The first character is an output using a 9-point font, the second output uses a 12-point font, and the third output uses a 7-point font. As a result, three print records are built; each with their own font indicator after the Carriage Control. The following example illustrates these three records. Note: The second print record cannot have the 12-point character in the first byte of the print record or it prints over the character output by the first print record. Therefore, CA-Easytrieve/Plus must insert one space byte into the 12-point print record before the actual character. This space prints at 12 points, thereby positioning the 12-point character to the right of the 9-point character. System Concepts 3 59

80 Report Layout Processing In doing this, the position of the 12-point character is not adjacent to the 9- point character. The 12-point space is 3 points too large but nothing can be done to overcome this -- it is the Overprint Gap CA-Easytrieve/Plus Extended Reporting Facility Guide

81 Report Layout Processing The same process applies to the third character that is to print from a 7-point print record. To ensure that this character does not print over the 9- or the 12- point character, CA-Easytrieve/Plus inserts sufficient spaces before the 7-point character in the third print record. The correct amount of space is 24 points of spaces as the 7-point character cannot print over the 12-point character that is positioned 12 points from the start of the line ( = 24). For the 7-point print line though, 24 points of spacing is not possible using a 7 point space. The closest CA-Easytrieve/Plus can come to this figure is 28 (four 7-point spaces). As a result, there is a 4-point gap between the second and third characters. Again, another Overprint Gap. CA-Easytrieve/Plus automatically calculates the correct positioning of print items so they do not overlap, thereby incorporating this limitation into the positioning of items on a report. Item Placement Restrictions CA-Easytrieve/Plus reporting provides a set of features that permit you to specify the exact position where you want an item to appear on a print line. The use of the COL keywords on the DISPLAY, TITLE, and LINE statements, and the POS keyword on the LINE and DISPLAY statements both provide this ability. With the Extended Reporting Facility, getting the item precisely at the requested COL or POS position depends upon the use of multi-sized fonts within the report. If you are using only one font, no problems arise. If you are using multiple fonts, it might not be possible to position the print item exactly at the requested location. All extended reporting printers except All Points Addressable printers suffer this limitation. The best way to explain this restriction is by an example. The final example illustrates the use of a printer that supports the Print Overprint technique of font combination on a line. Assume that CA-Easytrieve/Plus is to position two 7-point characters on the print line starting in COLumn 3. If the default W-unit for the assigned extended reporting printer is 12 points, the COL value of 3 is interpreted as 2 X 12 points, thus 24 points from the start of the print line. The characters though must print from a print record producing 7-point characters. As a result, the closest CA-Easytrieve/Plus can position the two characters to their assigned location is 28 points (4 X 7 point spaces). CA-Easytrieve/Plus cannot solve the inability to position the characters on the 24th point. System Concepts 3 61

82 Report Layout Processing CA-Easytrieve/Plus permits the effects of this limitation when it occurs by positioning the print item as close as possible to the assigned location, but always on the right side of the location CA-Easytrieve/Plus Extended Reporting Facility Guide

83 Chapter 4 Extended Reporting Options Module Introduction The Extended Reporting Facility is installed during the CA-Easytrieve/Plus installation process. To activate this facility you must generate the extended reporting options module to define the characteristics of the extended reporting printer(s) that CA-Easytrieve/Plus uses. If your installation has an extended reporting printer that this CA-Easytrieve/Plus feature supports, then read this chapter. The extended reporting printers that CA-Easytrieve/Plus supports are: IBM 3800-I, IBM 3800-II IBM 3800-III, IBM 3800-VIII IBM 3820 IBM 3200 XEROX 2700, XEROX 8700, XEROX 9700 FACOM 6715D, FACOM 6716D MELCOM 8250, MELCOM 8270, MELCOM 8290 HITAC 8196 TORAY 8500 SHOWA INFORMATION SYSTEM SP7, SP8 MEMOREX 1500,1520 This chapter defines the process that you should follow to generate the extended reporting options module. Note: You should read the previous chapter, System Concepts, before generating this module. Extended Reporting Options Module 4 1

84 Introduction Installation Steps The normal CA-Easytrieve/Plus installation includes all the components necessary to support the Extended Reporting Facility. The only step that you must complete before CA-Easytrieve/Plus can support an extended reporting printer is to generate the extended reporting options module. A program (EZTPX04), installed on the CA-Easytrieve/Plus executable library during normal CA-Easytrieve/Plus installation, builds the extended reporting options module (EZTPXRPT). Use the following sample JCL to instruct EZTPX04 to build the EZTPXRPT module. For OS/390: //jobname JOB accounting.info,region=1024k //XRPT01 EXEC PGM=EZTPX04 //STEPLIB DD DSN=your.eztp.loadlib,DISP=SHR //SYSPRINT DD SYSOUT= //SYSLIN DD DSN=&&XRPT,DISP=(MOD,PASS), // UNIT=SYSDA,SPACE=(80,(200,50)) //SYSIN DD XRPT COMMANDS here / //XRPT02 EXEC PGM=IEWL,PARM='LET,LIST,NCAL,MAP', // COND=(0,NE,XRPT01) //SYSUT1 DD UNIT=SYSDA,SPACE=(1700,(600,100)) //SYSLMOD DD DSN=your.eztp.loadlib,DISP=SHR //SYSPRINT DD SYSOUT= //SYSLIN DD DSN=&&XRPT,DISP=(OLD,DELETE) // DD NAME EZTPXRPT(R) / // OS/390 Installation Notes: 1. Change the JOB statement to conform to your installation's standards. 2. Change the data set name in the STEPLIB DD statement to the name of the library where CA-Easytrieve/Plus resides. 3. Change the data set name in the SYSLMOD DD statement to the name of the library where the CA-Easytrieve/Plus extended reporting options module resides. 4 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

85 Introduction For VSE Pre SP2.1 $$ JOB JNM=eztpxrpt // JOB EZTPXOPT // DLBL EZTPLIB,'your.eztp.sysclb' // EXTENT,volser // DLBL IJSYSPH,'temp.disk.space',0,SD // EXTENT SYSPCH,volser,1,0,start,length ASSGN SYSPCH,DISK,VOL=volser,SHR // LIBDEF CL,SEARCH=EZTPLIB // OPTION NODECK,LOG // EXEC EZPTX04,SIZE=900K XRPT COMMANDS here / // JOB EZTPXOPT CLOSE SYSPCH,cuu ASSGN SYSPCH,cuu // DLBL EZTPLIB,'your.eztp.sysclb' // EXTENT,volser // DLBL IJSYSIN,'temp.disk.space',0,SD // EXTENT SYSIPT,volser,1,0,start,length ASSGN SYSIPT,DISK,VOL=volser,SHR // LIBDEF CL,TO=EZTPLIB // OPTION CATAL ACTION NOAUTO PHASE EZTPXRPT,+0 INCLUDE // EXEC LNKEDT,SIZE=128K / // JOB EZTPXOPT CLOSE SYSIPT,cuu ASSGN SYSIPT,cuu / /& $$ EOJ VSE Pre SP2.1 Notes: 1. Change the JOB statement to conform to your installation standards. 2. Change the file name and volser in the EZTPLIB DLBL and EXTENT statements to identify the library where CA-Easytrieve/Plus resides. 3. Change the file name, volser, starting and length tracks on the IJSYSPH, SYSPCH, IJSYSIN and SYSIPT ASSGN, DLBL and EXTENT statements to identify a temporary file used to pass the output of EZTPX04 to the linkage editor. 4. Change the cuu on the hard CLOSE and ASSGN statements for SYSPCH and SYSIPT to point back to the original addresses for SYSPCH and SYSIPT. Extended Reporting Options Module 4 3

86 Introduction For VSE SP2.1: $$ JOB JNM=eztpxrpt // JOB EZTPXOPT // DLBL EZTPLIB,'your.eztp.lib' // EXTENT,volser // DLBL IJSYSPH,'temp.disk.space',0,SD // EXTENT SYSPCH,volser,1,0,start,length ASSGN SYSPCH,DISK,VOL=volser,SHR // LIBDEF PHASE,SEARCH=EZTPLIB.sublib // OPTION NODECK,LOG // EXEC EZTPX04,SIZE=900K XRPT COMMANDS here / // JOB EZTPXOPT CLOSE SYSPCH,cuu ASSGN SYSPCH,cuu // DLBL EZTPLIB,'your.eztp.lib' // EXTENT,volser // DLBL IJSYSIN,'temp.disk.space',0,SD // EXTENT SYSIPT,volser,1,0,start,length ASSGN SYSIPT,DISK,VOL=volser,SHR // LIBDEF PHASE,CATALOG=EZTPLIB.sublib // OPTION CATAL ACTION NOAUTO PHASE EZTPXRPT,+0 INCLUDE // EXEC LNKEDT,SIZE=128K / // JOB EZTPXOPT CLOSE SYSIPT,cuu ASSGN SYSIPT,cuu / /& $$ EOJ VSE SP2.1 Notes: 1. Change the JOB statement to conform to your installation standards. 2. Change the file name and volser in the EZTPLIB DLBL and EXTENT statements to identify the library where CA-Easytrieve/Plus resides. 3. Change the file name, volser, starting and length tracks on the IJSYSPH, SYSPCH, IJSYSIN and SYSIPT ASSGN, DLBL and EXTENT statements to identify a temporary file used to pass the output of EZTPX04 to the linkage editor. 4. Change the cuu on the hard CLOSE and ASSGN statements for SYSPCH and SYSIPT to point back to the original addresses for SYSPCH and SYSIPT. Linking the EZTPXRPT module into the CA-Easytrieve/Plus executable library activates support for extended reporting printers. This is the only link required when you re-activate the Extended Reporting Facility after changing an option, such as redefining your printer's characteristics. The following discussion describes the Extended Reporting Facility options. 4 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

87 XRPT Commands Overview XRPT Commands Overview You can specify the Extended Reporting Facility options by using the SYSPRINT, PRINTER, and FONT commands. The SYSPRINT command defines the extended reporting printer that CA-Easytrieve/Plus uses for producing its output. If you do not specify this command then CA-Easytrieve/Plus uses the standard line printer format for producing its output. The PRINTER command defines the characteristics of an extended reporting printer that CA-Easytrieve/Plus supports. You must code this command once for each printer that you want CA-Easytrieve/Plus to support. The FONT command defines fonts that the Extended Reporting Facility uses. To define multiple fonts for a printer you must specify multiple FONT commands. You must include at least one FONT command (default EBCDIC font) in the generation of the extended reporting options module except in the following cases: When the most recently defined printer was defined using a model When the extended reporting printer defines a standard line printer. When using a model, the FONT command is optional. XRPT COMMANDS - Syntax Overview The syntax of each extended reporting options module command is discussed in this chapter under the complete command name (that is, SYSPRINT, PRINTER, FONT). The general syntax is: COMMAND KEYWORD1 (value1) KEYWORD2 (value2)... Syntax Rules When coding commands, follow these rules: 1. Each command must start on a new line. 2. Code commands anywhere in columns 1 through 72. The generation program ignores columns 73 through Start all XRPT commands with the command name. 4. Each operand is composed of a keyword and a value or values. Extended Reporting Options Module 4 5

88 XRPT Commands Overview 5. The value must immediately follow the keyword and be enclosed in parentheses. You must code at least one nonblank value within the parenthesis. 6. If you code multiple values within parentheses, you must separate each value by one or more blanks. 7. Balance parentheses. 8. You must delimit the XRPT command from each operand by one or more trailing blanks. 9. You can code blanks between any command, keyword, parenthesis or value, but you cannot code blanks within them. If you require blanks within a value, you must enclose the value in apostrophes. The maximum length of a value enclosed in apostrophes is 256 bytes. Whenever a value contains an embedded apostrophe, you must code two apostrophes. For example, specify the value 'O'KELLY as 'O''KELLY'. 10. You can continue commands on successive statements by coding a hyphen (-) as the last non-blank character on a line. The continuation resumes with the next non-blank character on the next line. Commands, operands, keywords, or values can be split across statements. 11. Code an asterisk () in column 1 to cause CA-Easytrieve/Plus to ignore the entire line. Use this type of line to code comments. You cannot continue comments by using a hyphen. You cannot code comments between continued lines. Example Define support for the IBM 3200 using the MODEL definition for the printer. SYSPRINT NAME ( PRINTER1 ) PRINTER NAME ( PRINTER1 ) MODEL ( IBM3200 ) Printer Control Code Specification Printer control codes are instructions to the printer. For example, printer control codes could tell the printer what font to use, where to print an item, and so on. Special syntax applies to the initial definition of a printer control code when: A printer control code is required for a keyword in the generation of the extended reporting options module; and That code requires the merging of special control data. 4 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

89 XRPT Commands Overview Examples of control codes that fall into this category include: The value for Point Skip operations (requires the insertion of the number of points to skip). Function Header codes that require the number of bytes of data that follow the code to be part of that code. Format Page headers (print record lengths and print record counts can be added to this code). Set Vertical Position (requires either an offset from the current Y-direction coordinate or the absolute address of the new Y-direction coordinate) and Set Horizontal Position (requires either an offset from the current X-direction coordinate or the absolute address of the new X-direction coordinate). See the individual commands later in this chapter for more details regarding the actual special code values. To satisfy the above conditions, CA-Easytrieve/Plus provides special characters that you can specify as printer control codes. You must define the data for a control code that is fixed (that is not modified by CA-Easytrieve/Plus) as a hexadecimal value (consisting of the letters A - F and the numbers 0-9). Where CA-Easytrieve/Plus is to merge special control data with the control code data, you must include a sequence of three characters in that hexadecimal value for each occurrence of a special control data subfield. These three characters define the characteristics of the special control data. You must code them in the supplied hexadecimal value such that they replace that portion of the control code that the special control data is to occupy. The format of these three characters is: Extended Reporting Options Module 4 7

90 XRPT Commands Overview Character 1 This character defines the format of the special control data that CA-Easytrieve/Plus merges with the printer control code. Code Description # Marks the start of special control data. The special control data is a binary number. & Marks the start of special control data. The special control data is Unsigned Packed Decimal number. Character 2 This character defines the type of special control data that CA-Easytrieve/Plus merges with the printer control code. You can use the following characters: Code S R B L V W H I Description Indicates that the value to be added is a point skip amount. Use this code only when defining the point skip code for the PRINTER command. Indicates that a record number is to be inserted into the control code. This number is the count of the number of records output to the print data set prior to the record containing this code PLUS 1. Indicates that CA-Easytrieve/Plus requires a data byte count. Use this code for printer control codes that must include a count of the number of bytes of print data. This includes those bytes after the control code up to the end-of-record or the next printer control code. Indicates that the length of the record containing this control code must be merged with the control code. This length does not include any bytes that can exist prior to the start of the subfield allocated to receive the count. This means that the count is from the start of the special control code subfield through to the end of the physical record. Is used in Set Vertical Position control codes to indicate the position for the Absolute Y-direction coordinate. Is used in Set Vertical Position control codes to indicate the incremental amount to be added to the current Y-direction coordinate. Is used in Set Horizontal Position control codes to indicate the position for the Absolute X-direction coordinate. Is used in Set Horizontal Position control codes to indicate the incremental amount to be added to the current X-direction coordinate. 4 8 CA-Easytrieve/Plus Extended Reporting Facility Guide

91 SYSPRINT Command Character 3 This character defines the length (in half bytes) of the special control code that CA-Easytrieve/Plus merges with the printer control code. This character must be a numeric value in the range of 1 to 8. This means that 4 bytes (8 half bytes) is the maximum width of a special control code. The following example illustrates the definition of a Function Header Code requiring the insertion of a data byte count (in binary) into the fixed portion of a printer function code for the TORAY 8500 Line Mode printer. SYSPRINT Command You can code this command only once in the command stream. The SYSPRINT command associates the characteristics of an extended reporting printer to the CA-Easytrieve/Plus system printer. The extended reporting printer that you specify on this command must be defined in the command stream. Use this command only if sending the CA-Easytrieve/Plus system output to an extended reporting printer. The output that CA-Easytrieve/Plus sends to this printer includes all the output that CA-Easytrieve/Plus generates (compilation listing, syntax error messages, DMAP, PMAP and Cross Reference listings, and so on) plus any printed output that a user program generates that is not directed to an alternative output file. Syntax SYSPRINT NAME (xrpt-name) - [SYSNO (value-1) ] Extended Reporting Options Module 4 9

92 SYSPRINT Command Keywords NAME (xrpt-name) NAME is a required keyword that defines the name of the extended reporting printer that receives the system output of CA-Easytrieve/Plus. Xrpt-name identifies one of the extended reporting printers defined by a PRINTER command within this command stream. CA-Easytrieve/Plus uses the characteristics of this extended reporting printer to build and format the required print records to produce system output. CA-Easytrieve/Plus uses the default EBCDIC font for the associated extended reporting printer for printing any EBCDIC data. CA-Easytrieve/Plus uses the default DBCS font (if coded) to print any DBCS data contained in the print lines. Neither of these fonts can support a Line Complex. The assigned extended reporting printer must support 132 bytes of print data and a minimum record length of 133 bytes. If either of these conditions are not met, the extended reporting printer cannot support CA-Easytrieve/Plus' system output. [SYSNO] This keyword is only applicable to VSE systems. Standard printed output from CA-Easytrieve/Plus is directed to SYSLST through the VSE Logical Input/Output module for Compiler Processing (called DTFCP). This module restricts the devices that SYSLST supports to printers. This module also restricts the data set characteristics to unblocked, 133-byte records. Therefore, if you assign SYSPRINT to an extended reporting printer, then you cannot use SYSLST. In this case, you must assign an alternative Programmer Logical Unit. The SYSNO keyword defines the number to be used for CA-Easytrieve/Plus system output. In addition to the logical unit number changing, CA-Easytrieve/Plus uses a file name of EZTLST instead of IJSYSLS. Therefore, when you assign an extended reporting printer to the CA-Easytrieve/Plus system output file, CA-Easytrieve/Plus directs the output to the logical unit that the SYSNO keyword defines and the file name becomes EZTLST. The device type for CA-Easytrieve/Plus system output is assumed to be a printer. If not altered, CA-Easytrieve/Plus uses the VSE Logical Input/Output module DTFPR. If you want to have CA-Easytrieve/Plus system output directed to DISK or TAPE, you must specify the applicable device type for the DEVICE keyword of the PRINTER command of the extended reporting printer assigned by the NAME keyword on this SYSPRINT command CA-Easytrieve/Plus Extended Reporting Facility Guide

93 PRINTER Command The record size of CA-Easytrieve/Plus system output is the larger of the LINESIZE option in the CA-Easytrieve/Plus Options module (see Appendix A of the CA-Easytrieve/Plus Installation Guide) or 121. The record format of CA-Easytrieve/Plus system output is fixed unblocked. Should you change either or both of these values, you must define the applicable values for the RECORD keyword of the PRINTER command of the extended reporting printer assigned by the NAME keyword on this SYSPRINT command. (value-1) This value defines the Programmer Logical Unit to be used as the logical unit for CA-Easytrieve/Plus system output. The value must be a number between 0 (for SYS000) to 240 (for SYS240). PRINTER Command Code this command once for each extended reporting printer that CA-Easytrieve/Plus supports. This command defines the characteristics of the printer. By default, CA-Easytrieve/Plus supports no extended reporting printers, so you must specify one PRINTER entry to activate the extended reporting options module. Extended Reporting Options Module 4 11

94 PRINTER Command Syntax PRINTER NAME (xrpt-name) - [ ] [ MODEL (model-name) ] [ ] [ STRUCTURED-FIELDS (value-1 value-2) - ] [ ] [ START-PAGE (record-1 record-2...) - ] [ [FORMAT-PAGE (record-1 record-2...)]- ]- [ [END-PAGE (record-1 record-2...)] ] [ ] [ OVERPRINT-CODES {MERGE} ] [ ({PRINT} value-3) ] [ { } ] [ ] [ TERMINAL (shift-out shift-in) ] [ ] {Y} [FCB {N} ] - {M} [POINT-SKIP (value-4 value-5)] - [DEFAULT-SIZE (font-1 [font-2]) ] - [DEFAULT-FORM (W-units-1 H-units [W-units-2 H-units-2])] [DEFAULT-FONT (font-3 [font-4 font-5])] - [DBCS-CODE (code-system)] - [ {DISK device-type} ] [ { [ ] } ] [ { [REWIND ] } ] [DEVICE ( {TAPE [UNLOAD ] }) ] - [ { [NORWD ] } ] [ { [ ] } ] [ {PRINTER } ] [RECORD (rec-fmt value-6 [value-7])] - [MAX-RECORD (value-8 [value-9])] - {Y} [CONCATENATE { } ] - {N} [RECORD-END (value-10)] - [RECORD-PAD (value-11)] - [REPEAT-CHAR (value-12)] - [FILE-HEADER (header-1 [header-2...])] - [FILE-TRAILER (trailer-1 [trailer-2...])] 4 12 CA-Easytrieve/Plus Extended Reporting Facility Guide

95 PRINTER Command Keywords NAME (xrpt-name) NAME is a required keyword on the PRINTER command. It defines the extended reporting printer name that is associated with the printer characteristics defined by: The other keywords on this PRINTER command. The fonts defined immediately after this PRINTER command. Xrpt-name is the 1-to 8-character extended reporting printer name. This name is user selectable but it must conform to the requirements of a CA-Easytrieve/Plus name. This means that it cannot contain any of the CA-Easytrieve/Plus delimiters including commas, apostrophes, left and right parenthesis, colons, and spaces. Code xrpt-name on the CA-Easytrieve/Plus FILE statement when using the file for extended reporting output. The xrpt-name associates the printer characteristics and fonts defined for this extended reporting printer with any printed output directed to that CA-Easytrieve/Plus file. See the CA-Easytrieve/Plus FILE statement for more details. MODEL MODEL is the keyword that generates the characteristics for an extended reporting printer by using one of a set of model definitions. MODEL, STRUCTURED-FIELDS, OVERPRINT-CODES, and TERMINAL are mutually exclusive. For information on the extended reporting models, refer to Chapter 6. Where an installation has a printer whose characteristics are covered by one of the models, the use of the MODEL keyword means that the definition of the printer's characteristics, through the use of the other PRINTER command keywords, is not necessary. On the other hand, the use of a model definition does not prohibit the use of the other keywords to modify the model's parameters. This means, if you code other keywords in addition to the MODEL keyword, then the additional options act as overrides for the characteristics established by the model. The use of the MODEL keyword also results in a set of fonts being associated with the defined extended reporting printer. You can modify or expand these fonts by using the FONT command after this PRINTER command. Extended Reporting Options Module 4 13

96 PRINTER Command model-name Model-name is the name of a model-extended reporting printer whose characteristics are known by the Extended Reporting Facility. The valid entries for model-name are: Model-Names Description IBM3800A Defines the characteristics that support the IBM 3800 Model I, II, III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers in compatibility mode. This model does not include support of DBCS data through the Extended Graphic Character Set. IBM3800B IBM3800C IBM3800D IBM3800E IBM3800F SHOWA7 SHOWA8 Defines the characteristics that support the IBM 3800 Model II, VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers (DBCS support) in compatibility mode. This model includes support of DBCS data through the Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model does not include support of DBCS data through the Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model does not include support of DBCS data through the Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model includes support of DBCS data through the Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model includes support of DBCS data through the Extended Graphic Character Set. Defines support for the SHOWA Informational Systems SP-7 printer. Defines support for the SHOWA Informational Systems SP-8 printer CA-Easytrieve/Plus Extended Reporting Facility Guide

97 PRINTER Command Model-Names M8250 M8290 T8500 IBM3200 H8196 F6715D Description Defines the characteristics of the MELCOM 8250 printer. Defines the characteristics of the MELCOM 8290 printing system. Defines support for the TORAY 8500 printer. Defines the characteristics of the IBM 3200 printing system. Defines support for the HITACHI 8196 printer. Defines support for the FUJITSU 6715D and 6716D printers. Chapter 6, Extended Reporting Models, contains a review of the characteristics and fonts automatically defined by the above set of models. [STRUCTURED-FIELDS] This keyword indicates if the extended reporting printer being defined supports Structured Fields. Printers that support Structured Fields permit Page or All Points Addressable printing. The STRUCTURED-FIELDS, MODEL, OVERPRINT-CODES and TERMINAL keywords are mutually exclusive. When using this keyword, you must define two values. The first hexadecimal string defines the data to be used as the printer control code for Set Vertical Position. The second value defines the hexadecimal string for the printer's Set Horizontal Position code. value-1 This hexadecimal value defines the control data that CA-Easytrieve/Plus uses to establish the Y-direction coordinate on the current page. Define value-1 using the characters A - F and the numbers 0-9. Additionally, you must include the special control code indicator for the insertion of either the Set Absolute Y-direction address (character 2 = V) or the Set Relative Y-direction address (character 2 = W). For information on the three-byte code, refer to XRPT Commands Overview, earlier in this chapter. value-2 This hexadecimal value defines the control data that CA-Easytrieve/Plus uses to establish the X-direction coordinate on the current page. Define value-2 using the characters A - F and the numbers 0-9. Additionally, you must include the special control code indicator for the insertion of either the Set Absolute X-direction address (character 2 = H) or the Set Relative X-direction address (character 2 = I). For information on the three-byte code, refer to XRPT Commands Overview, earlier in this chapter. Extended Reporting Options Module 4 15

98 PRINTER Command START-PAGE CA-Easytrieve/Plus requires this keyword if the printer being defined is a Page Printer (STRUCTURED-FIELDS keyword is specified). If the printer is not a Page Printer, it is invalid to specify this keyword and if specified, an error message is output. This keyword requires at least one value. Each value defines a hexadecimal string that consists of the characters A - F and the numbers 0-9. In addition, you must incorporate the appropriate three-byte code into the definition of the value if any of the control codes require the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character 2 = R). For information on the three-byte code, refer to XRPT Commands Overview, earlier in this chapter. [FORMAT PAGE] This keyword is optional if the printer being defined is a Page Printer (STRUCTURED-FIELDS keyword is specified). If the printer is not a Page Printer, it is invalid to specify this keyword and if specified an error message is output. This keyword requires at least one value. Each value must be a hexadecimal value that defines control data that CA-Easytrieve/Plus inserts at the front of each physical Format Page record output to this printer's data set. CA-Easytrieve/Plus does not include this code in any File Header, File Trailer, Start of Page, or End of Page records. Define each value using the characters A-F and the numbers 0-9. Additionally, if the control code requires the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character Z = R), you must include the appropriate three-byte code in the definition of the value. For information on the three-byte code, refer to XRPT Commands Overview, earlier in this chapter. [END-PAGE] This keyword is optional if the printer being defined is a Page Printer (STRUCTURED-FIELDS keyword is specified). If the Printer is not a Page printer, it is invalid to specify this keyword. This keyword, requires at least one value. Each value defines a hexadecimal string that consists of the characters A - F and the numbers 0-9. In addition, you must incorporate the appropriate three-byte code into the definition of the value if any of the control codes require the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character 2 = R). For information on the three-byte code, refer to XRPT Commands Overview, earlier in this chapter CA-Easytrieve/Plus Extended Reporting Facility Guide

99 PRINTER Command [OVERPRINT-CODES] This keyword indicates if the extended reporting printer supports Overprint Codes. The OVERPRINT-CODES, MODEL, STRUCTURED-FIELDS, and TERMINAL keywords are all mutually exclusive. If the printer requires control information immediately after the Paper Control code but before any Function codes or print text, then you must code this keyword. If you do not code this keyword, CA-Easytrieve/Plus does not support Overprint codes for this extended reporting printer. This keyword has two required operands: { MERGE} { } { PRINT} This required operand defines the technique that the printer uses to combine multiple print records into a single print line. Code the MERGE operand when the printer supports Overprint Codes and uses the Merge Overprint technique to combine multiple print records into the one print line. Code the PRINT operand when the printer being defined supports Overprint Codes and uses the Print Overprint technique to combine multiple print records into the one print line. The order in which CA-Easytrieve/Plus outputs overprint print records is controlled by the font number of the font defining the Overprint Code value. The first overprint record is the record whose Overprint Code is defined on a font with the lowest font number. The last overprint print record is the record whose Overprint Code is defined on a font with the highest font number. If your extended reporting printer requires overprint records in a specific order, you must take special care in assigning font numbers to the font for this printer. You must define the font numbers such that CA-Easytrieve/Plus can output the print records in the correct order. For more details regarding font numbers, see the NUMBER and OVERPRINT-CODE keywords of the FONT command later in this chapter. value-3 This required operand identifies the maximum number of print records that can be generated for the one print line. Value-3 must be a number between 1 and 256. Extended Reporting Options Module 4 17

100 PRINTER Command {TERMINAL} This keyword indicates that the output for this extended reporting printer is to be viewed on a terminal that supports Double Byte (KANJI) data. CA-Easytrieve/Plus formats the print records such that you can view the output on a terminal such as the IBM The important distinction between this type of extended reporting printer and an extended reporting printer that supports function codes is that the function codes for a TERMINAL extended reporting printer occupy character positions on the screen. Normally, function codes in a print record are instructions to the printer and do not occupy any space on the final print line. They are in fact absorbed by the printer. The display devices supported by the TERMINAL keyword do not delete the function codes - they occupy space on the display line equivalent to the size of one EBCDIC character. The two required values for this keyword define the appropriate codes to identify DBCS (Double Byte) data from EBCDIC data on a display line. The first value (Shift-out code) defines the control data to appear before DBCS data (Shift out of EBCDIC). The second value (Shift-in code) defines the control data to appear after DBCS data (Shift into EBCDIC). Each of these codes is assumed to occupy the space of one EBCDIC character regardless of the control codes length. The size of EBCDIC characters and DBCS characters is assumed fixed for this extended reporting printer type. The size of one DBCS character is assumed by CA-Easytrieve/Plus to be twice the size of one EBCDIC character. Therefore, CA-Easytrieve/Plus automatically generates three fonts for this extended reporting printer. Font Number 1 is for EBCDIC data and its size is assumed to be This is the default EBCDIC font. Font Number 2 is the DBCS data and its size is assumed to be This is the default DBCS font. Font Number 3 is for MIXED data and it is defined as a combination of fonts 1 and 2. This is the default MIXED font. Because the fonts are fixed by CA-Easytrieve/Plus, you cannot define additional fonts by the FONT command after this PRINTER command. The TERMINAL keyword is mutually exclusive with the OVERPRINT-CODES, MODEL, and STRUCTURED-FIELDS keywords. Only ANSI or Machine carriage control systems with an FCB are supported for this printer type so you cannot code the POINT-SKIP keyword. Also, you cannot specify the DEFAULT-FORM, DEFAULT-SIZE, DEFAULT-FONT, CONCATENATE, or REPEAT-CHAR keywords. As this type of extended reporting printer defines a device that supports DBCS (KANJI) data, you must specify the DBCS-CODE keyword. The code system that you specify must be the one supplied by the display device CA-Easytrieve/Plus Extended Reporting Facility Guide

101 PRINTER Command shift-out This required value defines a hexadecimal value that CA-Easytrieve/Plus inserts prior to any DBCS data in a print record directed to this extended reporting printer. Define this value using the characters A-F and the number 0-9. shift-in This required value defines a hexadecimal value that CA-Easytrieve/Plus inserts after any DBCS data in a print record directed to this extended reporting printer. Define this value using the characters A-F and the number 0-9. [FCB] FCB is an optional keyword that indicates if the printer being defined supports a Forms Control Block (FCB). This keyword is only valid for Line Mode printers. If the printer supports an FCB, specify the letter Y (the default). Knowing that the printer supports an FCB means that CA-Easytrieve/Plus uses ANSI Forms Control codes, leaving the line spacing to the definitions in the FCB. If the printer supports an FCB, but the printer requires Machine carriage control codes, specify the letter M. CA-Easytrieve/Plus performs the same processing as that defined for ANSI codes above except that the carriage control values are Machine code equivalent of the ANSI codes. If the printer does not support an FCB, specify the letter N. If you do not code the POINT-SKIP keyword, CA-Easytrieve/Plus assumes the carriage control system to be ANSI without an FCB. If you code the POINT-SKIP keyword, the only valid value for the FCB keyword is N. [POINT-SKIP] For Line Mode printers that do not support FCB or ANSI Paper Control codes, or that do not support Machine Control codes, you must use the POINT-SKIP keyword to define the appropriate skip codes. This keyword is only valid if the operand for the FCB keyword is specified as N (no FCB support). If the operand for the FCB keyword is not N or the printer is a Page printer, this operand is invalid. When you define the POINT-SKIP keyword, you must also include the CONCATENATE keyword with a value of Y. The POINT-SKIP requires you to define two hexadecimal values: value-4 This hexadecimal value defines the appropriate Paper Control code that CA-Easytrieve/Plus uses to perform a skip to the first line of a new page. Define value-4 using the characters A - F and the numbers 0-9. Value-4 is the Paper Control code for print records that must start a new page. Extended Reporting Options Module 4 19

102 PRINTER Command value-5 This hexadecimal value defines the code that CA-Easytrieve/Plus uses to invoke a point skip operation. The code is the Paper Control code for print records that must start a new line. The point skip operation requires the insertion of a number of H-units into the control code to indicate the number of H-units to skip before positioning the next print line. Specify value-5 using the three-character code for the point skip special control code (character 2 = S). For information on the three-byte code, refer to the XRPT Commands Overview topic earlier in this chapter. [DEFAULT-SIZE] The DEFAULT-SIZE keyword defines the width and optionally the height that CA-Easytrieve/Plus uses to convert the values assigned to various report and printing attributes. These attributes include LINESIZE, PAGESIZE, and so on. These attributes are currently character-based settings. To convert them into the same Unit of Measure used to define the heights and widths of fonts for this printer, CA-Easytrieve/Plus must multiply their character based settings by a base width and height that are expressed in terms of the appropriate W-units and H-units. Use this keyword to assign the base width and height. You need only code this keyword if the base width and height of the printer is to be different from the width and height assigned to the default EBCDIC font. If you do not code the keyword, then CA-Easytrieve/Plus uses the width and height of the default EBCDIC font. font-1 CA-Easytrieve/Plus always requires this value when you code the DEFAULT-SIZE keyword. Font-1 identifies the font whose width is to be the default W-unit for this extended reporting printer. Font-1 is the font number assigned to the font whose width is to be the default width. The data format of the identified font must be EBCDIC or DBCS. The font identified by font-1 cannot define a Line Complex. CA-Easytrieve/Plus processes the W-unit of the identified font as the default print width of the printer. CA-Easytrieve/Plus then uses this value to convert character based values, such as LINESIZE into the appropriate W-unit of the printer. font-2 You need only code this value for printers that do not support an FCB (Forms Control Block). Font-2 identifies the number of either an EBCDIC or DBCS font whose height (expressed in H-units) is the default height of each line that CA-Easytrieve/Plus prints (that is the Base Height for this printer). Font-2 cannot define a Line Complex. CA-Easytrieve/Plus multiplies this value by the value of PAGESIZE to express the length of a page in terms of the H-units selected for this extended reporting printer CA-Easytrieve/Plus Extended Reporting Facility Guide

103 PRINTER Command [DEFAULT-FORM] The DEFAULT-FORM keyword defines the width and height that CA-Easytrieve/Plus uses to validate specifications of LINESIZE, PAGESIZE, and so on, in a CA-Easytrieve/Plus program. These values ensure that the print lines that CA-Easytrieve/Plus generates do not exceed the printer's page boundaries. If you do not code this keyword, CA-Easytrieve/Plus does not perform checking of the print lines. This keyword is required when defining a Page Printer. W-units-2 and H-units-2 can only be specified for the DEFAULT-FORM keyword when defining a Page Printer. These two values define the initial co-ordinates on the Logical Page that CA-Easytrieve/Plus uses whenever it starts a new page. If these values are not coded, CA-Easytrieve/Plus assumes a W-units-2 value of zero (start at the left-most position on any new line) and a H-units-2 value of zero (start at the top of the logical form for any new page). W-units-1 CA-Easytrieve/Plus requires the W-units-1 value when you code the DEFAULT-FORM keyword. W-units-1 defines the maximum width of the logical page upon which print lines that CA-Easytrieve/Plus generates are to appear. W-units-1 must be in terms of the printers W-units. You can specify up to two decimal places with this value. The W-units-1 value is also important when CA-Easytrieve/Plus produces DISPLAY HEX output on an extended reporting printer that supports DBCS data. Normally, in this situation CA-Easytrieve/Plus produces output consisting of 106 DBCS characters per line (212 bytes of data). The font that CA-Easytrieve/Plus uses is the default DBCS font for the extended reporting printer. In some situations, the extended reporting printer cannot support 106 DBCS characters on the one print line. Should this situation exist for your extended reporting printer, the W-units-1 value can define the maximum print width of the DISPLAY HEX print line. The number of characters to be printed on each line is the smaller of the following values: 1. The default 106 characters, 2. The W-unit-1 value divided by the width of the default DBCS font, or 3. The maximum data supported by the extended reporting printer divided by 2 to give the maximum number of DBCS characters. The maximum data value is defined by value-10 of the MAX-RECORD keyword of the PRINTER command. This keyword is discussed later in this chapter. Extended Reporting Options Module 4 21

104 PRINTER Command H-units-1 CA-Easytrieve/Plus requires this value when you code the DEFAULT-FORM keyword. H-units-1 defines the maximum depth of the logical page upon which print lines that CA-Easytrieve/Plus generates are to appear. H-units-1 must be in terms of the printers H-units. You can specify up to two decimal places with this value. This value is ignored for printers that support an FCB (Forms Control Block). W-units-2 This value can only be specified when defining a Page Printer. W-units-2 defines the initial Set Horizontal Position that CA-Easytrieve/Plus must use whenever it begins to format a new line. Therefore, W-units-2 defines the position for the left-hand margin of any output on the printers logical page. The W-units-2 value must be in terms of the printers W-units. It cannot contain any decimal positions. H-units-2 This value can only be specified when defining a Page Printer, and it must be specified when you code the W-units-2 value. H-units-2 defines the initial Set Vertical Position that CA-Easytrieve/Plus must use whenever it begins to format a new page. Therefore, H-units-2 defines the position for the top of any output on the printers logical page. The H-units-2 value must be in terms of the printers H-unit. It cannot contain any decimal positions. [DEFAULT-FONT] The DEFAULT-FONT keyword defines the fonts that CA-Easytrieve/Plus uses when a print item is not assigned a font in the CA-Easytrieve/Plus program. When a font is assigned to a print item, CA-Easytrieve/Plus processes the print item using that specified font. CA-Easytrieve/Plus uses the fonts defined by the DEFAULT-FONT keyword when assigning this printer as the extended reporting printer for the CA-Easytrieve/Plus system output (see the SYSTEM command discussed previously). The three operands are the numbers assigned to the fonts that are established as the default EBCDIC, DBCS, and MIXED fonts for this printer. Therefore, all the operands must identify a font that is to be defined for this extended reporting printer CA-Easytrieve/Plus Extended Reporting Facility Guide

105 PRINTER Command If you do not specify this keyword, The first font defined for this printer that supports EBCDIC data becomes the default EBCDIC font. The first font defined for this printer that supports DBCS data becomes the default DBCS font. The first MIXED font defined for this printer becomes the default fonts for MIXED format data. The fonts that the DEFAULT-FONT command identifies cannot support Line Complexes. font-3 Font-3 is always required for the DEFAULT-FONT keyword. Font-3 defines the number of the font that CA-Easytrieve/Plus uses as the default EBCDIC font. The number must identify a font defined for this printer and that font must support EBCDIC data. If any one of these conditions are not met, CA-Easytrieve/Plus outputs an error message. font-4 Only code font-4 if the printer supports DBCS data. If the printer does not support DBCS data, this operand is invalid and its use results in an error message. For printers supporting DBCS data, the number coded as font-4 must identify a font defined for this printer and that font must support DBCS data otherwise an error message is printed. If you do not code font-4 and DBCS data is supported, the first DBCS font defined by the FONT command is established as the default. You must code at least one DBCS font if the printer supports DBCS data. font-5 Only code font-5 if the printer supports DBCS data. If the printer does not support DBCS data, this operand is invalid and its use results in an error message. For printers supporting DBCS data, the number coded as font-5 must identify a font defined to support MIXED format data, otherwise CA-Easytrieve/Plus outputs an error message. You must code at least one MIXED font if the printer supports DBCS data. [DBCS-CODE] When an extended reporting printer supports DBCS data, code the DBCS-CODE keyword to define that DBCS code system. You must define multiple extended reporting printers -- one for each DBCS code system to be supported. If you do not code the DBCS-CODE keyword, the printer is assumed to be unable to support DBCS data. When you code this keyword, CA-Easytrieve/Plus assumes support for DBCS data. A printer that processes DBCS data is only supported after the installation of the CA-Easytrieve/Plus DBCS Option. Extended Reporting Options Module 4 23

106 PRINTER Command code-system Code-system defines the name of one of the DBCS code systems that CA-Easytrieve/Plus supports. The valid entries for this operand are: Term IBM IBMKOREA JEF JEF4040 JIPSE JIS KEIS MELCOM SHOWA TORAY Description Defines the IBM DBCS code system for Japan. Defines the IBM DBCS code system for Korea. Defines the FACOM code system (blank = X'A1A1'). Defines the FACOM code system (blank = X'4040'). Defines the NEC code system. Japanese Industrial Standards code system. Defines the HITACHI code system. Support of MELCOM printer code system. Defines the SHOWA Information code system. Defines the TORAY 8500 code system. If you assign a DBCS code system to an extended reporting printer file (defined on a FILE statement in your CA-Easytrieve/Plus program), the DBCS options module must define support for that system. If the DBCS options module does not define support for the system you are using, then a syntax error is generated. [DEVICE] {DISK device-type} The DEVICE keyword specifies the default output device type of the print data set. For VSE environments, the device type defines the type of Input/Output module that CA-Easytrieve/Plus uses for output print records. You can select any one of the three options. For OS/390 environments, the three operands are meaningless as CA-Easytrieve/Plus obtains the required information from the JCL. Note: The operand selected here is only the default. You can alter the default by coding different values on the FILE statement in a CA-Easytrieve/Plus program. The DISK operand indicates that the print data set resides on a direct access disk device. Device-type can be any of the following devices: DISK, FBA, 3390, 3380, 3375, 3350, 3340, or CA-Easytrieve/Plus issues an error message if you code any other value. If you do not code a device type, CA-Easytrieve/Plus obtains the default device type from the CA-Easytrieve/Plus options module at compile time. For programs executing on DOS AF2 or later, CA-Easytrieve/Plus determines the specific disk device when the file is opened CA-Easytrieve/Plus Extended Reporting Facility Guide

107 PRINTER Command {TAPE} The TAPE option indicates that CA-Easytrieve/Plus is to output the print data set to magnetic tape. For the TAPE device, you can use three options to specify an action against the tape's position. The REWIND option is assumed if you do not specify one of the following options after the TAPE value. REWIND causes the tape to be rewound before the tape is used. UNLOAD causes the tape to be rewound and unloaded after use. NORWD indicates that the tape is not to be rewound either before or after the tape is used. {PRINTER} The PRINTER option indicates that CA-Easytrieve/Plus is to direct the output file to an online printer. This means that a spooling system, such as JES2 and POWER processes to print data set. [RECORD] The RECORD keyword is an optional keyword that defines the default record format CA-Easytrieve/Plus uses for the print data sets created for this printer. You can alter the defaults established here by specifying new record format options on the CA-Easytrieve/Plus FILE statement that associates the print data set to this extended reporting printer. For VSE environments, the RECORD keyword is used when the record format parameters are not coded on the CA-Easytrieve/Plus FILE statement. If you do not code this keyword and do not specify the record format parameters on the CA-Easytrieve/Plus FILE statement, CA-Easytrieve/Plus outputs a syntax error. For OS/390 environments, the RECORD keyword is used when the record format parameters are not coded on the CA-Easytrieve/Plus FILE statement. If you do not code this keyword and do not specify the record format parameters on the CA-Easytrieve/Plus FILE statement, the operating system obtains the record format when CA-Easytrieve/Plus opens the file. rec-fmt This required operand defines the record format of the print data set. Valid entries for this operand are the letters F for fixed, V for variable, and U for undefined record formats. Fixed and variable length records can be blocked (FB, VB). For OS/390 environments, the letters VBS indicate Variable Block Spanned records. Extended Reporting Options Module 4 25

108 PRINTER Command value-6 Value-6 is a required operand. If the records are fixed or variable length, it defines the logical record length of each record. For variable length records, value-6 must include the RDW (Record Descriptor Word). For undefined record formats, value-6 defines the maximum block size of the print data set. value-7 CA-Easytrieve/Plus only requires this value when the record format supports blocked records. This operand defines the maximum size of a block. If CA-Easytrieve/Plus requires this operand, an error message is output if you do not code the operand. For variable blocked files, value-7 must include the BDW (Block Descriptor Word). [MAX-RECORD] The MAX-RECORD keyword is an optional keyword that defines the maximum print record length that this extended reporting printer supports. Optionally, this keyword defines the maximum amount of print data (as opposed to printer control codes) that a print record can contain. When coding this keyword, CA-Easytrieve/Plus requires value-8. You only need to specify value-9 if the extended reporting printer has a limitation on the number of data bytes that can be contained within its maximum record length. value-8 Although it is possible to define the default record length through the RECORD keyword (discussed previously), it is also possible to override this value on the CA-Easytrieve/Plus FILE statement that associates the print data set to this extended reporting printer. When you specify the MAX-RECORD keyword, CA-Easytrieve/Plus validates the record length specified on that FILE statement to ensure that value-8 is not exceeded. If you do not code the MAX-RECORD keyword, CA-Easytrieve/Plus does not perform a validity check. Value-8 must be greater than or equal to 133. value-9 CA-Easytrieve/Plus requires this value only when the printer being defined has a limitation on the amount of print data (as opposed to printer control codes) that can be defined within its maximum print record. If the only limitation is the record length, you do not need to code value-9. If you code value-9, CA-Easytrieve/Plus ensures that no print record contains more than the specified number of bytes of print data. CA-Easytrieve/Plus outputs a compilation error when value-9 is exceeded. Value-9 cannot be less than CA-Easytrieve/Plus Extended Reporting Facility Guide

109 PRINTER Command Value-9 is also important when CA-Easytrieve/Plus produces DISPLAY HEX output on an extended reporting printer that supports DBCS data. Normally, in this situation CA-Easytrieve/Plus produces output consisting of 106 DBCS characters per line (212 bytes of data). In some situations, the extended reporting printer cannot support 212 bytes of data in a print record. Should this situation exist for your extended reporting printer, value-9 can define the maximum number of DISPLAY HEX data bytes that are formatted for the printer. The number of characters printed on each line is the smaller of the following values: The default 106 characters, Value-10 divided by 2 to give the maximum number of DBCS characters, or The maximum width of the form supported by this extended reporting printer divided by the width of the default DBCS font. The form's maximum width is defined by the W-units-1 value of the DEFAULT-FORM keyword of the PRINTER command. This keyword was discussed earlier in this chapter. [CONCATENATE] The CONCATENATE keyword indicates whether the printer supports concatenated print records. CA-Easytrieve/Plus does not require this keyword. If you do not code this keyword, the building of the print data set does not involve concatenated print records. That is, the default assumes a value of N. Where the extended reporting printer does require concatenated records, you must code this keyword and specify the letter Y. You can only specify the CONCATENATE keyword for printers that do not support ANSI or Machine carriage control systems. This means that only Page Printers and Point Skip supportive printers can use the CONCATENATE option. [RECORD-END] This keyword defines a string of characters (in hexadecimal) that CA-Easytrieve/Plus places at the end of either non-concatenated records or concatenated blocks to indicate the end of data. If the printer does not support such a control character then you should use the default of EBCDIC X'40'. This indicates to delimit the records/blocks with a space. value-10 The required operand for the RECORD-END keyword defines the string of character(s) that CA-Easytrieve/Plus uses as the record delimiter. Value-10 is a hexadecimal literal consisting of the letters A - F and the numbers 0-9. Extended Reporting Options Module 4 27

110 PRINTER Command [RECORD-PAD] This keyword defines a string of characters (in hexadecimal) that CA-Easytrieve/Plus inserts after the Record End string and then adds to the end of an unconcatenated record or the end of a concatenated block. Should the printer not support a particular character for record/block padding, use the default pad character X'40'. value-11 Use hexadecimal characters (consisting of the letters A - F and the numbers 0-9) to define this Record Pad string. [REPEAT-CHAR] This keyword enables you to define the printer control code for a Line Mode printer. You can use this code to repeat a single byte character along the current line. If you code this keyword, CA-Easytrieve/Plus uses this control code to replace the insertion of space characters when inserting padding between print items in a print record. CA-Easytrieve/Plus only uses this code if the number of bytes of space characters being replaced is greater than the number of bytes occupied by this control code. In this way, CA-Easytrieve/Plus is able to reduce the length of print records by dropping the excessive spacing characters. value-12 This value defines the printer control code that results in the propagation of a set number of spaces on a print line. CA-Easytrieve/Plus adds this code to print records in place of padding spaces. You must define this value as a hexadecimal string consisting of the letters A - F and the numbers 0-9. In addition, you must identify the position in the printer control code to be updated with the number of bytes to be propagated by using the three-byte special control code subfield marker for data byte count (character 2 = B). [FILE-HEADER] The FILE-HEADER keyword defines a set of values that individually define print records that CA-Easytrieve/Plus outputs to the print data set just after opening the file but prior to outputting any user initiated print records. You should only code this keyword where CA-Easytrieve/Plus requires file header records. If you code FILE-HEADER, then you must specify at least one header operand CA-Easytrieve/Plus Extended Reporting Facility Guide

111 FONT Command [FILE-TRAILER] header-1 [header-2...] The operands for the FILE-HEADER keyword consist of a series of values. Each value can be either a hexadecimal string or a character string. If you enclose the value within apostrophes CA-Easytrieve/Plus interprets the value as a character string. Otherwise, CA-Easytrieve/Plus interprets the value as a hexadecimal string and converts the value appropriately. Each header value constitutes a print record and CA-Easytrieve/Plus processes it as such on the print data set. Separate each header with one or more spaces. CA-Easytrieve/Plus outputs the headers in the order in which they are defined. The FILE-TRAILER keyword defines a series of values that individually define print records that CA-Easytrieve/Plus outputs to the print data set just before closing the file. Only code this keyword where CA-Easytrieve/Plus requires file trailer records. Once you code FILE-TRAILER, you must specify at least one trailer operand. trailer-1 [trailer-2...] The operands for the FILE-TRAILER keyword consist of a series of values. Each value can be either a hexadecimal string or a character string. If you enclose the value within apostrophes, CA-Easytrieve/Plus interprets the value as a character string. Otherwise, CA-Easytrieve/Plus interprets the value as a hexadecimal string and converts the value appropriately. Each trailer value constitutes a print record and CA-Easytrieve/Plus processes it as such on the print data set. Separate each trailer by one or more spaces. CA-Easytrieve/Plus outputs the trailers in the order in which they are defined. FONT Command Code this command for each font that the extended reporting printer supports. The FONT commands must immediately follow the PRINTER command that defines the extended reporting printer to which the fonts belong. The next PRINTER command or the end of the command stream delimit the fonts for a printer. Each font is given a unique number (1 to 256). Font commands can define fonts in any order. However, you cannot define a font for one particular printer twice by using two FONT commands in the same command stream. If you specify the MODEL keyword on the PRINTER keyword, all the fonts associated with the model definition become associated with the extended reporting printer being defined. If necessary, you can use FONT commands to modify any of these existing font definitions. To do this, the font number coded on the FONT command should match the number of the font obtained from the printer MODEL definition. Extended Reporting Options Module 4 29

112 FONT Command If the extended reporting printer that the previous PRINTER command defines is not a standard line printer, you must define one EBCDIC font. If the printer also supports DBCS data, you must code one DBCS font and one MIXED font. Syntax FONT NUMBER (value-1) - [WIDTH (W-units-1)] - [HEIGHT (H-units-1)] - [NAME (value-2)] - [ {EBCDIC } ] [ DATA-TYPE ( {DBCS } ) ] - [ {font-1 font-2} ] [OVERPRINT-CODE (value-3)] - [FUNCTION-HEADER (value-4)] - [FUNCTION-TRAILER (value-5)] - [ { } ] [ALIGN ({ Y }) ] - [ {value-6} ] [ { } ] [COMPLEX (2/4)] - [SPACE-REPLACE (value-7)] Keywords NUMBER NUMBER is a required keyword on the FONT command. This keyword defines the number that CA-Easytrieve/Plus programs use to uniquely identify the font for a print item (field or literal). The combination of the extended reporting printer assigned to the print data set that receives the print record plus the font number identify the font and its characteristics. pvalue-1 Value-1 defines the number that identifies the font that this FONT command defines. The value can be in the range of 1 to 256. WIDTH You must specify the WIDTH keyword for each font that defines either EBCDIC or DBCS format data. This keyword defines the width of the character that this font produces. By multiplying this value by the number of characters in a print item, CA-Easytrieve/Plus determines the actual print width of the print item CA-Easytrieve/Plus Extended Reporting Facility Guide

113 FONT Command W-units-1 You must use a common Unit of Measure (W-unit) to define the widths of all fonts for a given extended reporting printer. The W-units-1 value defines the width of the character that this font produces as a multiple of W-units. CA-Easytrieve/Plus supports up to two decimal places for the definition of the width of the character. The exception is a printer that supports the STRUCTURED-FIELDS keyword of the PRINTER command. No decimal places are supported for these printers. HEIGHT The HEIGHT keyword is only required if the extended reporting printer for the font does not support an FCB (Forms Control Block) and ANSI/Machine Carriage Control codes. Should the printer support such codes and you code the HEIGHT keyword, an error message is output. If the extended reporting printer for the font does not support an FCB, CA-Easytrieve/Plus requires this keyword. The HEIGHT keyword defines the vertical space that a character printed using this font occupies. CA-Easytrieve/Plus requires the height for line spacing and line counting can be achieved. CA-Easytrieve/Plus does not support this keyword when you are defining fonts supporting MIXED format data. H-units-1 You must use a common Unit of Measure (H-unit) to define the heights of all fonts for a given extended reporting printer. The H-units-1 value defines the height of the character this font produces as a multiple of H-units. CA-Easytrieve/Plus supports up to two decimal places for the definition of the height of a character. The exception is a printer that supports the STRUCTURED-FIELDS keyword of the PRINTER command. No decimal places are supported for these printers. NAME The NAME keyword is optional. This entry associates an alphanumeric name to the font that this FONT command defines. value-2 This value is a 1 to 40 alphanumeric name that is associated with this FONT definition. If the value contains spaces or parentheses, enclose the value within quotes. Extended Reporting Options Module 4 31

114 FONT Command DATA-TYPE This optional keyword indicates the data type that this font supports. A font can support EBCDIC, DBCS, or MIXED data types. If you do not code this keyword, CA-Easytrieve/Plus assumes the font to support EBCDIC data. When using the font command in a CA-Easytrieve/Plus program, the data type of the print item must match the data type of the font associated with the item. {EBCDIC} Code the EBCDIC operand to indicate that the font supports EBCDIC format data only. This means that the font can be associated with any of the EBCDIC print items that CA-Easytrieve/Plus supports including Alphabetic, Zoned Numeric, Packed, Unsigned Packed, and Binary fields, plus EBCDIC quoted literals. {DBCS} OVERPRINT-CODE {font-1 font-2} The DBCS operand indicates that the font supports DBCS format data only. The DBCS-CODE keyword on the PRINTER command defines the DBCS code system of this DBCS format data. A font that supports DBCS data can be associated with a DBCS/Kanji field (field type of K) plus any DBCS or Source Conversion literals. Use this form of the DATA-TYPE operands to define a font for a MIXED format field. MIXED format fields are a combination of EBCDIC and DBCS data. Therefore, defining a font for this data type involves defining an EBCDIC font for the EBCDIC data found in the print item and a DBCS font for the DBCS data found in the print item. Font-1 is the number of the font defined for the current extended reporting printer that is to be used for the EBCDIC portion of MIXED print items. This font cannot support Line Complexes. Font-2 is the number of the font defined for the current extended reporting printer that is to be used for the DBCS portion of MIXED print items. This font cannot support Line Complexes. If the extended reporting printer that the previous PRINTER command defines supports Overprint Codes, you must code the OVERPRINT-CODE keyword for each EBCDIC or DBCS font defined. CA-Easytrieve/Plus does not support the OVERPRINT-CODE keyword for MIXED format fonts. Use this keyword to define the control code value that CA-Easytrieve/Plus inserts into any print record that outputs print items associated with this font CA-Easytrieve/Plus Extended Reporting Facility Guide

115 FONT Command value-3 This keyword consists of a hexadecimal string consisting of the letters A - F and the numbers 0-9. CA-Easytrieve/Plus requires this operand when you code the OVERPRINT-CODE keyword. FUNCTION-HEADER If the extended reporting printer defined by the previous PRINTER command requires printer control information before the data of a print item, then you must define that control information through the FUNCTION-HEADER keyword. You can only code this keyword for EBCDIC and DBCS fonts. Use it to define the control code value that CA-Easytrieve/Plus inserts into each print record that uses this font. CA-Easytrieve/Plus inserts the control information immediately before the text belonging the associated print item. value-4 CA-Easytrieve/Plus requires this value when you code the FUNCTION-HEADER keyword. Value-4 is a hexadecimal string consisting of the letters A - F and the numbers 0-9. If the function code requires CA-Easytrieve/Plus to insert a data byte count into the control code, you should add a three-byte special control code for data byte counts (Character 2 = B) to the definition of value-4. For information on the three-byte code, refer to the XRPT Commands Overview topic earlier in this chapter. FUNCTION-TRAILER If the extended reporting printer defined by the previous PRINTER command requires printer control information after data of a print item, then you must define that control information with the FUNCTION-TRAILER keyword. You can only code this keyword for EBCDIC and DBCS fonts. Use it to define the control code value that CA-Easytrieve/Plus inserts into each print record that uses this font. CA-Easytrieve/Plus inserts the control information immediately after the text belonging the associated print item. value-5 Value-5 is a hexadecimal string consisting of the letters A - F and the numbers 0-9. CA-Easytrieve/Plus requires this operand when you code the FUNCTION-TRAILER keyword. Extended Reporting Options Module 4 33

116 FONT Command ALIGN Use the ALIGN keyword to indicate the need for double alignment with respect to EBCDIC print items in a print record. It is invalid for DBCS and MIXED fonts, and an error message is printed if it is used for these font types. If the extended reporting printer that the previous PRINTER command defines: Supports EBCDIC data as Half-Sized characters (half the size of DBCS/Kanji characters). Requires that Half-Sized character print items have a length that is a multiple of two, then you should specify the ALIGN keyword. This keyword has one required operand. The letter Y indicates that double byte alignment is required and that the EBCDIC space character must be added to the EBCDIC print item to round it up to a double byte boundary. If double byte alignment is necessary but the printer supports a special one byte NOP (No OPeration) function code, then you can define this code for this keyword. The NOP character is a special function code that CA-Easytrieve/Plus can add to the print record to perform alignment. However, the printer does not print the NOP character. If an extended reporting printer does not have this requirement, do not code the ALIGN keyword. {Y} Code this operand for the ALIGN keyword when the extended reporting printer requires double byte alignment but does not support a special NOP character. When you code a Y, CA-Easytrieve/Plus aligns odd length EBCDIC print items by adding one EBCDIC space. {value-6} You can specify value-6 where the extended reporting printer requires double byte alignment, but provides a special NOP character to perform the alignment. Value-6 is a hexadecimal value defining one byte. The value must consist of the letters A - F and the numbers 0-9. COMPLEX The COMPLEX keyword indicates that a Line Complex is required. Only code this keyword if: The font does define a Line Complex. The extended reporting printer that the previous Printer command defines supports Line Complexes. CA-Easytrieve/Plus only supports Line Complexes when the printer uses an FCB (Forms Control Block) and ANSI/Machine Carriage Control Codes CA-Easytrieve/Plus Extended Reporting Facility Guide

117 FONT Command CA-Easytrieve/Plus does not support this keyword for fonts defining MIXED format data. CA-Easytrieve/Plus outputs an error message if you attempt to use this keyword with MIXED format data. The operand of the COMPLEX keyword indicates the number of lines that the complex covers. It supports the following two values: A value of 2 indicates a two-line complex covering two print lines. A value of 4 indicates a four-line complex covering four print lines. To process Line Complexes, you must define a FUNCTION-HEADER on this FONT command. CA-Easytrieve/Plus inserts this code before the associated print item on each print record that makes up the Line Complex. In addition to inserting the Function Code in each print record, CA-Easytrieve/Plus changes the last byte of the Function Code to indicate the item's position in the Line Complex. CA-Easytrieve/Plus OR's the last byte with the following values: 1. X'00' for Line 1 of the Complex 2. X'01' for Line 2 of the Complex 3. X'02' for Line 3 of the Complex 4. X'03' for Line 4 of the Complex Therefore, the definition of the FUNCTION-HEADER value must be in consideration of this processing. SPACE-REPLACE The SPACE-REPLACE keyword is optional. You can only code this keyword for Overprint Printers that support the Merge Overprint technique for combining multiple print records into the same print line. The operand for this keyword defines the one-byte value that replaces occurrences of X'40' in any field associated with this font. value-7 Value-7 is the hexadecimal value that replaces occurrences of X'40' in any field associated with this font. Value-7 must consist of the characters A - F or the letters 0-9. Extended Reporting Options Module 4 35

118 EZTPX04 Error Diagnostics EZTPX04 Error Diagnostics Introduction The EZTPX04 provides a set of diagnostic messages that describe the types of errors that occur when generating the extended reporting options module: Diagnostic Message Format All the messages output by EZTPX04 conform to the same format: Message ID The message ID, a three-byte number, identifies each error message. Diagnostic Message The diagnostic message is a description of the detected error. Message Supplement The message supplement is optional, depending on the diagnostic message and context of the message. If possible, CA-Easytrieve/Plus provides a supplement to identify the particular object which is in error CA-Easytrieve/Plus Extended Reporting Facility Guide

119 EZTPX04 Error Diagnostics Diagnostic Messages The following is a list and a brief description of the EZTPX04 diagnostic messages. 01 COMMAND EXPECTED BUT NOT FOUND Each new card that is not a comment or continuation card must begin with a valid EZTPX04 command. Only SYSPRINT, PRINTER, and FONT commands are allowed. 02 FONT COMMAND OUT OF SEQUENCE You can code one or more FONT commands AFTER a PRINTER command. A FONT command cannot precede the first PRINTER command. 03 INVALID COMMAND. REMAINING DATA IGNORED Only the SYSPRINT, PRINTER, and FONT commands are valid for EZTPX NO DATA FOUND A keyword or value is expected on the current card but it is not present. 05 PREMATURE END OF FILE A continued card is specified but the next card is not present. End of file on the command stream was reached prematurely. 06 CONTINUATION EXPECTED BUT NOT FOUND The end of a command is detected while CA-Easytrieve/Plus is expecting a keyword or a value. 07 BLANK OR DELIMITER EXPECTED BUT NOT FOUND The end of a keyword or a set of values is expected but additional parameters are detected prior to the end of the keyword or set of values. Extended Reporting Options Module 4 37

120 EZTPX04 Error Diagnostics 08 WORD TOO LONG. SOME DATA IGNORED The maximum value that can be specified to the EZTPX04 program is 254 bytes. The indicated supplemental word is too long. 09 INVALID SPECIFICATION OF COMMAND The indicated command is not followed by valid keywords. 10 COMMAND CAN BE SPECIFIED ONLY ONCE You can specify the SYSPRINT command only once in the command stream. 11 INVALID KEYWORD. REMAINING VALUE IGNORED The indicated keyword is invalid for the command currently being processed. The remainder of the values for that command are ignored. 12 AT LEAST ONE KEYWORD REQUIRED Each command, when coded, must have at least one keyword specified. 13 KEYWORD EXPECTED BUT NOT FOUND A keyword is expected for a command but is not found. 14 KEYWORD NAME REQUIRED You must always code the NAME keyword when using the PRINTER command. 15 KEYWORD NUMBER REQUIRED You must always code the NUMBER keyword when using the FONT command. 16 STRUCTURE-FIELDS, OVERPRINT-CODES,MODEL,TERMINAL EXCLUSIVE You cannot specify the STRUCTURED-FIELDS and OVERPRINT-CODES keywords for the same PRINTER command. They are mutually exclusive CA-Easytrieve/Plus Extended Reporting Facility Guide

121 EZTPX04 Error Diagnostics 17 INVALID FONT BECAUSE PRINTER DOES NOT SUPPORT DBCS You can only define a font for DBCS and MIXED format data when the previous PRINTER command indicates that DBCS data is supported through the DBCS-CODE keyword. 18 KEYWORD CAN BE SPECIFIED ONLY ONCE You can only specify a keyword on a command once per command. 19 LEFT PARENTHESIS EXPECTED. REMAINING VALUE IGNORED You must use a left parenthesis to end a start of values. 20 END OF VALUE EXPECTED. REMAINING VALUE IGNORED The number of values required by the current keyword are exceeded. 21 INVALID SPECIFICATION OF KEYWORD The keyword is not correctly delimited from the values required for that keyword. An open parenthesis must follow the keyword. 22 VALUE TOO LONG The indicated value exceeds the maximum supported for the current keyword. 23 INVALID VALUE The specified value is not in the format required by the current keyword. 24 INCORRECT LENGTH OF STRING The specified value must be a required length. 25 DUPLICATED FONT NUMBER SPECIFIED The font number of the current FONT command has been defined for this printer by a previous FONT command. Extended Reporting Options Module 4 39

122 EZTPX04 Error Diagnostics 26 INVALID HEX VALUE The value contains an invalid hexadecimal string. You can use only the characters A - F and the numbers INVALID CODE SYSTEM SPECIFIED The specified DBCS code system must be IBM for Japan, IBMKOREA, KEIS, JEF, JEF4040, JIPSE, JIS, MELCOM, TORAY or SHOWA. 28 INVALID TYPE SPECIFIED The indicated value does not match the alternatives supported by the keyword. 29 INVALID PRINTER NAME The printer name must contain valid characters for a CA-Easytrieve/Plus name. 30 PRINTER NAME HAS INVALID LENGTH The printer name specified by the NAME keyword cannot exceed eight characters. 31 SPECIAL CONTROL CODE INDICATOR H OR I REQUIRED IN THIS VALUE This value requires the definition of either a Set Absolute Horizontal position or a Set Relative Horizontal position special control code in the printer control code. 32 SPECIAL CONTROL CODE INDICATOR REQUIRED IN THIS VALUE This value requires the definition of a Special Printer control code. 33 SPECIAL CONTROL CODE INDICATOR V OR W REQUIRED IN THIS VALUE This value requires the definition of either a Set Absolute Vertical position or a Set Relative Vertical position special control code in the printer control code. 34 ONLY SPECIAL CONTROL CODES L OR R SUPPORTED IN THIS VALUE This value supports the definition of only a Record Length or Record Count special control code in the printer control code CA-Easytrieve/Plus Extended Reporting Facility Guide

123 EZTPX04 Error Diagnostics 35 SPECIAL CONTROL CODE INDICATOR S REQUIRED IN THIS VALUE The definition of a point skip printer control code requires the definition of a point skip special control code. 36 THIRD OPERAND REQUIRED For the current keyword, insufficient values have been specified. 37 VALUE TOO LARGE The indicated value exceeds the maximum that the current keyword supports. 38 SPECIAL CONTROL CODE INDICATOR B REQUIRED IN THIS VALUE The definition of a value for the current keyword requires the specification of a byte count special control code. 39 PAGE PRINTER'S FONT CANNOT HAVE DOUBLE ALIGN OPTION Double Byte alignment is not valid on a font for a Page Printer. 40 INVALID OPTION SPECIFIED Invalid device type supplied for the DEVICE keyword. 41 VALUE MUST BE AT LEAST 4 The minimum length of a value for this keyword is four bytes. 42 VALUE MUST BE AT LEAST DEFAULT LOGICAL RECORD LENGTH + 4 The block size must be at least four bytes longer than the logical record length. 43 BLOCK SIZE MUST BE A MULTIPLE OF RECORD SIZE The specified block size must be a multiple of the specified record length for fixed blocked files. Extended Reporting Options Module 4 41

124 EZTPX04 Error Diagnostics 44 INVALID SPECIAL CONTROL CODE INDICATOR The special control code is not supported for this printer control code. 45 INVALID WIDTH OF A SPECIAL CONTROL CODE A special printer control code must end on a byte boundary. 46 INVALID BYTE COUNT The byte count specified for a special printer control code cannot exceed 4 bytes. 47 TOO MANY DECIMAL PLACES The maximum number of decimal places for a W-unit or a H-unit value is two. 48 KEYWORD START-PAGE REQUIRED IF STRUCTURED-FIELDS CODED For support of a Page Printer, you must specify the START-PAGE and its associated printer records. 49 KEYWORD FCB CANNOT BE CODED IF STRUCTURED-FIELDS CODED Forms Control Block processing is not valid for a Page Printer. 50 POINT-SKIP CANNOT BE CODED IF STRUCTURED-FIELDS CODED Point Skip processing is not valid for a Page Printer. 51 START-PAGE CANNOT BE CODED IF STRUCTURED-FIELDS NOT CODED CA-Easytrieve/Plus only supports the START-PAGE keyword when the current PRINTER command is defining a Page Printer. 52 END-PAGE CANNOT BE CODED IF STRUCTURED-FIELDS NOT CODED The END-PAGE keyword is only supported when the current PRINTER command is defining a Page Printer CA-Easytrieve/Plus Extended Reporting Facility Guide

125 EZTPX04 Error Diagnostics 53 'N' MUST BE SPECIFIED FOR FCB KEYWORD IF POINT-SKIP CODED The FCB keyword must be specified as N (No) if support is required for Point Skip Paper Control Codes. 54 NO FONT BLOCK FOR EBCDIC FOUND You must specify at least one font for EBCDIC data if the previous PRINTER command does not define a Standard Line Printer. 55 AT LEAST ONE DBCS FONT MUST BE CODED IF DBCS DATA SUPPLIED You must specify at least one font for DBCS data if the previous PRINTER command supports DBCS data. 56 FONT DOES NOT MATCH WITH DATA TYPE The font specified as the default font for either EBCDIC, DBCS, or MIXED format data does not match the data format specified on the FONT command. 57 KEYWORD COMPLEX NOT SUPPORTED FOR A MIXED FIELD You must not specify the COMPLEX keyword on a font defined for MIXED format data. 58 DBCS CODE SYSTEM NOT DEFINED FOR DEFAULT DBCS FONT CA-Easytrieve/Plus only supports a font for DBCS format data if the previous PRINTER command defined support for a DBCS code system. 59 NO MIXED FONT BLOCK FOUND You must specify a font for MIXED format data if DBCS format data is supported for the extended reporting printer. 60 FONT BLOCK FOR EBCDIC DATA IN THE MIXED FIELD NOT FOUND The font number specified for the EBCDIC portion of a MIXED format font has not been defined. Extended Reporting Options Module 4 43

126 EZTPX04 Error Diagnostics 61 FONT BLOCK FOR DBCS DATA IN THE MIXED FIELD NOT FOUND The font number specified for the DBCS portion of a MIXED format font has not been defined. 62 FONT BLOCK CORRESPONDING TO FONT NUMBER SPECIFIED NOT FOUND The indicated font number has not been defined for the current extended reporting printer. 63 FONTS CANNOT BE SUPPORTED FOR STANDARD LINE PRINTER If the previous PRINTER command defines a standard Line Printer then you cannot define any fonts for this printer. 64 SECOND OPERAND OF DEFAULT SIZE MUST BE CODED WITH NO FCB You must specify the default height of print lines for printers that do not support a Forms Control Block. 65 KEYWORD WIDTH REQUIRED FOR EBCDIC OR DBCS FORMAT DATA When defining a font for EBCDIC or DBCS format data, you must specify the WIDTH keyword. 66 KEYWORD HEIGHT REQUIRED FOR PRINTERS NOT SUPPORTING FCB You must specify the HEIGHT keyword for fonts supported by printers that do not support a Forms Control Block. 67 KEYWORD HEIGHT INVALID IF FCB OR MACHINE CODE SUPPORTED The HEIGHT keyword is not required on fonts for printers that support a Forms Control Block. 68 KEYWORD HEIGHT CANNOT BE CODED FOR MIXED FORMAT DATA The definition of a MIXED format font does not require the HEIGHT keyword CA-Easytrieve/Plus Extended Reporting Facility Guide

127 EZTPX04 Error Diagnostics 69 IF OVERPRINT-CODES CODED OVERPRINT-CODE MUST BE CODED The PRINTER command defined support for Overprint Codes. The OVERPRINT-CODE keyword must be coded for each font. 70 KEYWORD OVERPRINT-CODE CANNOT BE CODED FOR MIXED FORMAT DATA The definition of a MIXED format font does not require the OVERPRINT-CODE keyword. 71 DECIMAL POSITIONS ARE NOT SUPPORTED FOR PAGE PRINTERS The values for the WIDTH and HEIGHT keywords must be whole numbers when the extended reporting printer is a Page Printer. 72 KEYWORD FUNCTION-HEADER NOT SUPPORTED FOR MIXED FORMAT DATA The definition of a MIXED format font does not require the FUNCTION-HEADER keyword. 73 KEYWORD FUNCTION-HEADER MUST BE CODED IF COMPLEX CODED A Line Complex requires a Function Header code. 74 KEYWORD FUNCTION-TRAILER NOT SUPPORTED FOR MIXED FORMAT DATA The definition of a MIXED format font does not require the FUNCTION-TRAILER keyword. 75 COMPLEX CAN ONLY BE CODED IF FCB OR MACHINE CODE SUPPORTED CA-Easytrieve/Plus only supports a Line Complex for printers that use a Forms Control Block. 76 NO PRINTER COMMAND CODED. MUST BE CODED ONCE FOR EACH PRINTER At least one PRINTER command is required in the command stream. Extended Reporting Options Module 4 45

128 EZTPX04 Error Diagnostics 77 PRINTER BLOCK ASSIGNED TO RECEIVE SYSPRINT OUTPUT NOT FOUND The printer name defined by the NAME keyword of the SYSPRINT command is not defined by a PRINTER command. 78 THE NAME OF THE PRINTER ALREADY SPECIFIED The NAME entry of the current PRINTER command is already defined by a previous PRINTER command. 79 AT LEAST ONE FONT COMMAND FOR EBCDIC FONT MUST BE CODED A new PRINTER definition has been encountered. The previous PRINTER command is missing at least one EBCDIC FONT definition. Alternately, an EOF condition has been detected and the last PRINTER command is missing at least one EBCDIC FONT definition. 80 SECOND OPERAND REQUIRED The current keyword requires additional values. 81 MODEL NAME NOT FOUND The specified MODEL is not known to the system. 82 COMPLEX CANNOT BE DEFAULT FONT A font defined as the default DBCDIC or DBCS font cannot support a line complex definition. 83 CONCATENATE CAN ONLY BE CODED FOR PAGE PRINTER OR POINT SKIP CA-Easytrieve/Plus only supports the CONCATENATE option for non-ansi and non-machine code printers. 84 DEVICE TYPE MUST BE SPECIFIED The device type keyword is required for the current printer CA-Easytrieve/Plus Extended Reporting Facility Guide

129 EZTPX04 Error Diagnostics 85 AT LEAST ONE VALUE IS NEEDED The current keyword requires at least one value. 86 DEFAULT RECORD LENGTH EXCEEDS MAXIMUM RECORD LENGTH The record length defined by the RECORD keyword exceeds the maximum record length specified by the MAX-RECORD keyword. 87 FORMAT-PAGE CANNOT BE CODED IF STRUCTURED-FIELDS NOT CODED The FORMAT-PAGE keyword is only supported when defining a page printer - that is a printer that supports structured fields. 88 CONCATENATE OPTION IS REQUIRED FOR POINT-SKIP PROCESSING The CONCATENATE keyword must be specified for those printers that require support of point skip processing. 89 SPACE-REPLACE CAN ONLY BE CODED FOR MERGE OVERPRINT The SPACE-REPLACE keyword can only be specified if the previous PRINTER command defined a printer that supported the merge overprint technique. 90 DEFAULT-FORM KEYWORD MUST BE SPECIFIED FOR A PAGE PRINTER The definition of a Page Printer - that is a printer that supports structured fields, must have the DEFAULT-FORM keyword specified. 91 PAGE HEIGHT NOT SUPPORTED BY SET VERTICAL POSITION CODE The height of a page defined by the DEFAULT-FORM keyword exceeds the maximum value supported by the Set Vertical Position special control code. 92 PAGE WIDTH NOT SUPPORTED BY SET HORIZONTAL POSITION CODE The width of a page defined by the DEFAULT-FORM keyword exceeds the maximum value supported by the Set Horizontal Position special control code. Extended Reporting Options Module 4 47

130 EZTPX04 Error Diagnostics 93 ONLY ONE SPECIAL CONTROL CODE IDENTIFIER CAN BE CODED You cannot define more than the one special control code identifier in the current value. 94 OVERPRINT-CODE IS ONLY VALID IF OVERPRINT-CODES WAS CODED The OVERPRINT-CODE keyword can only be specified on a FONT command when the previous PRINTER command defined support for overprint codes through the OVERPRINT-CODES keyword of the PRINTER command. 95 POINT-SKIP IS NOT ALLOWED FOR TERMINAL KEYWORD TERMINAL type printers cannot support the POINT-SKIP keyword. 96 DBCS-CODE KEYWORD MUST BE CODED FOR TERMINAL KEYWORD The support of a TERMINAL type printer requires the definition of a DBCS code system. You must specify the DBCS-CODE keyword and one valid DBCS code system as its value. 97 DEFAULT-FORM KEYWORD IS INVALID FOR TERMINAL KEYWORD The DEFAULT-FORM keyword cannot be specified when defining a TERMINAL type printer. 98 DEFAULT-FONT KEYWORD IS INVALID FOR TERMINAL KEYWORD The fonts for a TERMINAL type printer are automatically defined so you cannot define the default fonts for this printer. 99 REPEAT-CHAR KEYWORD IS INVALID FOR TERMINAL KEYWORD The REPEAT-CHAR keyword cannot be specified when defining a TERMINAL type printer. 100 CONCATENATE KEYWORD IS NOT SUPPORTED FOR TERMINAL KEYWORD The CONCATENATE keyword cannot be specified when defining a TERMINAL type printer CA-Easytrieve/Plus Extended Reporting Facility Guide

131 EZTPX04 Error Diagnostics 101 CARRIAGE CONTROL CAN ONLY BE FCB OR MACHINE CODES The Carriage Control system supported for this printer type must support an FCB through either ANSI or Machine control codes. 102 NO FONT COMMANDS ARE ALLOWED IF TERMINAL KEYWORD CODED The fonts for a TERMINAL type printer are automatically defined. No additional fonts can be defined for this printer type. 103 DEFAULT-SIZE KEYWORD IS INVALID FOR TERMINAL KEYWORD The fonts for a TERMINAL type printer are automatically defined so you cannot define the default size fonts for this printer. 104 DBCS CODE SYSTEM NOT DEFINED FOR MIXED DATA The printer defined by the previous PRINTER command must support DBCS data before you can define a font for MIXED format data. 105 COMPLEX NOT SUPPORTED FOR EBCDIC PORTION OF MIXED FIELD The EBCDIC portion of a MIXED format font cannot define support for a Line Complex. 106 COMPLEX NOT SUPPORTED FOR DBCS PORTION OF MIXED FIELD The DBCS portion of a MIXED format font cannot define support for a Line Complex. 107 DBCS CODE SYSTEM NOT DEFINED FOR DBCS DATA The printer defined by the previous PRINTER command must support DBCS data before you can define a font for DBCS format data. 108 NO DBCS FONT BLOCK DEFINED BY DEFAULT-FONT KEYWORD FOUND The default DBCS font specified on the DEFAULT-FONT keyword of the previous PRINTER command is not defined by a FONT command. Extended Reporting Options Module 4 49

132 EZTPX04 Error Diagnostics 109 DEFAULT DBCS FONT CANNOT BE SPECIFIED IF DBCS-CODE NOT CODED You cannot define a DBCS font if the DBCS-CODE keyword is not coded on the previous PRINTER command. 110 DEFAULT MIXED FONT CANNOT BE SPECIFIED IF DBCS-CODE NOT CODED You cannot define a MIXED font if the DBCS-CODE keyword is not coded on the previous PRINTER command. 111 DEFAULT-FONT KEYWORD INVALID WHEN NO FONTS COMMAND IS CODED You cannot specify the DEFAULT-FONT keyword on the PRINTER command if you do not specify any fonts for the printer. 112 KEYWORD WIDTH CANNOT BE CODED FOR MIXED FORMAT DATA The WIDTH keyword is not supported on the FONT command when you are defining a MIXED format font. 113 KEYWORD ALIGN IS ONLY SUPPORTED FOR EBCDIC FONT Double byte alignment is only applicable to the definition of a font for EBCDIC data. 114 KEYWORD SPACE-REPLACE CANNOT BE CODED FOR MIXED FORMAT DATA You cannot specify the SPACE-REPLACE keyword when defining a font for MIXED format data CA-Easytrieve/Plus Extended Reporting Facility Guide

133 Chapter 5 Extended Reporting Introduction This chapter describes the enhancements made to normal CA-Easytrieve/Plus syntax that are necessary for using the Extended Reporting Facility. For complete information on CA-Easytrieve/Plus syntax, refer to the CA-Easytrieve/Plus Reference Guide. FILE Statement FILE statements describe all the files and databases that a program references. For extended reporting, the FILE statement is affected for printer (output) files only. The syntax of the FILE statement relative to extended reporting is as follows: FILE file-name +... [EXTENDED xrpt-name] [EXTENDED] The EXTENDED option indicates that the file is to be associated with an extended reporting printer. This means that input/output statements (GET, PUT, READ, WRITE) cannot reference these printer files. However, the DISPLAY statement and REPORT statements can reference these printer files. Unless you code them, record length and blocksize default to those defined for the printer in the extended reporting options module. Extended Reporting 5 1

134 DEFINE Statement [xrpt-name] The xrpt-name entry identifies the extended reporting printer whose characteristics are to be associated with this file. You must define the xrpt-name in the extended reporting options module. DEFINE Statement Code the DEFINE statement in the library section of the program directly after the FILE statement or anywhere else in the activity. The syntax relative to extended reporting is: DEFINE field-name-1 [(file-name-1)] +... [HEADING ([#integer-6] 'literal-1'...)] +... [HEADING ([#integer-6] 'literal-1'...)] The HEADING option specifies an alternative report heading for field-name-1 (the default is the actual field-name). Integer-6 defines the font number of the font to be used to format 'literal-1' when you use field-name-1 in a report directed to an extended reporting printer. If the report is directed to a normal printer, CA-Easytrieve/Plus ignores this value. 'Literal-1' specifies the alternative heading and can be up to 40 characters long. You must enclose 'Literal-1' in the parentheses. Multiple literal-1's enclosed in the parentheses are stacked vertically over the field when printed. Each 'literal-1' can use a unique font number by coding the # sign and a value for integer-6 before 'literal-1'. Any 'literal-1' that does not have a font assigned uses the default font identified in the extended reporting options module. See your System Administrator for details regarding the Default Fonts for an extended reporting printer. DEFINE FULL-NAME A HEADING (#2 'NAME' #1 + 'LAST NAME' 'THEN' #1 + 'FIRST NAME') Results: NAME <=== Use Font number 2 LAST NAME <=== Use Font number 1 THEN <=== Use Default Font FIRST NAME <=== Use Font number CA-Easytrieve/Plus Extended Reporting Facility Guide

135 DISPLAY Statement DISPLAY Statement The DISPLAY statement formats and transfers data to the system output device or to a named file. It is the only input/output processing statement that the Extended Reporting Facility affects. The DISPLAY statement syntax has three formats but only formats 1 and 3 have implications in extended reporting. Syntax [ ] Format 1 [literal-2 ] [field-name-1 ] [ ] [ ] [+integer-2 ] DISPLAY [file-name-1] [NEWPAGE ] [-integer-2 ] [SYSPRINT ] [SKIP integer-1 ] [COL integer-3] [ ] [CONTROL literal-1] [POS integer-4] [ ] [#integer-5 ] [ ] Format 3 [ ] DISPLAY [file-name-1][control literal-3] [SYSPRINT ] [ ] Format 1 [CONTROL literal-1] [COL integer-3] The CONTROL option sets the print carriage control character for the print line. The valid alphanumeric values for literal-1 are 0 through 9, +, -, A, B, or C (not valid for use in report procedures). CA-Easytrieve/Plus supports literal-1 in either of these cases: When file-name-1 is not associated with an extended reporting printer When the extended reporting printer supports ANSI or Machine carriage controls. Should file-name-1 be associated with a extended reporting printer that does not support ANSI or Machine codes, then CA-Easytrieve/Plus does not support literal-1. The COL integer-3 option specifies the print column number where CA-Easytrieve/Plus places the next display item. Integer-3 is any value that does not extend beyond the end of the line. When using an extended reporting printer that is not a standard Line Printer, an error results if two or more fields and/or literals overlap. Extended Reporting 5 3

136 Report Processing [POS integer-4] Within report procedures the POS integer-4 option causes CA-Easytrieve/Plus to position the next display item under the corresponding integer-4 item on the LINE 01 statement. When using an extended reporting printer that is not a standard Line Printer, an error results if two or more fields and/or literals overlap. [#integer-5] The font index option identifies the font that CA-Easytrieve/Plus uses for the next display item. You can only specify this option if file-name-1 has been associated with an extended reporting printer. Integer-5 identifies the font number of a font defined for the extended reporting printer assigned to receive the print output. If you do not code the font index, then the next display item uses the default font for the assigned extended reporting printer. If you code space adjustment or COL options before the font index option, integer-2 or integer-3 refers to horizontal sizes based on the default width of the assigned extended reporting printer. If you code the font index before either of these options, then integer-2 or integer-3 refers to horizontal sizes based on the width of the font identified by integer-5. Format 3 You can use Format 3 to output printer control records. Literal-3 can be an alphanumeric or hexadecimal literal that CA-Easytrieve/Plus outputs to the print file without paper control information. These control cards contain instructions to extended reporting printers. Print control records for some printing systems define the specification of the Font sets that CA-Easytrieve/Plus uses for a particular report. Such control cards can be output to the print data set before a report that uses the loaded font sets. You can only use this format of the DISPLAY statement when file-name-1 is associated with an extended reporting printer. CA-Easytrieve/Plus outputs a syntax error if the file-name-1 is not an extended reporting printer. Report Processing A major function of many CA-Easytrieve/Plus programs is to produce printed reports. The non-procedural nature of CA-Easytrieve/Plus report syntax is readily adaptable to the production of basic and extremely complex reports, both with minimum programming effort. 5 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

137 Report Processing The introduction of the Extended Reporting Facility does not alter the non-procedural nature of CA-Easytrieve/Plus report syntax. The functions of CA-Easytrieve/Plus reporting have not been changed. There are, however, some added considerations when using the Extended Reporting Facility to produce reports. Such considerations are noted for pertinent items of syntax on the following pages. If you do not associate a report with an extended reporting printer, then there is no change in the use of CA-Easytrieve/Plus. REPORT Statement The REPORT statement is the first statement coded in a report declaration. This statement establishes the type and characteristics of the report. Only the REPORT statement parameters requiring special consideration when using extended reporting are shown here. Syntax REPORT [report-name] +... [LABELS ([ACROSS literal-3] + [DOWN literal-4] + [SIZE literal-5] + [NEWPAGE ]) ] +... [PRINTER file-name-3] + [PAGESIZE literal-6 ] + [LINESIZE literal-7 ] + [SKIP literal-8 ] + [SPACE literal-9 ] + [TITLESKIP literal-10]... Format Determination Parameters [SIZE literal-5] SIZE is a subparameter of the LABELS parameter and sets the length of each label. The value of literal-5 is the number of print positions on a label. Literal-5 has a range from 1 to 'nnn', where 'nnn' is the length of the label. When you direct the report to an extended reporting printer, CA-Easytrieve/Plus multiplies literal-5 by the default width defined for the assigned extended reporting printer. This result determines the width of each label. Extended Reporting 5 5

138 Report Processing File Directing Parameters [PRINTER file-name-3] Spacing Control Parameters [PAGESIZE literal-6] The optional PRINTER parameter directs the report's printed output. File-name-3 identifies the FILE that receives the report. This file must have the PRINTER or EXTENDED attribute specified. The default is the CA-Easytrieve/Plus system print output file: SYSPRINT for OS/390, SYSLST for VSE. If the system print output file or file-name-3 has been associated with an extended reporting printer, then CA-Easytrieve/Plus automatically formats the report to satisfy the requirements defined for that extended reporting printer. CA-Easytrieve/Plus restricts the support of extended reporting facilities to those reports that are output to printer files that have been associated with an extended reporting printer. The PAGESIZE option establishes the length of each printed page. The value of literal-6 sets the number of lines per page. Literal-6 has a valid range of 1 to 'nnn', where 'nnn' is at least as large as the sum of: 'nnn' of the last 'TITLE nnn' Literal-10 of TITLESKIP Number of HEADING lines plus one 'nnn' of the last 'LINE nnn' Literal-8 of SKIP. In other words, at least one line group must fit on a report page. When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), then CA-Easytrieve/Plus multiplies the PAGESIZE value by the default height of the assigned extended reporting printer. This permits CA-Easytrieve/Plus to compare PAGESIZE with the heights of fonts used on the report as they are both in the same base unit -- the H-unit. The value of literal-6 multiplied by the default height of the assigned extended reporting printer cannot exceed the maximum page length of that extended reporting printer. 5 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

139 Report Processing [LINESIZE literal-7] The LINESIZE option determines the length of each line on a page. Literal-7 is the number of print positions on each report line. The value of literal-7 must be 1 to 'nnn' where 'nnn' is one less than the physical length (record size) of the printer file receiving the report. The first character in a PRINTER file contains the ASA carriage control information. When the report is assigned to an extended reporting printer that is not a standard Line Printer, the maximum value of LINESIZE is not dependent upon the record size of the print data set. The insertion of Overprint and Function Codes into print records plus the support of different fonts on the same print line all impact the relationship between LINESIZE and print data set record size. CA-Easytrieve/Plus supports any LINESIZE provided literal-7 multiplied by the value of the assigned extended reporting printers default width does not exceed the maximum page width of that extended reporting printer. Literal-7 overrides the value defined in the CA-Easytrieve/Plus systems options module. If the report is directed to an extended reporting printer, CA-Easytrieve/Plus multiplies the LINESIZE value by the default width of the assigned extended reporting printer. This value defines the width of the print line in terms of the extended reporting printer's W-unit. [SKIP literal-8] The SKIP option determines the number of blank lines to be inserted between line groups (between 'LINE nnn' and the next 'LINE 01'). Literal-8 has a valid range of 0 to 'nnn', where 'nnn' permits the printing of at least one line group on each page. If you specify a value of 0, a line group containing multiple lines can be spanned across a page break. A nonzero value inhibits this spanning. When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), the default height of the assigned extended reporting printer defines the height of each line. [SPACE literal-9] The SPACE option adjusts the default number of blanks (space characters) inserted between fields on TITLE and LINE statement items. The value of literal-9 has a valid range of 0 to 'nnn' (default is 3), where 'nnn' does not cause a line overflow. The SPREAD option overrides this parameter. When the report is directed to an extended reporting printer, CA-Easytrieve/Plus multiplies the SPACE factor by the default width of the assigned extended reporting printer. This operation expresses the SPACE factor in terms of the printer's W-unit. Extended Reporting 5 7

140 Report Definition Statements [TITLESKIP literal-10] The TITLESKIP option inserts blank lines between the last title line and the first heading line (or LINE 01) of a report. The value of literal-10 has a valid range of 0 to 'nnn', where 'nnn' permits the printing of at least one line group on each page. When the report is directed to an extended reporting printer that does not support an Forms Control Block (FCB), the height of each line is defined by the default height of the assigned extended reporting printer. This operation converts the number of lines into the H-units applicable to the printer. Report Definition Statements The REPORT statement and its associated parameters define the physical attributes of a report. However, to define the content of a report, report definition statements are used. For extended reporting, the following statements have been modified: TITLE HEADING LINE. TITLE Statement One or more TITLE statements define the optional report title. The TITLE statement defines the title items and their position on the title line. Its syntax is: Syntax {field-name } {'literal-2' } {+integer-1 } TITLE [literal-1] {-integer-1 }... {COL integer-2} {#integer-3 } [COL integer-2] The COL parameter specifies the print column number where the next title item is placed. The value of integer-2 has a valid range of 1 to 'nnn', where 'nnn' cannot force the following title item beyond the end of the title line LINESIZE. COL is only permitted when you specify the NOADJUST parameter of the REPORT statement. 5 8 CA-Easytrieve/Plus Extended Reporting Facility Guide

141 Report Definition Statements When the report is associated with an extended reporting printer is not a standard Line Printer, an error results if two or more fields and/or literals overlap. Each title line is centered within the title area of the report unless you use the NOADJUST option. TITLE 01 receives extra consideration as follows: Unless the NODATE parameter overrides it, the system defined field, SYSDATE, is automatically placed in positions one through eight of the title area. Unless overridden by the NOPAGE parameter, the value in the PAGEWRD option and the current page count are placed at the righthand end of the title area. [#integer-3] The #integer-3 value defines a font index. The value of integer-3 identifies a font whose specifications are to be used for the next display item. You can only specify this option if the report has been associated with an extended reporting printer. Integer-3 identifies the font number of a font defined for the associated extended reporting printer. If you do not code the font number, then the next display item uses the default font for the assigned extended reporting printer. If you code space adjustment or COL options before the font index option, integer-1 or integer-2 refers to horizontal sizes based on the default width of the assigned extended reporting printer. If you code integer-3 before either of these options, integer-1 or integer-2 refers to horizontal sizes based on the width of the font that integer-3 identified. HEADING Statement The HEADING statement optionally defines an alternative heading for a field. Its syntax is: Extended Reporting 5 9

142 Report Definition Statements Syntax HEADING field-name ([#integer-1] 'literal-1'...) [#integer-1] Integer-1 defines the font number of a font that CA-Easytrieve/Plus uses to format 'literal-1' in the heading area of a report. You can only specify integer-1 if you direct the report to an extended reporting printer. If you direct the report to a normal printer, CA-Easytrieve/Plus outputs a syntax error when you code integer-1. Each 'literal-1' can use a unique font index by coding the # sign and a value for integer-1 before 'literal-1'. Any 'literal-1' that does not have a font index assigned uses the default font for the assigned extended reporting printer. Example Results: HEADING FULL-NAME (#2 'NAME' #1 + 'LAST NAME' 'THEN' #1 + 'FIRST NAME') NAME <=== Use Font number 2 LAST NAME <=== Use Font number 1 THEN <=== Use Default Font FIRST NAME <=== Use Font number 1 LINE Statement The LINE statement defines the content of a report line. One or more field values or literals can be contained on a report line; each one is a line item. The syntax of the LINE statement is: Syntax {field-name } {'literal-2' } {+integer-1 } LINE [literal-1] {-integer-1 }... {COL integer-2 } {POS integer-3 } {#integer-4 } [COL integer-2] The COL parameter specifies the print column number where the next line item is placed. The NOADJUST option must be coded on the REPORT statement to use the COL option. The value of integer-2 has a valid range of 1 to 'nnn', where 'nnn' cannot be so large that the following line item extends beyond the end of the line defined by LINESIZE CA-Easytrieve/Plus Extended Reporting Facility Guide

143 Report Definition Statements When the report is associated with an extended reporting printer that is not a standard Line Printer, an error results if two or more fields and/or literals overlap. [#integer-4] The font index option identifies the font specifications to be used for the next display item. You can only specify this option if the report has been associated with an extended reporting printer. Integer-4 identifies the number of a font defined for the associated extended reporting printer. If you do not code the font, the next display item uses the default font for the assigned extended reporting printer. If you code space adjustment or COL options before the font index option, integer-1 or integer-2 refers to horizontal sizes, based on the default width of the assigned extended reporting printer. If you code the font index before either of these options, then integer-1 or integer-2 refers to horizontal sizes, based on the width of the font that integer-4 identifies. Extended Reporting 5 11

144

145 Chapter 6 Extended Reporting Models Introduction The extended reporting options module defines the characteristics of the extended reporting printers that CA-Easytrieve/Plus supports. To assist in the generation of this module, the characteristics of commonly used printers were identified and stored as models. This enables the characteristics of an extended reporting printer to be identified by associating it with one of the models. The MODEL keyword on the PRINTER command accomplishes the association. This chapter details the characteristics for each of the models currently provided which are: Reporting Printer IBM3800A IBM3800B IBM3800C Description Defines the characteristics that support the IBM 3800 Model I, II, III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers in compatibility mode. This model does not include support of DBCS data via Extended Graphic Character Set. Defines the characteristics that support the IBM 3800 Model II, VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers (DBCS support) in compatibility mode. This model includes support of DBCS data via Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model does not include support of DBCS data via Extended Graphic Character Set. Extended Reporting Models 6 1

146 Introduction Reporting Printer IBM3800D IBM3800E IBM3800F SHOWA7 SHOWA8 M8250 M8290 T8500 IBM3200 H8196 F6715D Description Defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model does not include support of DBCS data via Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model includes support of DBCS data via Extended Graphic Character Set. Defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model includes support of DBCS data via Extended Graphic Character Set. Defines support for the SHOWA Informational Systems SP-7 printer. Defines support for the SHOWA Informational Systems SP-8 printer. Defines the characteristics of the MELCOM 8250 printer. Defines the characteristics of the MELCOM 8290 printing system. Defines support for the TORAY 8500 printer. Defines characteristics of the IBM 3200 printing system. Defines support for the HITACHI 8196 printer. Defines support for the FUJITSU 6715D and 6716D printers. 6 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

147 IBM3800A Model IBM3800A Model This model defines the characteristics that support the IBM 3800 Model I, II, III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers in compatibility mode. This model does not include support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Line Compatibility Mode. W-unit is POINTS. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME (IBM3800A) - OVERPRINT-CODES (MERGE 4) - FCB (Y) - DEFAULT-SIZE (1) - DEFAULT-FONT (1) - DEVICE (PRINTER) - RECORD (F 206) - MAX-RECORD ( ) Define EBCDIC fonts for IBM 3800 printers. NOTE : The fonts used by IBM 3800 printers in Line Compatibility mode are loaded to the printer via JCL parameters (e.g. CHARS=(font1,font2,...) in JES2). As a result, the fonts defined in the extended reporting options module by this model, provide support for generic 10, 12 and 15 CPI fonts in the four supported WCGM's. FONT NUMBER (001) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F0) FONT NUMBER (002) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F0) FONT NUMBER (003) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F0) FONT NUMBER (004) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F1) FONT NUMBER (005) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F1) Extended Reporting Models 6 3

148 IBM3800A Model FONT NUMBER (006) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F1) FONT NUMBER (007) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F2) FONT NUMBER (008) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F2) FONT NUMBER (009) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F2) FONT NUMBER (010) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F3) FONT NUMBER (011) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F3) FONT NUMBER (012) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F3) 6 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

149 IBM3800B Model IBM3800B Model This model defines the characteristics that support the IBM 3800 Model II, VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers (DBCS support) in compatibility mode. This model includes support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Line Compatibility Mode. W-unit is POINTS. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME (IBM3800B) - OVERPRINT-CODES (MERGE 4) - FCB (Y) - DEFAULT-SIZE (1) - DEFAULT-FONT ( ) - DBCS-CODE (IBM) - DEVICE (PRINTER) - RECORD (F 206) - MAX-RECORD ( ) Define EBCDIC fonts for IBM 3800 printers. NOTE : The fonts used by IBM 3800 printers in Line Compatibility mode are loaded to the printer via JCL parameters (e.g. CHARS=(font1,font2,...) in JES2). As a result, the fonts defined in the extended reporting options module by this model, provide support for generic 10, 12 and 15 CPI fonts in the four support WCGM's. FONT NUMBER (001) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F0) FONT NUMBER (002) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F0) FONT NUMBER (003) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 0') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F0) FONT NUMBER (004) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F1) Extended Reporting Models 6 5

150 IBM3800B Model FONT NUMBER (005) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F1) FONT NUMBER (006) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 1') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F1) FONT NUMBER (007) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F2) FONT NUMBER (008) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F2) FONT NUMBER (009) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 2') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F2) FONT NUMBER (010) - WIDTH (7.2) - NAME ('10 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F3) FONT NUMBER (011) - WIDTH ( 6) - NAME ('12 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F3) FONT NUMBER (012) - WIDTH (4.8) - NAME ('15 CPI FONT AS TRC VALUE 3') - DATA-TYPE (EBCDIC ) - ALIGN (Y) - OVERPRINT-CODE (F3) Define DBCS fonts for IBM 3800 printers. NOTE : The DBCS fonts used by the IBM 3800 printers are termed Extended Graphic Character Sets. They are printed using the appropriate TRC value but they must always be output after the EBCDIC print records. 6 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

151 IBM3800B Model FONT NUMBER (101) - WIDTH (9.6) - NAME ('7.5 CPI FONT AS TRC VALUE 0') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F0) - SPACE-REPLACE (42) FONT NUMBER (102) - WIDTH (9.6) - NAME ('7.5 CPI FONT AS TRC VALUE 1') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F1) - SPACE-REPLACE (42) FONT NUMBER (103) - WIDTH (9.6) - NAME ('7.5 CPI FONT AS TRC VALUE 2') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F2) - SPACE-REPLACE (42) FONT NUMBER (104) - WIDTH (9.6) - NAME ('7.5 CPI FONT AS TRC VALUE 3') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F3) - SPACE-REPLACE (42) Define MIXED fonts for IBM 3800 printers. FONT NUMBER (201) - NAME ('MIXED FONT - DBCS TRC VALUE 1') - DATA-TYPE (1 102) FONT NUMBER (202) - NAME ('MIXED FONT - DBCS TRC VALUE 2') - DATA-TYPE (1 103) FONT NUMBER (203) - NAME ('MIXED FONT - DBCS TRC VALUE 3') - DATA-TYPE (1 104) Extended Reporting Models 6 7

152 IBM3800C Model IBM3800C Model This model defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model does not include support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Page Mode. W-unit is PELs. H-unit is PELs. All Points Addressable PRINTER NAME (IBM3800C) - STRUCTURED-FIELDS (2BD304D2#V4 2BD304C6#H4) - START-PAGE (F10040) - FORMAT-PAGE (5A #L4D3EE9B00#R4) - DEFAULT-SIZE (1 1) - DEFAULT-FORM ( ) - DEFAULT-FONT (2) - RECORD (V 4096) - CONCATENATE (Y) Define EBCDIC fonts for IBM 3800 fonts. FONT NUMBER (001) - WIDTH (24) - HEIGHT (40) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) FONT NUMBER (002) - WIDTH (24) - HEIGHT (24) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F001) 6 8 CA-Easytrieve/Plus Extended Reporting Facility Guide

153 IBM3800D Model IBM3800D Model This model defines the All Points Addressable characteristics that support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model does not include support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Page Mode. W-unit is PELs. H-unit is PELs. All Points Addressable PRINTER NAME (IBM3800D) - STRUCTURED-FIELDS (2BD304C600002BD304D4#W4-2BD304C8#I4) - START-PAGE (F10040) - FORMAT-PAGE (5A #L4D3EE9B00#R4) - DEFAULT-SIZE (1 1) - DEFAULT-FORM ( ) - DEFAULT-FONT (2) - RECORD (V 4096) - CONCATENATE (Y) Define EBCDIC fonts for IBM 3800 fonts. FONT NUMBER (001) - WIDTH (24) - HEIGHT (40) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) FONT NUMBER (002) - WIDTH (24) - HEIGHT (24) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F001) Extended Reporting Models 6 9

154 IBM3800E Model IBM3800E Model This model defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as absolute coordinates on a page. This model includes support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Page Mode. W-unit is PELs. H-unit is PELs. All Points Addressable PRINTER NAME (IBM3800E) - STRUCTURED-FIELDS (2BD304D2#V4 2BD304C6#H4) - START-PAGE (F10040) - FORMAT-PAGE (5A #L4D3EE9B00#R4) - DEFAULT-SIZE (1 1) - DEFAULT-FORM ( ) - DEFAULT-FONT ( ) - DBCS-CODE (IBM) - RECORD (V 4096) - CONCATENATE (Y) Define EBCDIC fonts for IBM 3800 fonts. FONT NUMBER (001) - WIDTH (24) - HEIGHT (40) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) FONT NUMBER (002) - WIDTH (24) - HEIGHT (24) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F001) Define DBCS fonts for IBM 3800 fonts. FONT NUMBER (101) - WIDTH (32) - HEIGHT (32) - DATA-TYPE (DBCS) - FUNCTION-HEADER (2BD303F002) FONT NUMBER (102) - WIDTH (40) - HEIGHT (40) - DATA-TYPE (DBCS) - FUNCTION-HEADER (2BD303F003) Define MIXED fonts for IBM 3800 fonts. FONT NUMBER (201) - DATA-TYPE ( ) FONT NUMBER (202) - DATA-TYPE ( ) 6 10 CA-Easytrieve/Plus Extended Reporting Facility Guide

155 IBM3800F Model IBM3800F Model This model defines the All Points Addressable characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The All Points Addressable coordinates are generated as relative coordinates on a page. This model includes support of DBCS data through Extended Graphic Character Set. Define IBM 3800 series printers in Page Mode. W-unit is PELs. H-unit is PELs. All Points Addressable PRINTER NAME (IBM3800F) - STRUCTURED-FIELDS (2BD304C600002BD304D4#W4-2BD304C8#I4) - START-PAGE (F10040) - FORMAT-PAGE (5A #L4D3EE9B00#R4) - DEFAULT-SIZE (1 1) - DEFAULT-FORM ( ) - DEFAULT-FONT ( ) - DBCS-CODE (IBM) - RECORD (V 4096) - CONCATENATE (Y) Define EBCDIC fonts for IBM 3800 fonts. FONT NUMBER (001) - WIDTH (24) - HEIGHT (40) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) FONT NUMBER (002) - WIDTH (24) - HEIGHT (24) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F001) Define DBCS fonts for IBM 3800 fonts. FONT NUMBER (101) - WIDTH (32) - HEIGHT (32) - DATA-TYPE (DBCS) - FUNCTION-HEADER (2BD303F002) FONT NUMBER (102) - WIDTH (40) - HEIGHT (40) - DATA-TYPE (DBCS) - FUNCTION-HEADER (2BD303F003) Define DBCS fonts for IBM 3800 fonts. FONT NUMBER (201) - DATA-TYPE ( ) FONT NUMBER (202) - DATA-TYPE ( ) Extended Reporting Models 6 11

156 SHOWA7 Model SHOWA7 Model This model defines support for the SHOWA Informational Systems SP-7 printer. Define SHOWA SP-7 printer. W-unit is POINTS. H-unit is POINTS. PRINTER NAME (SHOWA7) - OVERPRINT-CODES (PRINT 1) - FCB (N) - POINT-SKIP (E000B034 B&S3) - DEFAULT-SIZE ( 7 7) - DEFAULT-FONT ( ) - DBCS-CODE (SHOWA) - DEVICE (TAPE UNLOAD) - RECORD (U 4096) - CONCATENATE (Y) Define EBCDIC fonts for SP-7 FONT NUMBER (001) - WIDTH (3.5) - HEIGHT (10 ) - NAME ('HALF SIZE 7 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F000) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (002) - WIDTH (4 ) - HEIGHT (8 ) - NAME ('HALF SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F001) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (003) - WIDTH (4.5) - HEIGHT (9 ) - NAME ('HALF SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F002) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (004) - WIDTH ( 5 ) - HEIGHT (10 ) - NAME ('HALF SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F003) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) 6 12 CA-Easytrieve/Plus Extended Reporting Facility Guide

157 SHOWA7 Model FONT NUMBER (005) - WIDTH ( 7 ) - HEIGHT (14 ) - NAME ('HALF SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F004) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (006) - WIDTH ( 6 ) - HEIGHT (12 ) - NAME ('HALF SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F005) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (007) - WIDTH (3.6) - HEIGHT (9 ) - NAME ('DEFAULT EBCDIC FONT - HALF - SIZE 10 INCH') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F006) - FUNCTION-HEADER (9000) - FUNCTION-TRAILER (001F) - ALIGN (00) Define Full Size EBCDIC fonts for SP-7 FONT NUMBER (011) - WIDTH (7 ) - HEIGHT (10 ) - NAME ('FULL SIZE 7 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F000) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (012) - WIDTH (8 ) - HEIGHT (8 ) - NAME ('FULL SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F001) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) - FONT NUMBER (013) - WIDTH (9 ) - HEIGHT (9 ) - NAME ('FULL SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F002) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) Extended Reporting Models 6 13

158 SHOWA7 Model FONT NUMBER (014) - WIDTH (10 ) - HEIGHT (10 ) - NAME ('FULL SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F003) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (015) - WIDTH (14 ) - HEIGHT (14 ) - NAME ('FULL SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F004) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (016) - WIDTH (12 ) - HEIGHT (12 ) - NAME ('FULL SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F005) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (017) - WIDTH (7.2) - HEIGHT (9 ) - NAME ('FULL SIZE 10 INCH FONT') - DATA-TYPE (EBCDIC ) - OVERPRINT-CODE (F006) - FUNCTION-HEADER (9001) - FUNCTION-TRAILER (001F) - ALIGN (00) Define DBCS fonts for SP-7 FONT NUMBER (101) - WIDTH ( 7) - HEIGHT ( 10) - NAME ('DBCS 7 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F000) FONT NUMBER (102) - WIDTH ( 8) - HEIGHT ( 8) - NAME ('DBCS 8 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F001) FONT NUMBER (103) - WIDTH ( 9) - HEIGHT ( 9) - NAME ('DBCS 9 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F002) 6 14 CA-Easytrieve/Plus Extended Reporting Facility Guide

159 SHOWA7 Model FONT NUMBER (104) - WIDTH ( 10) - HEIGHT ( 10) - NAME ('DBCS 10 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F003) - FONT NUMBER (105) - WIDTH ( 14) - HEIGHT ( 14) - NAME ('DBCS 14 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F004) FONT NUMBER (106) - WIDTH ( 12) - HEIGHT ( 12) - NAME ('DBCS 12 POINT FONT') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F005) FONT NUMBER (107) - WIDTH (7.2) - HEIGHT (9 ) - NAME ('DEFAULT DBCS FONT - 10 INCH') - DATA-TYPE (DBCS) - OVERPRINT-CODE (F006) Define MIXED fonts for SP-7 FONT NUMBER (201) - NAME ('MIXED FONT - 7 POINT') - DATA-TYPE ( ) FONT NUMBER (202) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE ( ) FONT NUMBER (203) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE ( ) FONT NUMBER (204) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE ( ) FONT NUMBER (205) - NAME ('MIXED FONT - 14 POINT') - DATA-TYPE ( ) FONT NUMBER (206) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE ( ) FONT NUMBER (207) - NAME ('DEFAULT MIXED FONT - 10 INCH') - DATA-TYPE ( ) Extended Reporting Models 6 15

160 SHOWA8 Model SHOWA8 Model This model defines support for the SHOWA Informational Systems SP-8 printer. Define SHOWA SP-8 printer. W-unit is POINTS. H-unit is POINTS. PRINTER NAME (SHOWA8) - FCB (N) - POINT-SKIP (E000B034 B&S3) - DEFAULT-SIZE (7 7) - DEFAULT-FONT ( ) - DBCS-CODE (SHOWA) - DEVICE (TAPE UNLOAD) - RECORD (U 4096) - CONCATENATE (Y) Define Half Size EBCDIC fonts for SP-8. FONT NUMBER (001) - WIDTH (3.5) - HEIGHT (10 ) - NAME ('HALF SIZE 7 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (002) - WIDTH (4 ) - HEIGHT (8 ) - NAME ('HALF SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (003) - WIDTH (4.5) - HEIGHT (9 ) - NAME ('HALF SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (004) - WIDTH ( 5 ) - HEIGHT (10 ) - NAME ('HALF SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) 6 16 CA-Easytrieve/Plus Extended Reporting Facility Guide

161 SHOWA8 Model FONT NUMBER (005) - WIDTH ( 7 ) - HEIGHT (14 ) - NAME ('HALF SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (006) - WIDTH ( 6 ) - HEIGHT (12 ) - NAME ('HALF SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (007) - WIDTH (3.6) - HEIGHT (9 ) - NAME ('DEFAULT EBCDIC FONT - HALF - SIZE 10 INCH') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (008) - WIDTH ( 3 ) - HEIGHT ( 6 ) - NAME ('HALF SIZE 6 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (009) - WIDTH (3.5) - HEIGHT (7 ) - NAME ('HALF SIZE NEW 7 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F00A9000) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (010) - WIDTH (3.6) - HEIGHT (9 ) - NAME ('HALF SIZE NEW 10 INCH FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F00B9000) - FUNCTION-TRAILER (001F) - ALIGN (00) Define Full Size EBCDIC fonts for SP-8. FONT NUMBER (011) - WIDTH ( 7 ) - HEIGHT (10 ) - NAME ('FULL SIZE 7 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) Extended Reporting Models 6 17

162 SHOWA8 Model FONT NUMBER (012) - WIDTH ( 8 ) - HEIGHT ( 8 ) - NAME ('FULL SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (013) - WIDTH ( 9 ) - HEIGHT ( 9 ) - NAME ('FULL SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (014) - WIDTH (10 ) - HEIGHT (10 ) - NAME ('FULL SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (015) - WIDTH (14 ) - HEIGHT (14 ) - NAME ('FULL SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (016) - WIDTH (12 ) - HEIGHT (12 ) - NAME ('FULL SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (017) - WIDTH (7.2) - HEIGHT (9 ) - NAME ('FULL SIZE 10 INCH FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (018) - WIDTH ( 6 ) - HEIGHT ( 6 ) - NAME ('FULL SIZE 6 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F ) - FUNCTION-TRAILER (001F) - ALIGN (00) 6 18 CA-Easytrieve/Plus Extended Reporting Facility Guide

163 SHOWA8 Model FONT NUMBER (019) - WIDTH ( 7 ) - HEIGHT ( 7 ) - NAME ('FULL SIZE NEW 7 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F00A9001) - FUNCTION-TRAILER (001F) - ALIGN (00) FONT NUMBER (020) - WIDTH (7.2) - HEIGHT (9 ) - NAME ('FULL SIZE NEW 10 INCH FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F00B9001) - FUNCTION-TRAILER (001F) - ALIGN (00) Define DBCS fonts for SP-8 FONT NUMBER (101) - WIDTH ( 7) - HEIGHT ( 10) - NAME ('DBCS 7 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F000) FONT NUMBER (102) - WIDTH ( 8) - HEIGHT ( 8) - NAME ('DBCS 8 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F001) FONT NUMBER (103) - WIDTH ( 9) - HEIGHT ( 9) - NAME ('DBCS 9 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F002) FONT NUMBER (104) - WIDTH ( 10) - HEIGHT ( 10) - NAME ('DBCS 10 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F003) FONT NUMBER (105) - WIDTH ( 14) - HEIGHT ( 14) - NAME ('DBCS 14 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F004) FONT NUMBER (106) - WIDTH ( 12) - HEIGHT ( 12) - NAME ('DBCS 12 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F005) Extended Reporting Models 6 19

164 SHOWA8 Model FONT NUMBER (107) - WIDTH (7.2) - HEIGHT (9 ) - NAME (DEFAULT DBCS FONT - 10 INCH') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F006) FONT NUMBER (108) - WIDTH ( 6) - HEIGHT ( 6) - NAME ('DBCS 6 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F009) FONT NUMBER (109) - WIDTH ( 7) - HEIGHT ( 7) - NAME ('DBCS NEW 7 POINT FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F00A) FONT NUMBER (110) - WIDTH (7.2) - HEIGHT ( 9) - NAME ('DBCS NEW 10 INCH FONT') - DATA-TYPE (DBCS) - FUNCTION-HEADER (F00B) Define MIXED fonts for SP-8 FONT NUMBER (201) - NAME ('MIXED FONT - 7 POINT') - DATA-TYPE ( ) FONT NUMBER (202) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE ( ) FONT NUMBER (203) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE ( ) FONT NUMBER (204) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE ( ) FONT NUMBER (205) - NAME ('MIXED FONT - 14 POINT') - DATA-TYPE ( ) FONT NUMBER (206) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE ( ) FONT NUMBER (207) - NAME ('DEFAULT MIXED FONT - 10 INCH')- DATA-TYPE ( ) FONT NUMBER (208) - NAME ('MIXED FONT - 6 POINT') - DATA-TYPE ( ) 6 20 CA-Easytrieve/Plus Extended Reporting Facility Guide

165 M8250 Model FONT NUMBER (209) - NAME ('MIXED FONT - NEW 7 POINT') - DATA-TYPE ( ) FONT NUMBER (210) - NAME ('MIXED FONT - NEW 10 INCH FONT')- DATA-TYPE ( ) M8250 Model This model defines support for the MELCOM M8250 printer. Define MELCOM M8250 printer. W-unit is POINTS. H-unit is POINTS. PRINTER NAME ( M8250 ) - FCB ( N ) - POINT-SKIP ( &S2 ) - DEFAULT-SIZE ( 6 6 ) - DEFAULT-FONT ( ) - DBCS-CODE ( MELCOM ) - DEVICE ( TAPE UNLOAD ) - RECORD ( U 4096 ) - CONCATENATE ( Y ) - FILE-HEADER ( 0300 ) - FILE-TRAILER ( 0500 ) Define Half Size EBCDIC fonts for MELCOM M8250 FONT NUMBER ( 001 ) - WIDTH ( 3.5 ) - HEIGHT ( 7 ) - NAME ('HALF SIZE 7 POINT FONT') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2400 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) FONT NUMBER ( 002 ) - WIDTH ( 4 ) - HEIGHT ( 8 ) - NAME ('HALF SIZE 8 POINT FONT') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2401 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) FONT NUMBER ( 003 ) - WIDTH ( 4.5 ) - HEIGHT ( 9 ) - NAME ('HALF SIZE 9 POINT FONT') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2402 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) Extended Reporting Models 6 21

166 M8250 Model FONT NUMBER ( 004 ) - WIDTH ( 5 ) - HEIGHT ( 10 ) - NAME ('HALF SIZE 10 POINT FONT') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2403 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) FONT NUMBER ( 005 ) - WIDTH ( 6 ) - HEIGHT ( 12 ) - NAME ('HALF SIZE 12 POINT FONT') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2405 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) FONT NUMBER ( 006 ) - WIDTH ( 3.6 ) - HEIGHT ( 9 ) - NAME ('DEFAULT EBCDIC FONT - HALF - SIZE 10 INCH') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 2406 ) - FUNCTION-TRAILER ( 0303 ) - ALIGN ( D ) Define DBCS fonts for MELCOM M8250 FONT NUMBER ( 101 ) - WIDTH ( 7 ) - HEIGHT ( 7 ) - NAME ('DBCS 7 POINT FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2200 ) FONT NUMBER ( 102 ) - WIDTH ( 8 ) - HEIGHT ( 8 ) - NAME ('DBCS 8 POINT FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2201 ) FONT NUMBER ( 103 ) - WIDTH ( 9 ) - HEIGHT ( 9 ) - NAME ('DBCS 9 POINT FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2202 ) FONT NUMBER ( 104 ) - WIDTH ( 10 ) - HEIGHT ( 10 ) - NAME ('DBCS 10 POINT FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2203 ) FONT NUMBER ( 105 ) - WIDTH ( 12 ) - HEIGHT ( 12 ) - NAME ('DBCS 12 POINT FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2205 ) 6 22 CA-Easytrieve/Plus Extended Reporting Facility Guide

167 M8250 Model FONT NUMBER ( 106 ) - WIDTH ( 7.2 ) - HEIGHT ( 9 ) - NAME ('DBCS 10 INCH FONT - DEFAULT DBCS FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2206 ) Define MIXED fonts for MELCOM M8250 FONT NUMBER ( 201 ) - NAME ('MIXED FONT - 7 POINT') - DATA-TYPE ( ) FONT NUMBER ( 202 ) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE ( ) FONT NUMBER ( 203 ) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE ( ) FONT NUMBER ( 204 ) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE ( ) FONT NUMBER ( 205 ) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE ( ) FONT NUMBER ( 206 ) - NAME ('MIXED FONT - 10 INCH') - DATA-TYPE ( ) Extended Reporting Models 6 23

168 M8290 Model M8290 Model This model defines support for the MELCOM M8290 printer. Define MELCOM M8290 printer. W-unit is POINTS. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME ( M8290 ) - FCB ( Y ) - DEFAULT-SIZE ( 2 ) - DEFAULT-FONT ( ) - DBCS-CODE ( JIS ) - DEVICE ( TAPE UNLOAD ) - RECORD ( FB ) - MAX-RECORD ( 350 ) - RECORD-END ( 03 ) - RECORD-PAD ( 00 ) Define Alphanumeric Fonts for MELCOM M8290 THE FONT THAT YOU CAN USE DEPENDS ON THE A/N UNIT ASSIGNED TO HOLD THE FONT DURING PRINTER INITIATION. //SELECT JCL COMMAND IS USED TO INITIALIZE THE A/N UNITS. THE FONTS DEFINED HERE SUPPORT ALL THE ALLOWABLE SIZES FOR EACH A/N UNIT. THE FONT TO BE USED WILL DEPEND UPON WHICH OF THE 27 A/N FONT SETS IS ACTUALLY LOADED INTO THAT A/N UNIT. FONT NUMBER ( 001 ) - WIDTH ( 7.2 ) - NAME ('10 CPI IN A/N UNIT 0') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1104 ) FONT NUMBER ( 002 ) - WIDTH ( 6 ) - NAME ('12 CPI IN A/N UNIT 0') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1104 ) FONT NUMBER ( 003 ) - WIDTH ( 4.8 ) - NAME ('15 CPI IN A/N UNIT 0') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1104 ) FONT NUMBER ( 004 ) - WIDTH ( 7.2 ) - NAME ('10 CPI IN A/N UNIT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1105 ) FONT NUMBER ( 005 ) - WIDTH ( 6 ) - NAME ('12 CPI IN A/N UNIT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1105 ) 6 24 CA-Easytrieve/Plus Extended Reporting Facility Guide

169 M8290 Model FONT NUMBER ( 006 ) - WIDTH ( 4.8 ) - NAME ('15 CPI IN A/N UNIT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1105 ) FONT NUMBER ( 007 ) - WIDTH ( 6 ) - NAME ('12 CPI IN A/N UNIT 2') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1106 ) FONT NUMBER ( 008 ) - WIDTH ( 4.8 ) - NAME ('15 CPI IN A/N UNIT 2') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1106 ) FONT NUMBER ( 009 ) - WIDTH ( 4.8 ) - NAME ('15 CPI IN A/N UNIT 3') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 1107 ) Define DBCS fonts for MELCOM M8290 FONT NUMBER ( 101 ) - WIDTH ( 14.4 ) - NAME ('DBCS 12 POINT AT 5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1153 ) FONT NUMBER ( 102 ) - WIDTH ( 12 ) - NAME ('DBCS 12 POINT AT 6 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1165 ) FONT NUMBER ( 103 ) - WIDTH ( 14.4 ) - NAME ('DBCS 9 POINT AT 5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1152 ) FONT NUMBER ( 104 ) - WIDTH ( 12 ) - NAME ('DBCS 9 POINT AT 6 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1162 ) FONT NUMBER ( 105 ) - WIDTH ( 9.6 ) - NAME ('DBCS 9 POINT AT 7.5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1172 ) FONT NUMBER ( 106 ) - WIDTH ( 14.4 ) - NAME ('DBCS 7 POINT AT 5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1151 ) Extended Reporting Models 6 25

170 M8290 Model FONT NUMBER ( 107 ) - WIDTH ( 12 ) - NAME ('DBCS 7 POINT AT 6 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1161 ) FONT NUMBER ( 108 ) - WIDTH ( 9.6 ) - NAME ('DBCS 7 POINT AT 7.5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 1171 ) Define MIXED fonts for MELCOM M8250 There are numerous combinations of DBCS and EBCDIC fonts that can be defined as MIXED fonts. The following definitions are in order based on the DBCS fonts defined earlier. They are combined with the applicable EBCDIC fonts in order based on the A/N unit that may hold the font. 12 POINT DBCS FONT AT 5 CPI ( width is 14.4 point ) WITH 7.2 POINT EBCDIC. FONT NUMBER ( 201 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) 12 POINT DBCS FONT AT 6 CPI ( width is 12 point ) WITH 6 POINT EBCDIC. FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) 9 POINT DBCS FONT AT 5 CPI ( width is 14.4 point ) WITH 7.2 POINT EBCDIC. FONT NUMBER ( 206 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 207 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) 9 POINT DBCS FONT AT 6 CPI ( width is 12 point ) WITH 6 POINT EBCDIC. FONT NUMBER ( 208 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) 6 26 CA-Easytrieve/Plus Extended Reporting Facility Guide

171 M8290 Model FONT NUMBER ( 209 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) FONT NUMBER ( 210 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) 9 POINT DBCS FONT AT 7.5 CPI ( width is 9.6 point ) WITH 4.8 POINT EBCDIC. FONT NUMBER ( 211 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 212 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 213 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 214 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) 7 POINT DBCS FONT AT 5 CPI ( width is 14.4 point ) WITH 7.2 POINT EBCDIC. FONT NUMBER ( 215 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 216 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) 7 POINT DBCS FONT AT 6 CPI ( width is 12 point ) WITH 6 POINT EBCDIC. FONT NUMBER ( 217 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) FONT NUMBER ( 218 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) FONT NUMBER ( 219 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( ) 7 POINT DBCS FONT AT 7.5 CPI ( width is 9.6 point ) WITH 4.8 POINT EBCDIC. FONT NUMBER ( 220 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 221 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) Extended Reporting Models 6 27

172 T8500 Model FONT NUMBER ( 222 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 223 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) T8500 Model This model defines support for the TORAY 8500 printer. Define TORAY 8500 printer. W-unit is POINTS. Defaults: DBCS 9 CPI + EBCDIC 18 CPI. H-unit is Not Applicable. Carriage Control specified in FCB. Overprint code used to insert DBCS Shift In code. PRINTER NAME ( T8500 ) - OVERPRINT-CODES ( PRINT 1 ) - FCB ( Y ) - DEFAULT-SIZE ( 1 ) - DEFAULT-FONT ( ) - DBCS-CODE ( TORAY ) - DEVICE ( TAPE UNLOAD ) - RECORD ( FB ) - MAX-RECORD ( 410 ) - RECORD-END ( 1E ) - RECORD-PAD ( 1E ) Define Half Size EBCDIC Fonts for TORAY Each Function Header must define binary byte count. FONT NUMBER ( 001 ) - WIDTH ( 4 ) - NAME ('HALF SIZE 8 POINT') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( E2E2C5#B2 ) FONT NUMBER ( 002 ) - WIDTH ( 4.5 ) - NAME ('HALF SIZE 9 POINT') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D4E2C5#B2 ) FONT NUMBER ( 003 ) - WIDTH ( 5 ) - NAME ('HALF SIZE 10 POINT') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D3E2C5#B2 ) 6 28 CA-Easytrieve/Plus Extended Reporting Facility Guide

173 T8500 Model FONT NUMBER ( 004 ) - WIDTH ( 6 ) - NAME ('HALF SIZE 12 POINT') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D1E2C5#B2 ) FONT NUMBER ( 005 ) - WIDTH ( 7 ) - NAME ('HALF SIZE 14 POINT') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( C1E2C5#B2 ) Define DBCS fonts for TORAY FONT NUMBER ( 101 ) - WIDTH ( 7 ) - NAME ('DBCS 7 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D8E2 ) FONT NUMBER ( 102 ) - WIDTH ( 8 ) - NAME ('DBCS 8 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( E2E2 ) FONT NUMBER ( 103 ) - WIDTH ( 9 ) - NAME ('DBCS 9 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D4E2 ) FONT NUMBER ( 104 ) - WIDTH ( 10 ) - NAME ('DBCS 10 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D3E2 ) FONT NUMBER ( 105 ) - WIDTH ( 12 ) - NAME ('DBCS 12 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D1E2 ) FONT NUMBER ( 106 ) - WIDTH ( 14 ) - NAME ('DBCS 14 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( C1E2 ) Extended Reporting Models 6 29

174 T8500 Model FONT NUMBER ( 107 ) - WIDTH ( 18 ) - NAME ('DBCS 18 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D8E2 ) FONT NUMBER ( 108 ) - WIDTH ( 24 ) - NAME ('DBCS 24 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D1F7 ) FONT NUMBER ( 109 ) - WIDTH ( 28 ) - NAME ('DBCS 28 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D1F8 ) FONT NUMBER ( 110 ) - WIDTH ( 32 ) - NAME ('DBCS 32 POINT') - DATA-TYPE ( DBCS ) - OVERPRINT-CODE ( 0FE800 ) - FUNCTION-HEADER ( D1F9 ) Define MIXED fonts for TORAY Fonts are defined that combine DBCS font with the EBCDIC font that prints half the size of the DBCS font. FONT NUMBER ( 201 ) - NAME ('MIXED FONT AT 8 CPI') - DATA-TYPE ( ) FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 9 CPI') - DATA-TYPE ( ) FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 10 CPI') - DATA-TYPE ( ) FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 12 CPI') - DATA-TYPE ( ) FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT 14 CPI') - DATA-TYPE ( ) 6 30 CA-Easytrieve/Plus Extended Reporting Facility Guide

175 IBM3200 Model IBM3200 Model This model defines support for the IBM 3200 printer. Define IBM 3200 printer. W-unit is POINTS. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME ( IBM3200 ) - FCB ( Y ) - DEFAULT-SIZE ( 2 ) - DEFAULT-FONT ( ) - DBCS-CODE ( IBM ) - DEVICE ( PRINTER ) - RECORD ( F 206 ) - MAX-RECORD ( ) Define EBCDIC Fonts for IBM EBCDIC fonts supported are 10, 12 and 15 CPI but size depends upon font selection supports the loading of 16 different fonts into printer storage. Each font could have any one of the three sizes. This results in 48 possible combinations of font memory location and font size. This model does not support all possible combinations. FONT NUMBER ( 001 ) - WIDTH ( 7.2 ) - NAME ('EBCDIC 10 CPI AS 3200 FONT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4281 ) FONT NUMBER ( 002 ) - WIDTH ( 6 ) - NAME ('EBCDIC 12 CPI AS 3200 FONT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4281 ) FONT NUMBER ( 003 ) - WIDTH ( 4.8 ) - NAME ('EBCDIC 15 CPI AS 3200 FONT 1') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4281 ) FONT NUMBER ( 004 ) - WIDTH ( 7.2 ) - NAME ('EBCDIC 10 CPI AS 3200 FONT 2') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4282 ) FONT NUMBER ( 005 ) - WIDTH ( 6 ) - NAME ('EBCDIC 12 CPI AS 3200 FONT 2') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4282 ) Extended Reporting Models 6 31

176 IBM3200 Model FONT NUMBER ( 006 ) - WIDTH ( 4.8 ) - NAME ('EBCDIC 15 CPI AS 3200 FONT 2') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4282 ) Define DBCS fonts for IBM DBCS Fonts supported are 6, 7.5 and 10 CPI but size depends upon font selection supports the loading of 16 different fonts into printer storage. Each font could have any one of the three sizes. This results in 48 possible combinations of font memory location and font size. This model does not support all possible combinations. FONT NUMBER ( 101 ) - WIDTH ( 12 ) - NAME ('DBCS 6 CPI AS 3200 FONT 1') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4581 ) FONT NUMBER ( 102 ) - WIDTH ( 9.6 ) - NAME ('DBCS 7.5 CPI AS 3200 FONT 1') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4581 ) FONT NUMBER ( 103 ) - WIDTH ( 7.2 ) - NAME ('DBCS 10 CPI AS 3200 FONT 1') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4581 ) FONT NUMBER ( 104 ) - WIDTH ( 12 ) - NAME ('DBCS 6 CPI AS 3200 FONT 2') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4582 ) FONT NUMBER ( 105 ) - WIDTH ( 9.6 ) - NAME ('DBCS 7.5 CPI AS 3200 FONT 2') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4582 ) FONT NUMBER ( 106 ) - WIDTH ( 7.2 ) - NAME ('DBCS 10 CPI AS 3200 FONT 2') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4582 ) Define 2 Line Complex fonts as 3200 font 1. FONT NUMBER ( 107 ) - WIDTH ( 12 ) - NAME ('DBCS 6 CPI AS 3200 FONT 1 PLUS - LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) 6 32 CA-Easytrieve/Plus Extended Reporting Facility Guide

177 IBM3200 Model FONT NUMBER ( 108 ) - WIDTH ( 9.6 ) - NAME ('DBCS 7.5 CPI AS 3200 FONT 1 - PLUS LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) FONT NUMBER ( 109 ) - WIDTH ( 7.2 ) - NAME ('DBCS 10 CPI AS 3200 FONT 1 - PLUS LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) Define 4 Line Complex fonts as 3200 font 1. FONT NUMBER ( 110 ) - WIDTH ( 12 ) - NAME ('DBCS 6 CPI AS 3200 FONT 1 PLUS - LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 111 ) - WIDTH ( 9.6 ) - NAME ('DBCS 7.5 CPI AS 3200 FONT 1 - PLUS LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 112 ) - WIDTH ( 7.2 ) - NAME ('DBCS 10 CPI AS 3200 FONT 1 - PLUS LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A45811A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) Define MIXED fonts for IBM 3200 Fonts are defined that combine DBCS font with the EBCDIC font that prints half the size of the DBCS font. FONT NUMBER ( 201 ) - NAME ('MIXED FONT AT 6 CPI AS 3200 FONT 1') - DATA-TYPE ( ) FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 7.5 CPI AS 3200 FONT 1')- DATA-TYPE ( ) FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 6 CPI AS 3200 FONT 2') - DATA-TYPE ( ) Extended Reporting Models 6 33

178 H8196 Model FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 7.5 CPI AS 3200 FONT 2')- DATA-TYPE ( ) H8196 Model This model defines support for the HITACHI 8196 printer. Define HITACHI 8196 printer. W-unit is DOTS. Printer supports 240 dots per inch. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME ( H8196 ) - FCB ( Y ) - DEFAULT-SIZE ( 1 ) - DEFAULT-FONT ( ) - DBCS-CODE ( KEIS ) - DEVICE ( PRINTER ) - RECORD ( F 384 ) - MAX-RECORD ( ) Define EBCDIC Fonts for HITACHI FONT NUMBER ( 001 ) - WIDTH ( 16 ) - NAME ('EBCDIC 15 CPI') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4609 ) FONT NUMBER ( 002 ) - WIDTH ( 24 ) - NAME ('EBCDIC 10 CPI') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4613 ) FONT NUMBER ( 003 ) - WIDTH ( 32 ) - NAME ('EBCDIC 7.5 CPI') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4618 ) FONT NUMBER ( 004 ) - WIDTH ( 64 ) - NAME ('EBCDIC 3.75 CPI') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4631 ) FONT NUMBER ( 005 ) - WIDTH ( 128 ) - NAME ('EBCDIC 1.88 CPI') - DATA-TYPE ( EBCDIC ) - FUNCTION-HEADER ( 0A411A4661 ) 6 34 CA-Easytrieve/Plus Extended Reporting Facility Guide

179 H8196 Model Define DBCS fonts for HITACHI FONT NUMBER ( 101 ) - WIDTH ( 24 ) - NAME ('DBCS 10 CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4600 ) FONT NUMBER ( 102 ) - WIDTH ( 32 ) - NAME ('DBCS 7.5 CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4609 ) FONT NUMBER ( 103 ) - WIDTH ( 48 ) - NAME ('DBCS 5 CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4613 ) FONT NUMBER ( 104 ) - WIDTH ( 64 ) - NAME ('DBCS 3.75 CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4618 ) FONT NUMBER ( 105 ) - WIDTH ( 128 ) - NAME ('DBCS CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4631 ) FONT NUMBER ( 106 ) - WIDTH ( 256 ) - NAME ('DBCS.9375 CPI FONT') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A4661 ) Define 2 Line Complex fonts. FONT NUMBER ( 111 ) - WIDTH ( 24 ) - NAME ('DBCS 10 CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46001A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) FONT NUMBER ( 112 ) - WIDTH ( 32 ) - NAME ('DBCS 7.5 CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46091A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) Extended Reporting Models 6 35

180 H8196 Model FONT NUMBER ( 113 ) - WIDTH ( 48 ) - NAME ('DBCS 5 CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46131A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) FONT NUMBER ( 114 ) - WIDTH ( 64 ) - NAME ('DBCS 3.75 CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46181A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) FONT NUMBER ( 115 ) - WIDTH ( 128 ) - NAME ('DBCS CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46311A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) FONT NUMBER ( 116 ) - WIDTH ( 256 ) - NAME ('DBCS.9375 CPI FONT - 2 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46611A4480 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 2 ) Define 4 Line Complex fonts. FONT NUMBER ( 121 ) - WIDTH ( 24 ) - NAME ('DBCS 10 CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46001A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 122 ) - WIDTH ( 32 ) - NAME ('DBCS 7.5 CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46091A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) 6 36 CA-Easytrieve/Plus Extended Reporting Facility Guide

181 H8196 Model FONT NUMBER ( 123 ) - WIDTH ( 48 ) - NAME ('DBCS 5 CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46131A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 124 ) - WIDTH ( 64 ) - NAME ('DBCS 3.75 CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46181A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 125 ) - WIDTH ( 128 ) - NAME ('DBCS CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46311A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) FONT NUMBER ( 126 ) - WIDTH ( 256 ) - NAME ('DBCS.9375 CPI FONT - 4 LINE COMPLEX') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 0A421A46611A44A0 ) - FUNCTION-TRAILER ( 0A44 ) - COMPLEX ( 4 ) Define MIXED fonts for HITACHI Fonts are defined that combine DBCS font with the EBCDIC font that prints half the size of the DBCS font. FONT NUMBER ( 201 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( ) FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 3.75 CPI') - DATA-TYPE ( ) FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT CPI') - DATA-TYPE ( ) FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT.9372 CPI') - DATA-TYPE ( ) Extended Reporting Models 6 37

182 F6715D Model F6715D Model This model defines support for the FUJITSU 6715D/6716D printer. Define FUJITSU 6715D/6716D printer. W-unit is POINTS. H-unit is Not Applicable. Carriage Control specified in FCB. PRINTER NAME ( F6715D ) - OVERPRINT-CODES ( MERGE 4 ) - FCB ( Y ) - DEFAULT-SIZE ( 2 ) - DEFAULT-FONT ( ) - DBCS-CODE ( JEF ) - DEVICE ( PRINTER ) - RECORD ( F 303 ) - MAX-RECORD ( 303 ) NOTE : 1. Font definitions depend upon the specifications for the CHARS=(font1,font2,font3,...) parameter on the print data sets JCL statement. The value of the Overprint code depends upon the order of CHARS operands. Overprint code of X'00' is used for 'font1'; X'01' for 'font2' etc. Define EBCDIC fonts for FUJITSU 6715D/6716D. These fonts to be used depend upon the order of the fonts as specified on the CHARS= option in the JCL for the print data set. FONT NUMBER ( 001 ) - WIDTH ( 4.8 ) - NAME ('EBCDIC 15 CPI') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 00 ) - FUNCTION-HEADER ( 29 ) FONT NUMBER ( 002 ) - WIDTH ( 6 ) - NAME ('EBCDIC 12 CPI') - DATA-TYPE ( EBCDIC ) - OVERPRINT-CODE ( 00 ) - FUNCTION-HEADER ( 29 ) Define DBCS fonts for FUJITSU 6715D/6716D. FONT NUMBER ( 101 ) - WIDTH ( 12 ) - NAME ('DBCS 12 POINT FONT AT 6 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 28 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) 6 38 CA-Easytrieve/Plus Extended Reporting Facility Guide

183 F6715D Model FONT NUMBER ( 102 ) - WIDTH ( 9.6 ) - NAME ('DBCS 9 POINT FONT AT 7.5 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 38 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) FONT NUMBER ( 103 ) - WIDTH ( 12 ) - NAME ('DBCS 9 POINT FONT AT 6 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 3830B8 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) FONT NUMBER ( 104 ) - WIDTH ( 7.2 ) - NAME ('DBCS 7 POINT FONT AT 10 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 3830E2 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) FONT NUMBER ( 105 ) - WIDTH ( 6 ) - NAME ('DBCS HALF SIZE 12 POINT - AT 12 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 2830C0 ) - FUNCTION-TRAILER ( 30C1 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) FONT NUMBER ( 106 ) - WIDTH ( 4.8 ) - NAME ('DBCS HALF SIZE 9 POINT - AT 15 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 3830C0 ) - FUNCTION-TRAILER ( 30C1 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) FONT NUMBER ( 107 ) - WIDTH ( 6 ) - NAME ('DBCS HALF SIZE 9 POINT - AT 12 CPI') - DATA-TYPE ( DBCS ) - FUNCTION-HEADER ( 3830B830C0 ) - FUNCTION-TRAILER ( 30C1 ) - OVERPRINT-CODE ( 00 ) - SPACE-REPLACE ( 40 ) Define MIXED fonts for FUJITSU 6715D/6716D. Fonts are defined that combine DBCS font with the EBCDIC font that prints half the size of the DBCS font. FONT NUMBER ( 201 ) - NAME ('MIXED FONT AT 6 CPI - DBCS 12 POINT') - DATA-TYPE ( ) Extended Reporting Models 6 39

184 F6715D Model FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 7.5 CPI - DBCS 9 POINT')- DATA-TYPE ( ) FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 6 CPI - DBCS 9 POINT') - DATA-TYPE ( ) 6 40 CA-Easytrieve/Plus Extended Reporting Facility Guide

185 Chapter 7 Extended Reporting Usage Introduction This chapter provides further explanation on printer definitions, JCL usage, and CA-Easytrieve/Plus program examples. Descriptions include usage of the more commonly used printers: All Points Addressable Line printers Xerox printers Working with All Points Addressable Printers The IBM 3800 family of printers produces output with 240 dots (pels) per inch resolution. The following conversion aids should be used when working with IBM printers: Width (Pels) Pitch (Chars per inch/cpi) pel = 1/240 inch 240 pels = 1 inch Extended Reporting Usage 7 1

186 Working with All Points Addressable Printers Formula for converting PELS to Pitch: 240/pels = pitch Formula for converting Pitch to PELS: 240/pitch = pels Height (Pels) LPI (Lines per inch) Formula for converting PELS to LPI: 240/pels = lpi Formula for converting LPI to PELS: 240/lpi = pels CA-Easytrieve/Plus actually addresses the printer in mixed mode processing. The first command sent to the printer is an actual ANSI page eject (START-PAGE). This enables all default initialization information (such as form name, form type) to be taken from the JCL instead of being hard-coded in the CA-Easytrieve/Plus printer definition. All subsequent printer information is then given using APA commands. Page Mode Page mode printers can be addressed by CA-Easytrieve/Plus as either absolute (IBM3800C and IBM3800E) coordinates, or relative (IBM3800D and IBM3800F) coordinates. Either coordinate scheme produces the same output on the printed page. Functionally, the IBM3800C and IBM3800D definitions are interchangeable. IBM3800E and IBM3800F are also interchangeable. The record and block sizes on the CA-Easytrieve/Plus file statement should be as large as possible to get the most advantage of a page mode printer ( or 3820). Coding a value of U(32760) would be a good value. 7 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

187 Working with All Points Addressable Printers To make a USER3801 printer definition, using the definition IBM3800C as a printer model, usable for a single 10-pitch font with 6 LPI, code the printer definition as: PRINTER NAME (USER3801) MODEL (IBM3800C) DEFAULT-SIZE (1 1) - DEFAULT-FONT (1) FONT NUMBER (001) - WIDTH (24) - HEIGHT (40) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) With the JCL: //filename DD SYSOUT=,CHARS=GS10 FILE filename EXTENDED USER3801 ASA JOB INPUT NULL DISPLAY filename #1 'GS10' STOP To make a USER3802 printer definition, using the definition IBM3800D as a printer model, usable for a 12-pitch font with 8 LPI, code the printer definition as: PRINTER NAME (USER3802) MODEL (IBM3800D) DEFAULT-SIZE (1 1) - DEFAULT-FONT (1) FONT NUMBER (001) - WIDTH (20) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) With the JCL: //filename DD SYSOUT=,CHARS=GS12 FILE filename EXTENDED USER3802 ASA JOB INPUT NULL DISPLAY filename #1 'GS12' STOP To make a USER3804 printer definition using the definition IBM3800D as a printer model usable for a 15-pitch font with 8 LPI, code the printer definition as: PRINTER NAME (USER3804) MODEL (IBM3800D) DEFAULT-SIZE (1 1) - DEFAULT-FONT (1) FONT NUMBER (001) - WIDTH (16) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) With the JCL: //filename DD SYSOUT=,CHARS=GS15 FILE filename EXTENDED USER3804 ASA JOB INPUT NULL DISPLAY filename #1 'GS15' STOP Extended Reporting Usage 7 3

188 Working with All Points Addressable Printers To make a USER3805 printer definition, using the definition IBM3800D as a printer model, usable for a 15-pitch font with 10 LPI, code the printer definition as: PRINTER NAME (USER3805) MODEL (IBM3800D) DEFAULT-SIZE (1 1) - DEFAULT-FONT (1) FONT NUMBER (001) - WIDTH (16) - HEIGHT (24) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) With the JCL: //filename DD SYSOUT=,CHARS=GS15 FILE filename EXTENDED USER3805 ASA JOB INPUT NULL DISPLAY filename #1 'GS15' STOP To make a USER3806 printer definition, using the definition IBM3800D as a printer model, usable for a set of 10-, 12-, 15- and 10-bold pitch fonts with 8 LPI, code the printer definition as follows. The default font is 10 pitch. PRINTER NAME (USER3806) MODEL (IBM3800D) DEFAULT-SIZE (1 1) - DEFAULT-FONT (1) For 3820 and 3835 printers use codes relative to 1 not 0 FONT NUMBER (001) - WIDTH (24) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F000) For 3820 and 3835 use: FUNCTION-HEADER ( 2BD303F001 ) FONT NUMBER (002) - WIDTH (20) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F001) For 3820 and 3835 use: FUNCTION-HEADER ( 2BD303F002 ) FONT NUMBER (003) - WIDTH (16) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F002) For 3820 and 3835 use: FUNCTION-HEADER ( 2BD303F003 ) 7 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

189 Working with All Points Addressable Printers FONT NUMBER (004) - WIDTH (24) - HEIGHT (30) - DATA-TYPE (EBCDIC) - FUNCTION-HEADER (2BD303F003) For 3820 and 3835 use: FUNCTION-HEADER ( 2BD303F004 ) With the JCL: //filename DD SYSOUT=,CHARS=(GS10,GS12,GS15,GB10) In the CA-Easytrieve/Plus program, #1 (the default, if not specified) refers to font 1 (GS10), #2 refers to font 2 (GS12), #3 refers to font 3 (GS15), and #4 refers to font 4 (GB10). FILE filename EXTENDED USER3806 ASA JOB INPUT NULL DISPLAY filename #1 'GS10' #2 'GS12' #3 'GS15' #4 'GB10' STOP To make an IBM3820 printer definition, using the definition IBM3800E as a printer model, usable for a 15-pitch EBCDIC font and a 7.5-pitch DBCS font with 8 LPI, code the printer definition as follows. The default font is 15-pitch EBCDIC and 7.5-pitch DBCS. PRINTER NAME (IBM3820) MODEL (IBM3800E) - DEFAULT-FONT ( ) Define EBCDIC fonts FONT NUMBER (003) - WIDTH (16) - HEIGHT (30) - DATA-TYPE (EBCDIC) - NAME ('EBCDIC/15 CPI/8 LPI/TRC VALUE 0') - FUNCTION-HEADER (2BD303F001) Define DBCS fonts FONT NUMBER (103) - WIDTH (32) - HEIGHT (30) - DATA-TYPE (DBCS) - NAME ('DBCS/7.5 CPI/8 LPI/TRC VALUE 1') - FUNCTION-HEADER (2BD303F002) Define MIXED fonts FONT NUMBER (203) - With the JCL: DATA-TYPE (3 103) - NAME ('MIXED FONTS') //filename DD SYSOUT=,CHARS=(GS15,M32F) Extended Reporting Usage 7 5

190 Working with All Points Addressable Printers In the CA-Easytrieve/Plus program, #3 (the default, if not specified) refers to EBCDIC font 3 (GS15), #2 refers to DBCS font 103 (M32F). Font 203 is used for mixed EBCDIC and DBCS characters. FILE filename EXTENDED IBM3820 ASA JOB INPUT NULL DISPLAY filename #3 'GS15' #103 D'42F142F242F3' + #203 X'F1F20E42F342F40FF5F6' STOP CA-Easytrieve/Plus drives printers using standard IBM procedures. OS/390 printer information can be given, using the CHARS parameter on the DD statement as described in the above examples, or the information can be specified by using the OUTPUT JCL statement. For example, you could code the following definition to CA-Easytrieve/Plus: //SYSPRINT DD SYSOUT=A,CHARS=(GS10,GB10) or if you have a FORMDEF that has CHARS (and any other pertinent information) you could code: //OUT1 OUTPUT CLASS=A,FORMDEF=formdef //SYSPRINT DD OUTPUT=OUT1 VSE printer information can be given using the CHARS and TRC parameters on the SETPRT statement, or the information can be specified in a Printer-Parameter Member. For example, you could code the following definition to CA-Easytrieve/Plus: // ASSGN SYSxxx,cuu cuu is the address of the 3800 printer as defined to VSE // SETPRT SYSxxx,CHARS=(GS10,GS12,GS15),TRC=Y or if you have a Printer-Parameter Member that contains a PAGEDEF,CHARS (and any other pertinent information) you could code: $$ LST CLASS=x,FNO=fnoname,LST=cuu... // ASSGN SYSxxx,cuu 7 6 CA-Easytrieve/Plus Extended Reporting Facility Guide

191 Working with Line Compatibility Mode Printers Working with Line Compatibility Mode Printers The IBM 3800 family of printers produces output with 240 dots (pels) per inch resolution. The following conversion aids should be used when working with IBM printers: Width (Points) Pitch (Chars per inch/cpi) point = 1/72 inch 72 points = 1 inch Formula for converting Points to Pitch: 72/points = pitch Formula for converting Pitch to Points: 72/pitch = points The height of a line cannot be controlled in Line Compatibility mode. It is controlled by the font itself and the FCB specified on the JCL statement. The model, IBM3800A, is a generic printer definition set up to permit fonts of 10, 12, and 15 in each of the four possible Writable Character Generation Module (WGCM). It is possible, however, that an individual CHAR could use more than one WGCM. To make a USER3801 printer definition, using the definition IBM3800A as a printer model, usable for a set of 10-, 12-, and 15-pitch fonts, code the printer definition as follows. The default font is 10 pitch. PRINTER NAME (USER3801) MODEL (IBM3800A) With OS/390 JCL: //filenme DD SYSOUT=,CHARS=(GS10,GS12,GS15),DCB=OPTCD=J With VSE JCL: // ASSGN SYSxxx,cuu cuu is the address of the 3800 printer as defined to VSE // SETPRT SYSxxx,CHARS=(GS10,GS12,GS15),TRC=Y Extended Reporting Usage 7 7

192 Working with Line Compatibility Mode Printers In CA-Easytrieve/Plus, CHAR GS10 would be referenced by font number 1 (#1). This is the default font (if no font command is specified). CHAR GS12 would be referenced by font number 5 (#5). CHAR GS15 would be referenced by font number 9 (#9). MVS FILE statement: FILE filenme EXTENDED USER3801 ASA VSE FILE statement: FILE filenme EXTENDED USER3801 SYSxxx JOB INPUT NULL DISPLAY filenme #1 'GS10' #2 'GS12' #3 'GS15' #4 'GB10' DISPLAY filenme 'GS10' #2 'GS12' #3 'GS15' #4 'GB10' STOP The literal displays in the respective font. To make a USER3802 printer definition, using the definition IBM3800A as a printer model, usable for a set of 12-, 15- and 10-pitch fonts, code the printer definition as follows. The default font is 15 pitch. PRINTER NAME (USER3802) MODEL (IBM3800A) DEFAULT-FONT(6) With OS/390 JCL: //filenme DD SYSOUT=,CHARS=(GS12,GS15,GS10),DCB=OPTCD=J With VSE JCL: // ASSGN SYSxxx,cuu cuu is the address of the 3800 printer as defined to VSE // SETPRT SYSxxx,CHARS=(GS12,GS15,GS10),TRC=Y In CA-Easytrieve/Plus, CHAR GS12 would be referenced by font number 2 (#2). CHAR GS15 would be referenced by font number 6 (#6). This is the default font (if no font command is specified). CHAR GS10 would be referenced by font number 7 (#7). MVS FILE statement: FILE filenme EXTENDED USER3802 ASA VSE FILE statement: FILE filenme EXTENDED USER3802 SYSxxx JOB INPUT NULL DISPLAY filenme #2 'GS12' #6 'GS15' #7 'GS10' DISPLAY filenme #2 'GS12' 'GS15' #7 'GS10' STOP The literal displays in the respective font. 7 8 CA-Easytrieve/Plus Extended Reporting Facility Guide

193 Working with XEROX Printers Working with XEROX Printers The XEROX 8700 and 9700 printers produce output with 300 dots per inch resolution. The following conversion aids should be used when working with XEROX printers: Width (Dots) Pitch (Chars per inch/cpi) dot = 1/300 inch 300 dots = 1 inch Formula for converting DOTS to Pitch: 300/dots = pitch Formula for converting Pitch to DOTS: 300/pitch = dots Height (Dots) LPI (Lines per inch) Formula for converting DOTS to LPI: 300/dots = lpi Formula for converting LPI to DOTS: 300/lpi = dots Extended Reporting Usage 7 9

194 Working with XEROX Printers Assume that you define a PDE, call it PDE200, and use the following fonts: font width approx type name (dots) point size face L0112A L02BOA 20 9 BOLD L03BOA 22 7 BOLD L0412A L0512A L05SCA SCRIPT The following CA-Easytrieve/Plus extended reporting printer definition would be used. As coded with the DJDE in the FILE-HEADER, this report prints duplex (DUP=YES, both sides of the paper), and shifts the output on the page (SHI=YES, miss the holes on the paper). PRINTER NAME ( XEROX01 ) OVERPRINT-CODES ( PRINT 4 ) - RECORD ( F 212 ) FCB ( Y ) - FILE-HEADER ( - ' DJDE FORMAT=PDE200,FONTINDEX=0,OVERPRINT=PRINT,DUP=YES, - SHI=YES,DATA=(1,211),END;' ) FONT NUMBER ( 1 ) WIDTH ( 22 ) OVERPRINT-CODE ( F1 ) FONT NUMBER ( 2 ) WIDTH ( 20 ) OVERPRINT-CODE ( F2 ) FONT NUMBER ( 3 ) WIDTH ( 22 ) OVERPRINT-CODE ( F3 ) FONT NUMBER ( 4 ) WIDTH ( 20 ) OVERPRINT-CODE ( F4 ) FONT NUMBER ( 5 ) WIDTH ( 30 ) OVERPRINT-CODE ( F5 ) FONT NUMBER ( 6 ) WIDTH ( 30 ) OVERPRINT-CODE ( F6 ) To actually use this definition, you would code the following CA-Easytrieve/Plus program: With OS/390 JCL: //filenme DD SYSOUT= With VSE JCL: // ASSGN SYSxxx,cuu cuu is the address of the 3800 printer as defined to VSE MVS FILE statement: FILE filenme EXTENDED XEROX01 ASA VSE FILE statement: FILE filenme EXTENDED XEROX01 SYSxxx JOB INPUT NULL DISPLAY filenme #1 'L0112A' DISPLAY filenme #2 'L02BOA' DISPLAY filenme #3 'L03BOA' DISPLAY filenme #4 'L0412A' DISPLAY filenme #5 'L0512A' DISPLAY filenme #6 'L05SCA' STOP 7 10 CA-Easytrieve/Plus Extended Reporting Facility Guide

195 Index CONTROL parameter, DISPLAY statement, 5-3 A ALIGN, FONT command, 4-34 All points addressable, 3-12 All Points Addressable printers, 7-1 ANSI carriage control, 3-27, 3-28 B Blocked records, 3-35 C CA-Easytrieve/Plus reporting characteristics, 3-7 syntax, 5-1 Character cell, defined, 3-5 Character sets, mixing, 2-1 COL parameter LINE statement, 5-10 TITLE statement, 5-8 COL parameter, DISPLAY statement, 5-3 Commands, extended reporting, 4-5 COMPLEX parameter, FONT command, 4-34 CONCATENATE, PRINTER command, 4-27 Concatenated records, 3-36 line mode, 3-38 structured fields, 3-37 Control code specification, printer, 4-6 D Data types, 3-39 DATA-TYPE parameter, FONT command, 4-32 DBCS operand, FONT command, 4-32 DBCS-CODE, printer command, 4-23 DEFAULT-FONT, printer command, 4-22 DEFAULT-FORM, PRINTER command, 4-21 DEFAULT-SIZE, PRINTER command, 4-20 DEFINE statement, 5-2 HEADING, 5-2 DEVICE, PRINTER command, 4-24 Diagnostic message, 4-37 format, 4-36 DISK, PRINTER command, 4-24 DISPLAY statement, 5-3 COL, 5-3 CONTROL, 5-3 POS, 5-4 Documentation conventions, 1-3 Dots, defined, 3-3 Double byte alignment, 3-44 Downward adjustment, 3-6 E EBCDIC operator, FONT command, 4-32 Index 1

196 End page, 3-26 END PAGE parameter, PRINTER command, 4-16 End page records, 3-32 Error messages, 4-37 EXTENDED parameter, FILE statement, 5-1 Extended reporting commands, 4-5 syntax rules, 4-5 Extended Reporting Facility, installation, 4-1 Extended reporting features, 2-2 EZTPX04, 4-2 EZTPX04 error diagnostics, 4-36 EZTPXRPT, 4-2 F F6715D model, 6-38 FCB, PRINTER command, 4-19 Field types, 3-39 Fields, mixed, 3-52 File format, print data set, 3-35 File header records, 3-31, 3-33 FILE statement, 2-5 EXTENDED, 5-1 FILE Statement, 5-1 File trailer records, 3-33, 3-34 File type, 3-30 FILE-HEADER, PRINTER command, 4-28 FILE-TRAILER, PRINTER command, 4-29 Font defined, 2-2, 3-1 height, 3-5 identification, 2-6 mixing different sizes, 3-48 sizes, 3-4 width, 3-6 Font characteristics, 3-39 Font codes, 2-5 FONT command, 4-29 ALIGN, 4-34 COMPLEX, 4-34 DATA-TYPE, 4-32 DBCS, 4-32 EBCDIC, 4-32 FUNCTION-HEADER, 4-33 FUNCTION-TRAILER, 4-33 HEIGHT, 4-31 NAME, 4-31 NUMBER, 4-30 OVERPRINT-CODE, 4-32 SPACE-REPLACE, 4-35 WIDTH, 4-30 Fonts function header and function trailer, 3-40 height and width, 3-40 multiple in a report, 2-2 overprint codes, 3-40 space replacement, 3-40 Format page, 3-26, 3-32 FORMAT PAGE parameter PRINTER command, 4-16 Function codes, 3-16 control information, 3-10 text, 3-10 Function header, fonts, 3-40 Function trailer, fonts, 3-40 FUNCTION-HEADER, FONT command, 4-33 FUNCTION-TRAILER, FONT command, 4-33 G Generation of EZTPXRPT, 4-2 H H8196 model, 6-34 HEADING parameter DEFINE statement, 5-2 HEIGHT parameter, FONT command, 4-31 Height, font, 3-5 Index 2 CA-Easytrieve/Plus Extended Reporting Facility Guide

197 H-unit, 3-4 I IBM3200 model, 6-31 IBM3800A model, 6-3 IBM3800B model, 6-5 IBM3800C model, 6-8 IBM3800D model, 6-9 IBM3800E model, 6-10 IBM3800F model, 6-11 Installation, 4-1 options module, 4-2 L Line Compatibility Mode printers, 7-7 Line complexes, 3-45 Line element calculating length, 3-48 LINE element processing, 3-47 Line feed operations, 3-29 Line mode, 3-27 Line mode printers, 3-14 overprint and function codes, 3-16 Line printer, 7-7 LINE statement COL, 5-10 LINESIZE parameter, REPORT statement, 5-7 M M8250 model, 6-21 M8290 model, 6-24 Machine carriage control codes, 3-28 MAX-RECORD, PRINTER command, 4-26 MERGE operand, PRINTER command, 4-17 Merge overprint, 3-17 Messages, diagnostic, 4-37 MIXED field font selection, 3-56 printing, 3-52 support of merge overprint, 3-58 MODEL parameter, PRINTER command, 4-13 Multiple print lines, 3-7 N NAME parameter FONT command, 4-31 PRINTER command, 4-13 SYSPRINT Command, 4-10 NUMBER parameter, FONT command, 4-30 O Options module installation, 4-2 OS/390 printer, 7-6 Overprint codes, 3-9, 3-15 function codes, 3-16 gap, 3-58 techniques, 3-17 OVERPRINT-CODES FONT command, 4-32 PRINTER command, 4-17 P Page printers, 3-12, 3-25 function codes, 3-12 print record diagram, 3-14 set horizontal position, 3-12 set vertical position, 3-12 Index 3

198 PAGESIZE parameter, REPORT statement, 5-6 Paper control codes carriage control, 3-9, 3-24 systems, 3-23, 3-30 PELs, defined, 3-3 Point skip vertical spacing control, 3-29 Points, defined, 3-2 POINT-SKIP, PRINTER command, 4-19 POS parameter, DISPLAY statement, 5-4 Print data set, file format, 3-35 Print element, centering, 3-50 Print fonts, 2-2 Print item positioning, 3-58, 3-61 overprint gap, 3-58 Print items, 3-10 defined, 3-1 Print lines, 3-8 PRINT operand, PRINTER command, 4-17 Print overprint, 3-19, 3-61 no overlaying, 3-21 Print record, defined, 3-2 Print records, 3-8, 3-34 carriage control, 3-34 function codes, 3-34 maximum length, 3-34 print items, 3-34 Printer characteristics, 3-10 diagram, 3-11 units of measure, 3-3 PRINTER command, 4-11 CONCATENATE, 4-27 DBCS-CODE, 4-23 DEFAULT-FONT, 4-22 DEFAULT-FORM, 4-21 DEFAULT-SIZE, 4-20 DEVICE, 4-24 DISK, 4-24 END PAGE, 4-16 FCB, 4-19 FILE-HEADER, 4-28 FILE-TRAILER, 4-29 FORMAT, 4-16 MAX-RECORD, 4-26 MERGE, 4-17 MODEL, 4-13 OVERPRINT-CODES, 4-17 POINT-SKIP, 4-19 PRINT, 4-17 PRINTER, 4-25 RECORD, 4-25 RECORD-END, 4-27 RECORD-PAD, 4-28 REPEAT-CHAR, 4-28 shift-in, 4-19 shift-out, 4-19 START-PAGE, 4-16 STRUCTURED-FIELDS, 4-15 TAPE, 4-25 TERMINAL, 4-18 PRINTER Command NAME, 4-13 Printer control code specification, 4-6 Printer identification, 2-5 PRINTER option, PRINTER command, 4-25 PRINTER parameter, REPORT statement, 5-6 Printer support, 2-4 Printer type, 3-11 Printers All Points Addressable, 7-1 line, 7-7 supported, 4-1 XEROX, 7-9 Publications, CA-Easytrieve/Plus, 1-2 R Record format line mode, 3-33 page printers, 3-31 RECORD, PRINTER command, 4-25 RECORD-END, PRINTER command, 4-27 RECORD-PAD, PRINTER command, 4-28 Records blocked, 3-35 concatenated, 3-36 unblocked, 3-36 Index 4 CA-Easytrieve/Plus Extended Reporting Facility Guide

199 REPEAT-CHAR, PRINTER command, 4-28 Report definition statements, 5-8 Report layout processing, 3-47 Report processing, 5-4 REPORT statement, file directing parameters PRINTER, 5-6 REPORT statement, format SIZE determination parameters, 5-5 REPORT statement, spacing control parameters LINESIZE, 5-7 PAGESIZE, 5-6 SKIP, 5-7 SPACE, 5-7 TITLESKIP, 5-8 Reporting vs. extended reporting, 2-2 Reporting with multiple fonts, 2-2 S Shift-in, PRINTER command, 4-19 Shift-out, PRINTER command, 4-19 SHOWA7 model, 6-12 SHOWA8 model, 6-16 SIZE parameter, REPORT statement, 5-5 SKIP parameter, REPORT statement, 5-7 SPACE parameter, REPORT statement, 5-7 Space replacement, fonts, 3-40 SPACE-REPLACE, FONT command, 4-35 Start page, 3-25 records, 3-31 START-PAGE, PRINTER command, 4-16 STRUCTURED-FIELDS, PRINTER command, 4-15 Supported printers, 2-4, 3-23, 4-1 SYSNO parameter, SYSPRINT command, 4-10 SYSPRINT command, 4-9 SYSNO, 4-10 SYSPRINT Command NAME, 4-10 System overview, 2-4 T T8500 model, 6-28 TAPE, PRINTER command, 4-25 TERMINAL parameter, PRINTER command, 4-18 Terminology, 3-1 TITLE statement, COL, 5-8 TITLESKIP parameter, REPORT statement, 5-8 U Unblocked records, 3-36 Unit of measure defined, 3-2 Units of measure table, 3-3 Upward adjustment, 3-6 V Vertical position, control of, 3-24 VSE printer, 7-6 W WIDTH parameter, FONT command, 4-30 Width, font, 3-6 Windows, 3-50 W-unit, 3-4 Index 5

200 X XEROX Printers, 7-9 XRPT commands, 4-5 Index 6 CA-Easytrieve/Plus Extended Reporting Facility Guide