For OS/390, VM, VSE - jmit.com · Point Skip Vertical Spacing ... Each record represents a logical print line that CA-Easytrieve/Plus builds ... CA-Easytrieve/Plus Extended Reporting

Extended Reporting Facility Guide6.2

®

For OS/390, VM, VSE

SP3

Release 6.2, May 1996Updated: April 1999

This documentation and related computer software program (hereinafter referred to as the “Documentation”) is forthe end user’s informational purposes only and is subject to change or withdrawal by Computer AssociatesInternational, Inc. (“CA”) at any time.

THIS DOCUMENTATION MAY NOT BE COPIED, TRANSFERRED, REPRODUCED, DISCLOSED ORDUPLICATED, IN WHOLE OR IN PART, WITHOUT THE PRIOR WRITTEN CONSENT OF CA. THISDOCUMENTATION IS PROPRIETARY INFORMATION OF CA AND PROTECTED BY THE COPYRIGHT LAWSOF 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 WARRANTIESOF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENTWILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT ORINDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOSTPROFITS, BUSINESS INTERRUPTION, GOODWILL OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OFSUCH LOSS OR DAMAGE.

THE USE OF ANY PRODUCT REFERENCED IN THIS DOCUMENTATION AND THIS DOCUMENTATION ISGOVERNED 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 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) orDFARS Section 252.227.7013(c)(1)(ii) or applicable successor provisions.

� 1996-2000 Computer Associates International, Inc., One Computer Associates Plaza, Islandia, New York 11749. Allrights reserved.

All trademarks, trade names, service marks, or logos referenced herein belong to their respective companies.

Contents iii

Contents

Chapter 1: About This GuidePurpose and Audience ........................................................................ 1–1Organization ................................................................................. 1–1Other CA-Easytrieve/Plus Publications ......................................................... 1–2Documentation Conventions ................................................................... 1–3

Variable Parameters ....................................................................... 1–4

Chapter 2: OverviewIntroduction .................................................................................. 2–1

Extended Reporting Facilities............................................................... 2–1Extended Reporting Sample ............................................................ 2–2

System Overview ............................................................................. 2–4Printer Support ........................................................................... 2–4Printer Identification ...................................................................... 2–5Font Identification......................................................................... 2–6

Chapter 3: System ConceptsTerminology.................................................................................. 3–1

Font.................................................................................. 3–1Print Item............................................................................. 3–1Print Record .......................................................................... 3–2Unit of Measure ....................................................................... 3–2Font Sizes............................................................................. 3–4Character Cell......................................................................... 3–5Height................................................................................ 3–5Width ................................................................................ 3–6CA-Easytrieve/Plus Reporting Characteristics ........................................... 3–7Print Lines ............................................................................ 3–8Print Records ......................................................................... 3–8

iv CA-Easytrieve/Plus Extended Reporting Facility Guide

Printer Characteristics ....................................................................... 3–10Printer Type............................................................................. 3–11

Page Printers ........................................................................ 3–12Line Mode .......................................................................... 3–14Overprint Codes ..................................................................... 3–15Function Codes ...................................................................... 3–16Overprint and Function Codes ........................................................ 3–16Overprint Techniques ................................................................ 3–17Merge Overprint ..................................................................... 3–17Print Overprint ...................................................................... 3–19Supported Printers ................................................................... 3–23

Paper Control Codes - Carriage Control.................................................... 3–24Page Printers ........................................................................ 3–25Start Page ........................................................................... 3–25End Page............................................................................ 3–26Format Page ......................................................................... 3–26Line Mode .......................................................................... 3–27ANSI Carriage Control plus a Forms Control Block...................................... 3–27Machine Carriage Control Codes Plus a Forms Control Block............................. 3–28ANSI Carriage Control with no Forms Control Block .................................... 3–28Point Skip Vertical Spacing Control .................................................... 3–29

File Type................................................................................ 3–30Record Format - Page Printers......................................................... 3–31File Header Records.................................................................. 3–31Start Page Record(s) .................................................................. 3–31End Page Record(s) .................................................................. 3–32Format Page ......................................................................... 3–32File Trailer Records .................................................................. 3–33Record Format - Line Mode ........................................................... 3–33File Header Records.................................................................. 3–33Print Records ........................................................................ 3–34File Trailer Records .................................................................. 3–34File Format .......................................................................... 3–35Blocked Records ..................................................................... 3–35Unblocked Records .................................................................. 3–36Concatenated Records ................................................................ 3–36Concatenated Records - Structured Fields .............................................. 3–37Concatenated Records - Line Mode .................................................... 3–38

Contents v

Font Characteristics ..........................................................................3–39Data Type ...............................................................................3–39Height and Width ........................................................................3–40Overprint Code ..........................................................................3–40Function Header and Function Trailer......................................................3–40Space Replacement .......................................................................3–40Double Byte Alignment ...................................................................3–44Line Complexes ..........................................................................3–45

Report Layout Processing .....................................................................3–47LINE Element Processing..................................................................3–47MIXED Field Printing.....................................................................3–52MIXED Field Font Selection ...............................................................3–56

MIXED Field Support of Merge Overprint ..............................................3–58Print Item Positioning Considerations ......................................................3–58

Overprint Gap .......................................................................3–58Item Placement Restrictions ...........................................................3–61

Chapter 4: Extended Reporting Options ModuleIntroduction .................................................................................. 4–1

Installation Steps .......................................................................... 4–2For OS/390: .............................................................................. 4–2

OS/390 Installation Notes:.............................................................. 4–2For VSE Pre SP2.1 ......................................................................... 4–3

VSE Pre SP2.1 Notes:................................................................... 4–3For VSE SP2.1: ............................................................................ 4–4

VSE SP2.1 Notes: ...................................................................... 4–4XRPT Commands Overview ................................................................... 4–5

XRPT COMMANDS - Syntax Overview ..................................................... 4–5Syntax Rules .............................................................................. 4–5Example.................................................................................. 4–6Printer Control Code Specification .......................................................... 4–6

SYSPRINT Command ......................................................................... 4–9Syntax ................................................................................... 4–9

Keywords ...........................................................................4–10PRINTER Command .........................................................................4–11

Syntax ..................................................................................4–12Keywords ...........................................................................4–13

FONT Command ............................................................................4–29Syntax ..................................................................................4–30

Keywords ...........................................................................4–30

vi CA-Easytrieve/Plus Extended Reporting Facility Guide

EZTPX04 Error Diagnostics................................................................... 4–36Introduction............................................................................. 4–36Diagnostic Message Format............................................................... 4–36

Message ID.......................................................................... 4–36Diagnostic Message .................................................................. 4–36Message Supplement ................................................................. 4–36

Diagnostic Messages ..................................................................... 4–37

Chapter 5: Extended ReportingIntroduction ................................................................................. 5–1FILE Statement ............................................................................... 5–1DEFINE Statement............................................................................ 5–2DISPLAY Statement .......................................................................... 5–3

Syntax ................................................................................... 5–3Format 1 ............................................................................. 5–3Format 3 ............................................................................. 5–4

Report Processing ............................................................................ 5–4REPORT Statement ....................................................................... 5–5

Syntax ............................................................................... 5–5Report Definition Statements .................................................................. 5–8

TITLE Statement.......................................................................... 5–8Syntax ............................................................................... 5–8

HEADING Statement ..................................................................... 5–9Syntax .............................................................................. 5–10Example ............................................................................ 5–10

LINE Statement.......................................................................... 5–10Syntax .............................................................................. 5–10

Chapter 6: Extended Reporting ModelsIntroduction ................................................................................. 6–1IBM3800A Model............................................................................. 6–3IBM3800B Model ............................................................................. 6–5IBM3800C Model ............................................................................. 6–8IBM3800D Model............................................................................. 6–9IBM3800E Model ............................................................................ 6–10IBM3800F Model ............................................................................ 6–11SHOWA7 Model ............................................................................ 6–12SHOWA8 Model ............................................................................ 6–16M8250 Model ............................................................................... 6–21

Contents vii

M8290 Model................................................................................6–24T8500 Model ................................................................................6–28IBM3200 Model..............................................................................6–31H8196 Model ................................................................................6–34F6715D Model ...............................................................................6–38

Chapter 7: Extended Reporting UsageIntroduction .................................................................................. 7–1Working with................................................................................. 7–1

Page Mode............................................................................ 7–2Working with Line Compatibility Mode Printers ................................................. 7–7Working with XEROX Printers ................................................................. 7–9

Index

About This Guide 1–1

Chapter

1 About This Guide

Purpose and Audience

The CA-Easytrieve/Plus Extended Reporting Facility Guide provides the technicaldetails for generating the extended reporting options module. It also discussesconcepts of extended reporting and how to create multiple font reports.

The CA-Easytrieve/Plus Extended Reporting Facility Guide is intended primarily fortechnical personnel at your site.

Organization

This guide is divided into several chapters:

� “Overview” introduces the user to the use and intent of the documentationand the Extended Reporting Facility.

� “System Concepts” discusses concepts related to the use of Impact Dot, InkJet, and Electro-Photographic printers and how the Extended ReportingFacility deals with them.

� “Extended Reporting Options Module” discusses the procedures you mustfollow to generate your customized extended reporting options module.

� “Extended Reporting” includes the CA-Easytrieve/Plus syntax you must useto produce extended (multiple font) reports.

� “Extended Reporting Modules” contains a series of printer models forcommonly used printers intended as examples for setting up the extendedreporting options module.

� “Extended Reporting Usage” provides further explanation on printerdefinitions, JCL usage, and CA-Easytrieve/Plus program examples.

� The Index provide listings to facilitate references to terms and procedures.

Other CA-Easytrieve/Plus Publications

1–2 CA-Easytrieve/Plus Extended Reporting Facility Guide

Chapters 2, 3, 5, 6, and 7 of the CA-Easytrieve/Plus Extended Reporting FacilityGuide should be referenced only when generating the extended reporting optionsmodule or when changing extended reporting options. Chapter 5 containsCA-Easytrieve/Plus syntax for using extended reporting but this syntax is alsoincluded in the CA-Easytrieve/Plus Reference Guide.

Other CA-Easytrieve/Plus Publications

In addition to this CA-Easytrieve/Plus Extended Reporting Facility Guide, ComputerAssociates provides the following CA-Easytrieve/Plus documentation:

Name Contents

CA-Easytrieve/PlusReference Guide

Contains descriptions of all product features and functionsas well as summaries of each CA-Easytrieve/Plus version.

CA-Easytrieve/PlusInstallation Guide

Describes the process of installing and tuning theCA-Easytrieve/Plus system.

CA-Easytrieve/PlusCA-ActivatorSupplement

Explains how to install and maintain CA-Easytrieve/Pluson your OS/390 system, using the CA-Activator.

CA-Easytrieve/PlusUser Guide

Provides new users with the information they need tobecome productive quickly. It includes a six lesson tutorialand a format designed to make the material moreinteresting and easier to comprehend.

CA-Easytrieve/PlusApplication Guide

Describes basic syntax (a subset of the syntax in theCA-Easytrieve/Plus Reference Guide) and operation, andprovides a series of actual applications, from singleexamples to full systems. The Application Guide is anexcellent tool for the business-oriented professional.

CA-Easytrieve/PlusInterface OptionGuides

Short guides available for users of various system options.These consist of manuals for IMS/DLI processing,CA-IDMS and IDD processing, TOTAL processing, SQLprocessing, CA-Datacom/DB processing, SUPRAprocessing, and other CA-Easytrieve/Plus options.

Documentation Conventions

About This Guide 1–3


The following conventions are used throughout this guide for illustrativepurposes:

Notation Meaning

{braces} Mandatory choice of one of these entries.

[brackets] 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 precedingparameters multiple times.

CAPS All capital letters indicate a keyword, name, or field used in aprogram example.

lowercase Lowercase letters represent variable information in statementsyntax. If the same variable types recur within a statement,they are made unique by adding a numeric suffix, such asliteral-2.



Variable Parameters

Parameter Meaning

field-name A data field defined in your program.

file-name A unique file name defined in the library section of yourprogram.

index name Name of an INDEX data item.

integer A numeric literal (a whole number greater than zero).

job-name Name of a JOB activity.

letter A single alphabetic character (such as an edit mask identifier).

literal A text string enclosed in quotes or a numeric constant.

proc-name Name of a procedure.

program-name Name of a program written in a language other thanCA-Easytrieve/Plus (such as COBOL or Assembler).

record-name Name of an IMS/DLI or CA-IDMS entity.

report-name Name of a REPORT.

sort-name Name of a SORT activity.

Overview 2–1

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 anumber of automatic features. Many of these automatic features rely onassumptions 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 characterthat 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 orunblocked. Each record represents a logical print line thatCA-Easytrieve/Plus builds during the generation of a report or through theexecution of the DISPLAY statement.

These assumptions restrict the use of Impact Dot, Ink-Jet, andElectro-Photographic printers that have extended reporting capabilities.

Extended Reporting Facilities

CA-Easytrieve/Plus Extended Reporting Facility provides support for ImpactDot, Ink-Jet, and Electro-Photographic printers. This facility interacts with theCA-Easytrieve/Plus reporting mechanism to provide support for additionalfeatures 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 fieldsand literals, and data containing DBCS (Double Byte Character Set) formatcodes. Double Byte Character sets represent writing systems that use morethan 256 characters, such as Kanji (Japanese characters).

2. Process fields and literals belonging to different fonts. For example, in thesame report you can use multiple fonts.

Introduction


A font is a complete set of images of characters and symbols having commoncharacteristics (such as style, height, width, weight). In a CA-Easytrieve/Plusreport, each character within a font must have the same amount of lateralspace. That is, CA-Easytrieve/Plus supports only Fixed Pitch fonts.

CA-Easytrieve/Plus automatically formats a report compensating for fieldsand 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 moduleEZTPXRPT to define the character widths that CA-Easytrieve/Plus uses. Themodule can define the widths as either characters per inch (pitch) or a pointsize where the term point defines the size of a character as a multiple of1/72nd of an inch. For more information on the CA-Easytrieve/Plusextended reporting options module, refer to Chapter 4.

3. Support control codes in addition to the ANSI paper control codes.

4. Support printer files that use non-standard record formats, block sizes, andrecord lengths.

Extended Reporting Sample

With extended reporting, you can use multiple print fonts in a report. Thisenables you to highlight fields of special significance. For an example of what theExtended Reporting Facility can do, take a look at the sample report shownbelow. (The CA-Easytrieve/Plus program that produced the report is shownnext.)

Introduction

Overview 2–3

Sample Report

REGION PAY SCALE SUMMARYREGION: 1

BRANCH DEPT EMPLOYEENUMBER

GROSSPAY

NETPAY

DEDUCTIONS

01 903 12267 373.60 251.65 121.95

918 02200 804.64 554.31 250.33

1,178.24 805.96 372.28

02 943 11473 759.20 547.88 211.32

935 00370 554.40 340.59 213.81

1,313.60 888.47 425.13

03 915 02688 146.16 103.43 42.73

914 11602 344.80 250.89 93.91

490.96 354.32 136.64

04 917 11931 492.26 355.19 137.07

911 11357 283.92 215.47 68.45

932 11467 396.68 259.80 136.63

911 01963 445.50 356.87 88.63

1,618.36 1,187.33 431.03

4,601.16 3,236.08 1,365.08

END OF REGION 1

System Overview


Sample Program

The following CA-Easytrieve/Plus program created the report on the previouspage. Note the fields and literals preceded by a pound sign (#) and integer.

FILE FILEAREGION 1 1 NBRANCH 2 2 N HEADING ( #5 'BRANCH') <EMP# 9 5 N HEADING ('EMPLOYEE' 'NUMBER')NAME 17 20 A HEADING ('EMPLOYEE' 'NAME')STREET 37 20 ACITY 57 12 ASTATE 69 2 AZIP 71 5 NNET 90 4 P 2 HEADING ('NET' 'PAY')GROSS 94 4 P 2 HEADING ('GROSS' 'PAY')DEPT 98 3 NDEDUCT W 4 P 2 HEADING ('DEDUCTIONS')JOB INPUT FILEA NAME BASIC DEDUCT = GROSS - NET PRINT REPORT1REPORT 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 hasits own characteristics, especially with respect to the identification of the font, thepresentation of print records, and the distinction between character sets. Tosupport each printer's characteristics, CA-Easytrieve/Plus uses an extendedreporting options module. The extended reporting options module defines thetype of printer that CA-Easytrieve/Plus supports, and the font codes that theCA-Easytrieve/Plus program supports.

The extended reporting options module, called EZTPXRPT, is not provided aspart of the normal installation of CA-Easytrieve/Plus. Therefore, theCA-Easytrieve/Plus reporting mechanism uses the default mode of operation.CA-Easytrieve/Plus programs can use the Extended Reporting Facility only afteryour systems programmer generates the extended reporting options module. Forinformation on how to generate the module, see the CA-Easytrieve/Plus InstallationGuide and Chapter 4 of this guide.

System Overview

Overview 2–5

The extended reporting options module can provide support for the followingprinters:

� 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 theCA-Easytrieve/Plus system use. A unique extended printer name (XRPT-name)identifies each printer in the module. This name not only identifies thecharacteristics of the printer but also enables you to define up to 256 differentfont codes for use in CA-Easytrieve/Plus programs.

The font codes cause fields and literals to be correctly formatted into output linesso that the printer can print them using the correct font sets.

The extended reporting printer name is an option on the FILE statement of theCA-Easytrieve/Plus program. Once you define an extended reporting printername on a CA-Easytrieve/Plus FILE statement, any output, whether it is from areport or from the DISPLAY command, directed to that file, is formatted basedon the characteristics defined for that extended reporting printer.

The following exhibit illustrates the CA-Easytrieve/Plus syntax supported by theExtended Reporting Facility.

Note: The EXTENDED keyword on the CA-Easytrieve/Plus FILE statementenables you to associate the extended reporting printer to a CA-Easytrieve/Plusprinter file.

System Overview


Also, the following exhibit illustrates the use of the CA-Easytrieve/PlusDISPLAY statement within the processing logic of a program to direct print linesto that printer file, thereby taking advantage of the extended reporting facilitiesthat the printer provides.

Font Identification

The final exhibit illustrates the definition of two extended reporting printernames in the extended reporting options module. Both printers are using thesame MODEL definition while associated with each extended reporting printer isa different set of fonts.

The FILE statement in the previous exhibit illustrated the association of anextended reporting printer named IBM38002 to a file called NEWPTR. TheDISPLAY statement in the exhibit illustrates the use of different fonts on thesame print line.

The fonts used in the previous exhibit are defined for the extended reportingprinter called IBM38002. This definition is illustrated in the next exhibit.

As a result, FIELD1 is output at 10 characters per inch (the default, since nooverride 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 withthe character '#' followed by an integer. This integer defines the number of thefont in the font table of the extended reporting printer that you are using.

System Overview

Overview 2–7

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 DoubleByte Character Set (DBCS). Use this data type to output characters for languagessuch as Japanese, Chinese, Korean, and so on.

System Concepts 3–1

Chapter

3 System Concepts

Terminology

This chapter defines terminology used throughout this guide. It is important thatyou thoroughly understand these terms before reading the later chapters in thisguide.

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 createcharacter images of that font on a specific extended reporting printer. Thisinformation includes the characteristics of the font that CA-Easytrieve/Plusrequires to format a report (height, width, and so on). It also includes the printercontrol codes that specific extended reporting printers require for output recordsthat 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/Plusstatements that produce printed output (for example, the LINE, TITLE, andDISPLAY statements). CA-Easytrieve/Plus associates each print item with a font.CA-Easytrieve/Plus uses the height and width characteristics of the font toposition a print item on a line. CA-Easytrieve/Plus merges the printer controlcodes 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 bytecharacter format data (DBCS), or a mixture of both (MIXED).

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 textCA-Easytrieve/Plus assumed that each character was to be printed using thesame 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 lineoccupied an amount of horizontal space that was directly proportional to thenumber of characters in that print item. In other words, all the calculations thatdetermined the positioning of print items on a print line did not need to considerthe size characteristic of the font being used to print that particular item. The sizewas 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 samereport where each font can have a different height or width. As a result, a printitem now occupies an amount of vertical space equal to the height characteristicof the font and an amount of horizontal space (equal to the number of charactersin the item multiplied by the width characteristic of the font).

Therefore, CA-Easytrieve/Plus must position items on a print line using both thesize of the print item and the size of the font associated with that print item. Todo this, you must define the size characteristic of each font as a multiple of a unitof measure that is standard for all the fonts within a given extended reportingprinter. The specific unit of measure assigned to a particular extended reportingprinter is of no consequence for the extended reporting mechanism. What isimportant is that the sizes of all fonts assigned to a particular extended reportingprinter 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 (orheight) of typefaces. A point is approximately equal to 72 dots per inch.

Terminology


Dots

A dot is the fundamental unit of imaging and digitization forelectro-photographic printers. The size of a dot varies depending upon theresolution of the printer. The resolution is normally expressed as the number ofdots per inch. The larger the number of dots, the higher the resolution quality ofthe printer. For example, the Xerox 8700 and Xerox 9700 support 300 dots perinch; the MELCOM 8290, IBM 3200, and HITACHI 8196 support 240 dots perinch; the TORAY 8500 supports 140 dots per inch.

PELs

A PEL (Picture Element) is the IBM term used to refer to the fundamental unit ofimaging on the IBM 3800 printing systems. A PEL is the same as a dot but it isalso used as the addressable unit for “All Points Addressable” printing on the3800 Model III and VIII, and the 3820. For these printers, 240 PELs per inch aresupported.

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 mustconsider when determining the unit of measure. These characteristics are:

1. The definition of the height and width characteristic of a font can only beaccurate to two decimal positions. If a font requires greater accuracy thanthat, then you must re-evaluate the unit of measure.

Terminology


2. For printers that are “All Points Addressable” (like the IBM 3800 Model IIIand VIII, and the IBM 3820), CA-Easytrieve/Plus must assign positions toprint items in terms of the unit of measure known by that printer. Theseprinters require control information (item positioning, item sizes, page sizes,line sizes) in one unit of measure (PEL's for example). ForCA-Easytrieve/Plus to meet these requirements, you must use the same unitof measure to define the printer characteristics that the extended reportingoptions module identifies. For example, if you define all the fonts in terms ofa number of points, then CA-Easytrieve/Plus cannot support a printer thatsupports PEL's as the unit of page addressing. In this case,CA-Easytrieve/Plus positions items on a page by using values that aremultiples of points but the printer interprets these values as a number ofPELs. This produces incorrect results. Therefore, for “All PointsAddressable” printers, CA-Easytrieve/Plus restricts the selection of the unitof 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 printerfunction code. These printers use this value for Paper Control Codes(Carriage Control) where the amount of vertical space to be skipped isdefined as a multiple of a certain unit of measure. For example, the SHOWASP-7, SP-8, and the MELCOM 8250 all require the skip amount be defined interms of a number of points. For printers having this characteristic, the unitof measure selected to define the other characteristics of the printer must bethe same. Using more than one unit of measure causes the printer to interpretthe value CA-Easytrieve/Plus merges by a unit of measure different from theone with which it was defined.

Font Sizes

As illustrated earlier, a variety of units of measure can define a printer'scharacteristics. 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 ofthe actual unit of measure selected (points, dots, pels, and so on), a number ofH-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 accuratelydetermine the positioning of print items on a line or page. The definition of thesize of a font is expressed as the height and width of the character cell assigned tothe font.

Terminology


Character Cell

CA-Easytrieve/Plus associates each Fixed Pitch font with a character cell. Thecharacter cell defines the area required to encompass the images of the charactersof a particular font. The following example illustrates that the height and widthof a character cell is not always the same as the height and width of the actualcharacter image. This is because the character cell includes any additional verticaland horizontal spacing required to encompass images of the font's characters.

An important reference line in any font definition is the baseline. The definitionof the baseline changes between extended reporting printers. The morecommonly accepted definition of a baseline is an imaginary line supporting thebottom of capitals.

In CA-Easytrieve/Plus, the baseline is an imaginary line supporting the bottomof character cells. The formatting of a print line containing a mixture of fonts isbased 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 verticaldistance 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 printedcharacter occupies. This means that the height of the font is the height (inH-units) of the character cell associated with the font.

Some printers are able to adjust the vertical position of a font. These printers canmove the base of the character cell up or down a number of H-units from thebaseline. You can incorporate this adjustment into the printer control codesassociated with a CA-Easytrieve/Plus font. CA-Easytrieve/Plus supports thedefinition of an adjust vertical position font, but you must make the appropriateadjustment to the height to compensate for the font's movement.

Terminology


Upward Adjustment

For upward adjustment, the height of the font must include the adjustmentamount. That is, the height of the font is equal to the height of the character cellplus the amount of vertical adjustment. Therefore, an upward adjustment is likeextending 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 toinclude the upward adjustment.

For example, assume that a font normally prints with a height of 12 points. If youdefined this font to CA-Easytrieve/Plus so that the printer performed an upwardadjustment of 4 points, you need to define the height of the font as 16. You definethe height of the font on the FONT command. See Chapter 4 for information onthe FONT command.

Downward Adjustment

For downward vertical adjustment, the bottom of the character cell is actuallypositioned below the baseline. To support this adjustment, you must calculate theheight of the font as the character cell's height minus the vertical adjustment. Thisdefines the correct height that CA-Easytrieve/Plus requires. It is then yourresponsibility to ensure that the next baseline is vertically displaced a sufficientamount to permit room for the portions of characters that CA-Easytrieve/Plusprints below the current baseline.

For example, assume that a font normally prints with a height of 12 points. If youdefine this font to CA-Easytrieve/Plus in such a manner that the printerperforms a downward adjustment of 4 points, then you have to define the heightof the font as 8. You define the height of the font on the FONT command. SeeChapter 4 for information on the FONT command.

Width

A font's width is the amount of horizontal space (in W-units) that a printedcharacter occupies. This means that the width of the font (in W-units) is the widthof the character cell associated with the font. The Extended Reporting Facilitysupports only fixed pitched fonts in which all of a font's character patternsoccupy the same horizontal or lateral space. Some printers support specialhorizontal adjustment functions that you can use to expand the horizontal size ofa character or squeeze the character. If you select either of these options, thewidth of the font that these function codes identify must incorporate thehorizontal adjustment factors.

For example, assume that a font normally prints with a width of 12 points. If youdefine this font to CA-Easytrieve/Plus in such a manner that the printerperforms an expansion of 4 points, then you have to define the width of the fontas 16. You define the width of the font on the FONT command. See Chapter 4 forinformation on the FONT command.

Terminology


CA-Easytrieve/Plus Reporting Characteristics

CA-Easytrieve/Plus provides a non-procedural language for defining the sets oflines that form a report. The language consists of the TITLE, LINE, and DISPLAYstatements. Each statement specifies the items that are to appear on the report.CA-Easytrieve/Plus must then process these items and automatically determinethe 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.

DETAIL LINE STATEMENT HEADING

SUMMARY

CA-Easytrieve/Plus uses the resultant layout to determine the correct set of printlines that produce the report. The set of print lines include title lines, headinglines, detail lines, and summary lines. The previous example illustratesCA-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 thereport requires the generation of multiple print records that are combined by theextended reporting printer to form a print line. As the following exampleillustrates, to process the initial statement, CA-Easytrieve/Plus must create twodetail 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 togenerate these print lines on the appropriate extended reporting printer. Thefollowing example illustrates CA-Easytrieve/Plus determining the format of theprint records.

{PRINT RECORD DETAIL (2) { {PRINT RECORD

{PRINT RECORD { {PRINT RECORD LINE { STATEMENT HEADING (4) {PRINT RECORD { {PRINT RECORD

{PRINT RECORD SUMMARY (2) { {PRINT RECORD

Terminology


The following chart illustrates the relationships between these variouscomponents and the structure of print records that the Extended ReportingFacility supports.

Print Lines

In terms of CA-Easytrieve/Plus reporting, the statements that define printedoutput define that output as a series of print items (fields and literals) that are toappear on specific lines of a report. As a result, the CA-Easytrieve/Plus systemproduces printed output as a series of print lines.

Print Records

In terms of the CA-Easytrieve/Plus Extended Reporting Facility, a Print Recordis the base unit for a print output request. After CA-Easytrieve/Plus builds therecord, CA-Easytrieve/Plus outputs it to the print data set.

Terminology


Standard CA-Easytrieve/Plus reporting associates the production of one printline with the output of one print record. This is appropriate for non-extendedreporting printers.

With the Extended Reporting Facility, CA-Easytrieve/Plus no longer associatesthe production of one print line with the output of one print record. This isbecause some extended reporting printers do not permit you to mix print itemsfrom different fonts on the one print line. Multiple print records must be outputby CA-Easytrieve/Plus and the printer combines these records to form a singleprint 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

At the start of each print record is a control field that defines the required verticalmovement that occurs before printing the text that follows. If you are combiningmultiple print records to form a single print line, then the first print recordcontains 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 carriagecontrol.

Overprint Codes

This control field follows the PCC. Printers that output multiple print records toform a single print line use this control field. It indicates the characteristics of thefont(s) that this particular print record uses. Multiple print records destined forthe same print line use different Overprint Codes to output text using differentfonts.

Not all printers require Overprint Codes. Therefore, they only incorporate intoprint records when the assigned extended reporting printer requires them.

Overprint Codes are called TRC (Table Recognition Codes) on IBM printers thatsupport multiple fonts while running in Line Compatibility mode.

Printer Characteristics


Function Codes

Printers that require one print record to support the printing of multiple fonts onthe 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 theprinted page.

Function Codes consist of control information that instructs the printer how toprocess 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 acharacter, and underlining text. CA-Easytrieve/Plus processes Function Codesbefore data (Header Function Codes), or after data (Trailer Function Codes).CA-Easytrieve/Plus assigns Function Codes to a font that the ExtendedReporting Facility uses. When you use the font to which Function Codes areassigned, CA-Easytrieve/Plus combines the appropriate Function Codes with theitem in the print data.

Print Items

This term refers to the actual text or data that appears on the report. In terms ofCA-Easytrieve/Plus syntax, it is either a field or a literal.


This section discusses the printer characteristics that CA-Easytrieve/Plus uses togenerate 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 printrecords and how CA-Easytrieve/Plus combines different fonts onto the sameprint line.

2. Paper Control Code - identifies the method CA-Easytrieve/Plus uses tocontrol vertical positioning on a page.

3. File Type - defines the attributes of the print data set thatCA-Easytrieve/Plus creates as it outputs print records.



Printer Type

The printers that CA-Easytrieve/Plus supports use different techniques toidentify fonts and print items within a print record. The seven categories ofprinters that CA-Easytrieve/Plus supports are shown in the following diagram.



Page Printers

In contrast to Line Mode devices, which associate one print record with one printline, Page Printers are devices that process a Data Stream containing printercommands and print data. Page Printers use Structured Fields and providesupport for “All Points Addressable” printing. Print records contain structuredfields. Structured fields are self-identifying strings of bytes containing controlinformation, control information parameters, and a print item's data. Pageprinter'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 thecoordinates of the start of the item. These coordinates consist of a verticaldisplacement from the top of the page (Y-direction) and a horizontaldisplacement from the left side of a page (X-direction). At compile timeCA-Easytrieve/Plus assigns each print item its appropriate X-directioncoordinate based on the coding of the CA-Easytrieve/Plus program.CA-Easytrieve/Plus cannot determine the Y-direction coordinate until executiontime because the vertical displacement from the top of the page of a particularprint line is dependent upon the vertical space already occupied by print linesprinted before the current print line.

As a result, CA-Easytrieve/Plus determines the appropriate X-directioncoordinate at compile time and builds the appropriate print records leaving roomfor the insertion of the correct Y-direction coordinate during the execution of theuser program. To perform this function, CA-Easytrieve/Plus uses a set of printercontrol codes that normal line mode printers do not support. These control codesare:

Set Vertical Position

This is a control code that defines the Y-direction coordinate for the data thatfollows in the current print record. CA-Easytrieve/Plus supports two ways ofdefining this coordinate. The first is to establish the Y-direction coordinaterelative to the current Y-direction coordinate. This means thatCA-Easytrieve/Plus must merge the control code with a value in H-units thatspecifies the distance that the new line is to be positioned relative to the currentY-direction coordinate. The second method of establishing the Y-directioncoordinate is by setting an absolute Y-direction coordinate. In this caseCA-Easytrieve/Plus merges the control code with the new Y-direction addresson the page (in H-units) and adds this value to the print record prior toperforming any horizontal (X-direction) positioning.



Set Horizontal Position

This is a control code that defines the X-direction coordinate for the data thatimmediately follows in the print record. This code precedes the data for eachprint item. Like the Set Vertical Position, the X-direction coordinate can bedefined as either a relative offset from the current coordinate, or as an absoluteaddress on the current line. In either case, the control code nullifies the need forblank spacing between print items. Line mode printers use this blank spacing toposition one item to the right of another print item on a print line. This is nolonger required as each item can be uniquely assigned its print positionindependent of any other print item.

Function Codes

These are additional, printer specific codes that can be added to the print recordsto 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'sheight, width, style, shape, data format (EBCDIC or DBCS), and so on.CA-Easytrieve/Plus inserts these codes into print records after the Set HorizontalPosition 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 printitem's font is different from that of the current print item. Where the fonts are thesame, CA-Easytrieve/Plus does not insert the Function Trailer code and theFunction Header code (for the next print item).



The following example illustrates the construction of print records for PagePrinters.

-----------------------------------------------------| 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 andcontrol information particular to a line. Line Mode printers restrict control ofmapping print items to a page permitting only the positioning of items along thecurrent line. At the start of each print record carriage control codes control thevertical position on a page.

Line printers can be further divided into six more finite classifications based ontheir ability to support Overprint and Function codes in the print record.



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/Plusmust build multiple print records. However, a print item is only output on theprint record whose Overprint Code matches the Overprint Code of that printitem's font. Line spacing occurs prior to the first print record. Each additionalprint record overprints the first. The printer then merges all these print records toform one print line. CA-Easytrieve/Plus uses two methods of merging printrecords depending on the extended reporting printer's characteristics. The twomethods are Merge Overprint and Print Overprint. The following topics discussboth of these overprint methods.

The overprint feature is a function of the printer hardware. For both overprinttechniques, CA-Easytrieve/Plus generates multiple print records containing therequired data and printer control codes. However, the layout of the data in theprint records that CA-Easytrieve/Plus produces for each overprint techniquemust 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 builtfor printers that support Overprint Codes.



Function Codes

Printers that support both control and print data in the same print record useFunction Codes. Printer manufacturers assign the control information specialvalues (function codes) that identify it from the normal print data. The printerdoes not print function codes on the report but uses them to define the functionthat is to be performed. A function code defines the format of the data (EBCDICor DBCS), the size of the characters, and so on. The following example illustratesthe 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 bothOverprint and Function Codes in the same print record. These printers use theOverprint 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 fromanother, that is, to distinguish EBCDIC from DBCS.

Because these printers support an Overprint Code, the printer combines multipleprint records to form a single print line when CA-Easytrieve/Plus requires amixture of fonts on one line. As has already been mentioned, there are twotechniques applicable to combining multiple print records: Merge Overprint andPrint Overprint. These same two techniques are also applicable to this category ofprinter. The following section compares the two overprinting techniques.



The following example illustrates the format of the print records built for thistype of printer:

Overprint Techniques

The two techniques that CA-Easytrieve/Plus supports for overprinting multipleprint records to form a single print line are Merge Overprint, and PrintOverprint. The printer hardware defines the technique that CA-Easytrieve/Plususes. CA-Easytrieve/Plus automatically compensates for the characteristics of theappropriate technique that the extended reporting printer uses.

The first overprint technique, Merge Overprint, merges the print records bycharacter position in the print record. The second technique, Print Overprint,combines the print records by their physical position in the final print line. Theresults of the Print Overprint technique are similar to those obtained whenoverprinting on an impact line printer.

Merge Overprint

When merging multiple print records into a single print line, the merge processcombines the data on a character by character basis. The 12th character in a printrecord, for example, merges with the 12th character in another print record. Thishappens regardless of where those characters might otherwise appear (as a resultof differences in character width) on the print line. The rules that the printer usesto merge print records (of the same or different font widths) into one print lineare:

� A printable character in a following record replaces an identical character ora blank.

� A blank in a following record does not replace either a blank or a printablecharacter.

� A printable character trying to replace a previous printable characterdifferent from itself results in a data check, and the character in the newrecord does not replace the character in the previous record.



� When merging blanks of different W-units, the resulting blank has theW-unit of the first one.

� When a printable character is merged with a blank, the resulting characterhas the W-units of the printable character.

To illustrate this process, assume that three print records are being merged andthe W-units are in points. The first record contains 7-point characters, the secondcontains 12-point characters, and the third contains 9-point characters. Each printrecord contains four characters (three blanks and one printable character in eachcase). The following example illustrates the three print records and the resultingprint line.



Print Overprint

The Print Overprint technique overprints print records the same as does a normalimpact line printer. The printer develops the image (or images) each print recordindependent of any other print record for the same line. It is the imaged orphysical lines that are combined. With this technique you can have one characterfrom one print record overlay another character because the physical images ofthe two records occupy the same position on the line.

To illustrate this technique, the same three records that demonstrate the Mergeprocess are used. That is, 7, 12, and 9-point print records.

As the following example demonstrates, the independent imaging of the threerecords results in an overlap of character boundaries. For example, the characterfrom the first record is overprinted by the character on the second imaged recordbecause they occupy the same physical space on the print line.



In addition, there is a 3-point gap between the character on the third imagedrecord 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 necessaryspacing to separate the characters in the different print records. Each print recordmust provide sufficient spacing characters so that when the record is imaged, thecharacters on the physical lines do not overlay each other. CA-Easytrieve/Plusautomatically compensates for this characteristic.



The next example uses the same 7, 12, and 9-point print records to illustrate theformat of the print records that do not cause overlaying of characters. In this casethough, the print records have been built compensating for the attributes of thePrint 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 infront of the character, thus positioning the character to the right of the secondcharacter. Not only must CA-Easytrieve/Plus take this additional spacing intoaccount when building the print records, but it also must compensate for thegaps 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-pointcharacter.





Supported Printers

Based on the set of characteristics that the Extended Reporting Facility supports,the following table illustrates the various printing systems thatCA-Easytrieve/Plus can support. This list is not restrictive as printers that fit intoone of the seven categories defined previously can still be supported through theextended reporting options module. See the discussion on the generation of theoptions module in Chapter 4.



Paper Control Codes - Carriage Control

The printers that CA-Easytrieve/Plus supports use different techniques tocontrol the vertical position on a page. The majority of the printers support theANSI carriage control and provide support for a Forms Control Block to enablethe definition of line spacing. In addition to the ANSI system, the ExtendedReporting Facility supports four other techniques.

The following chart illustrates each of the techniques that CA-Easytrieve/Plususes to control the vertical position on a page. This document explains eachtechnique before discussing the technique that each printer supports.



Page Printers

Page Printers use Structured fields to provide support for “All PointsAddressable” printing. Page Printers do not support carriage control like anormal line printer because Page Printers perform positioning on a page by pagebasis. The three basic record types that “All Points Addressable” printers requireare: 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 pagerecord contains information that establishes the base coordinates for a page, thefonts used on the page, any overlays required, and so on. For the IBM 3800Advanced Function Printing System, the majority of this information is definedin elements termed FORMDEFs and PAGEDEFs. You can use these elements forreports that the CA-Easytrieve/Plus Extended Reporting Facility produces butIBM-supplied software defines and maintains them, not CA-Easytrieve/Plus.

These records are output whenever a report requires a request for a new page.



End Page

End Page records define the end of a page. These records follow the Format Pagerecords to delimit the end of a page. They are output when the current reportrequires a request for a new page, except of course before the first page of thereport.

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 aprint 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. Duringcompilation, CA-Easytrieve/Plus determines the horizontal position, as wasdiscussed previously under Page Printers. During the execution of the user'sprogram, CA-Easytrieve/Plus determines the vertical position for a print line. Atthis time CA-Easytrieve/Plus can map each print line to the appropriate verticalposition on the current page based on the print records that have printedprevious to this print record. CA-Easytrieve/Plus then uses this current positionto determine the vertical coordinate for the new line. CA-Easytrieve/Plus thenmerges this coordinate with the Set Vertical Position code (discussed under PagePrinters) and adds the coordinate to the front of the current print record beforebeing output to the print data set.

CA-Easytrieve/Plus maintains the current position on a page by using theH-units of fonts used on print lines. Through the following processCA-Easytrieve/Plus determines the amount of vertical space to assign to eachprint line:

1. Determine the largest H-unit from all the H-units of the fonts used on a printline.

2. Using the default H-unit defined in the extended reporting options moduleas 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. Thisgives the amount of vertical space to assign to this print line. The Base Heightis defined by the DEFAULT-SIZE keyword of the PRINTER command usedto define a printer in the extended reporting options module. Chapter 5explains 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 BaseHeight setting in the extended reporting options module.



The skipping of blank lines is in multiples of the defined Base Height setting forthe extended reporting printer. This means that a request to skip 1 (one blankline) and then print a line containing 8-point characters where the Base Heightsetting defines 9-point lines (8 Lines per Inch), results in the baseline for the newline 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 verticalpositioning to be performed before printing a print record. CA-Easytrieve/Pluspositions the Paper Control Code at the start of each print record. The ExtendedReporting 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 reportingprinter supports a Forms Control Block and that print records can use ANSICarriage Control Codes for paper control. When using an FCB, values in the FCBdefine the line spacing that the printer is to use. A print record then provides theappropriate ANSI code for skipping the appropriate number of lines. The printerdetermines the vertical spacing from the line sizes defined in the FCB.

From the CA-Easytrieve/Plus point of view, control over the paper is restrictedto the ANSI codes. The values set in the FCB dictate the amount of space skippedfor any one line. The FCB parameter on the OS/390 JCL DD or OUTPUTstatement for the report data set specifies the FCB that any CA-Easytrieve/Plusextended 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 plusFCB printer by incrementing the line counter by the number of lines skipped fora particular print record. Therefore, the line counter indicates the number of linesprocessed on the current page. This value does not indicate the vertical spacingin H-units. You could obtain this value by multiplying the value of the linecounter by the H-units for each printed line defined in the FCB.



Machine Carriage Control Codes Plus a Forms Control Block

CA-Easytrieve/Plus processes this form of line mode Carriage Control exactlylike ANSI codes except that the value of the Carriage Control codes are theMachine 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 uponthe height of the tallest font in the current line and the height of the tallest font inthe previous line. The larger of these two values is the amount of vertical spacethat is allocated to the current line.

In other words, the height of the current line is determined by the height of thetallest font in use in the previous line except when the height of the tallest font onthe current line is greater. In this situation, the height of the tallest font in use onthe current line defines the height of the current line. Therefore, if printing fontsof different heights on the same report, the height of each line on the reportvaries. 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 controlcharacters but it outputs all line skipping using the font that defines the printer'sdefault height (see the DEFAULT-SIZE KEYWORD of the PRINTER command inthe “Extended Reporting Facilities Installation” chapter for more details). Thismeans that all blank lines print at the default height of the extended reportingprinter.

In addition, to ensure that the first line on any new page has the samedisplacement from the top of the form, CA-Easytrieve/Plus prints a blank line asthe last record prior to the top of form print record. This print record uses thefont that defines the printer's default height.

CA-Easytrieve/Plus maintains the line counter for a report on this type of printerby maintaining the vertical positioning as a count of H-units. CA-Easytrieve/Plusdetermines the value of the line counter by performing the following calculation:

(Total number of H-units printed)

----------------------------------

(Base height value assigned tothis extended reporting printer)

CA-Easytrieve/Plus always rounds this value up to give the maximumdisplacement down a page.



Point Skip Vertical Spacing Control

If the printer does not support the ANSI Carriage Control then to spacevertically, the printer uses a special Function Code that instructs the printer tostart a new line. The largest H-unit of the fonts defined to appear on the newprint line determines the spacing between the baseline of the current line and thebaseline of the new line. The new line request can include vertical spacing inaddition to the vertical spacing generated by the new line request. This functionis 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 reportingprinter, CA-Easytrieve/Plus rounds the H-unit of the tallest font up to amultiple of this Base Height. This gives the amount of vertical space assignedto this print line. The value that the largest font H-unit was adjusted up is thevalue of the Point skip operation. That is, all the print lines occupy a verticalspace 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 forthis line. Therefore, CA-Easytrieve/Plus maintains the line counter as amultiple of the Base Height setting in the extended reporting optionsmodule.



The skipping of blank lines is in multiples of the defined Base Height for theextended reporting printer. This means that a request to skip 1 and then print aline containing 8-point characters where the Base Height is set to 9-point lines (8Lines per Inch), results in a point skip of 10 points (9 points for the blank line and1-point for the adjustment to the print line to round it up to a multiple of the BaseHeight).

File Type

CA-Easytrieve/Plus outputs reports to data sets. CA-Easytrieve/Plus is notconcerned with whether the data sets are be under the control of a spoolingsystem, like JES and POWER, or whether the data sets are normal disk and/ortape files not controlled by a spooling system. A data set thatCA-Easytrieve/Plus builds as a result of printing operations using the ExtendedReporting Facility must contain the records in a format that the extendedreporting printer supports. The format of this data set varies depending upon theprinter you are using.



Record Format - Page Printers

The next chart illustrates a print data set for a Page Printer. The print data setincorporates five record types:

File Header Records

File Header Records are defined in the extended reporting options module. FileHeader Records output control information necessary to initiate the printer forthe print records that follow. CA-Easytrieve/Plus outputs these records to theprint data set immediately after opening the file but before outputting any printrecords.

Start Page Record(s)

A Start Page record tells the printer to build a new logical page. A Start Pagerecord contains information that establishes the base coordinates for a page, thefonts used on the page, any overlays required, and so on. For the IBM 3800Advanced Function Printing System, the majority of this information is definedin elements termed FORMDEFs and PAGEDEFs. You can use these elements forreports that the CA-Easytrieve/Plus Extended Reporting Facility produces butIBM supplied software defines and maintains them -- not CA-Easytrieve/Plus.

These records are output whenever a report requires a request for a new page.



End Page Record(s)

End Page records define the end of a page. These records follow the Format Pagerecords to delimit the end of a page. They are output when the current reportrequires a request for a new page, except of course before the first page of thereport.

Format Page

Format Page records contain a mixture of printer control codes and data(structured fields). Format page records contain the information required toselect a font for a print item and then position the data for a print item on thecurrent page. Format Page records can contain up to five components:

Format Record Header

This component defines a string of control information that CA-Easytrieve/Plusadds 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 inthe extended reporting options module. Otherwise, CA-Easytrieve/Plus does notadd anything to the print record.

Set Vertical Position

The Extended Reporting Facility uses this control code to establish theY-direction coordinate for the print items that follow. CA-Easytrieve/Plusmerges the control code with value that defines either an incremental offset forthe new line relative to the current position, or an absolute Y-directioncoordinate.

Function Codes

If a printer requires special control codes in the print record to identify differentfonts and data types, then in the print record CA-Easytrieve/Plus mixes FunctionCodes with Print Items. For those printers that do not require such controlinformation the Function Codes are not present.

Set Horizontal Position

This control code defines the X-direction coordinate along the current baseline (asestablished by the last Set Vertical Position code). By combining these twocoordinates, CA-Easytrieve/Plus establishes an absolute address on the currentpage for the print items that follow. CA-Easytrieve/Plus merges the control codewith a value that defines either an incremental offset for the new item relative tothe current position on the current line, or an absolute Y-direction coordinate.



Print Items

This component includes the fields and literals that contain the data for the finalprint line.

The maximum length of a Format Page record is the maximum record length ofthe print data set that receives the record. Should a record exceed that size, aruntime error results. This error stops the execution of the program and results inthe printing of an error message.

File Trailer Records

File Trailer Records are similar to the File Header Records. The extendedreporting options module defines File Trailer Records. Each File Trailer Record isa logical record on the print data set. CA-Easytrieve/Plus outputs these recordsto 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. Thefollowing chart illustrates these records:

File Header Records

File Header Records are defined in the extended reporting options module. FileHeader Records output information necessary to initiate the printer for the printrecords that follow. CA-Easytrieve/Plus outputs the file header recordsimmediately after opening the file but before outputting any print records.



Print Records

Print data sets consist mainly of print records. Each print record that theExtended Reporting Facility builds can contain up to four components, whichare:

Carriage Control

The Carriage Control code always starts the record.

Overprint Code

The Overprint Code is only required for printers that use multiple print recordsto support mixed fonts on one print line. If required, this code always follows theCarriage Control code.

Function Codes

If a printer requires special control codes in the print record to identify differentfonts and data types, then CA-Easytrieve/Plus mixes Function Codes with PrintItems in the print record. Function Codes are not present for printers that do notrequire 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 itemswith Function Codes in the print record. If the printer does not require FunctionCodes, the print record only contains Print Items.

The maximum length of a print record is the maximum record length of the printdata set that receives the record. Should a print record exceed that size, a runtimeerror results. This error stops the execution of the program and results in theprinting of an error message.

File Trailer Records

File Trailer Records are similar to the File Header Records. File Trailer Recordscontain control information and are defined in the extended reporting optionsmodule. 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 lastprint record but immediately before closing the file.



File Format

The format of a print data set defines the relationship between print records thatCA-Easytrieve/Plus builds and the physical records CA-Easytrieve/Plus outputsto the data set. The three formats for a print data set that the Extended ReportingFacility supports are: Unblocked Records, Blocked Records, and ConcatenatedRecords. 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 theminimum required to contain the components required to produce the print line.For print data sets that support variable length records, the length of the printrecord remains the same. For files requiring fixed length records,CA-Easytrieve/Plus must pad the print record to fit into the defined recordlength. The padding operation uses two attributes of the extended reportingprinter that you must identify in the extended reporting options module. ARecord-End string defines the control character(s) that delimits the print record.The Report-Pad string defines the character(s) that begin immediately after theRecord-End and continues to the end of the record.



Unblocked Records

This file type is very similar to the Blocked records format except that eachlogical record is also a physical record.

CA-Easytrieve/Plus builds variable length print records. Their size is theminimum 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 originalprint record.

� For fixed length record print data sets, CA-Easytrieve/Plus must pad theprint record to fit into the defined record length. The padding operation usestwo attributes of the extended reporting printer that you must identify in theextended reporting options module.

A Record-End string defines the control character(s) that delimits the printrecord. The Report-Pad string defines the character(s) that begin immediatelyafter 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 datastream of print records. Each time CA-Easytrieve/Plus outputs a print line, itconcatenates the associated print records onto the end of the file's currentphysical record. CA-Easytrieve/Plus outputs the physical record only when aprint record does not fit into the remainder of the file's physical record area. Thisprocess is similar to the building of a block consisting of variable length recordsexcept 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 printdata set, a runtime error occurs.

For file types using Variable and Undefined record formats, the length of theoutput record equals the total of all the concatenated print records that fit into themaximum physical record.

To support the Fixed length physical record (that is “F lrecl”) with theconcatenation option, the extended reporting options module must identify aRecord-End and a Record-Pad string. Because CA-Easytrieve/Plus generatesprint records that are variable in length, there is no guarantee that each blockterminates at the end of the fixed length physical record. Therefore, to fill out ablock, CA-Easytrieve/Plus inserts a Record-End string immediately after the lastprint record. CA-Easytrieve/Plus adds the pad string to the end of the physicalrecord starting immediately after the Record-End string.



This file format requires separate consideration with respect to Structured Fieldprinters and Line Mode printers.

Concatenated Records - Structured Fields

For “All Points Addressable” printers, the concatenation process is onlyapplicable to Format Page Records. The other four types of records required bythis type of printer are output in separate blocks. The following chart illustratesthis characteristic.



Concatenated Records - Line Mode

For Line Mode printers CA-Easytrieve/Plus concatenates output records exceptfor File Trailer Records. For Concatenated Records, the File Trailer Records areoutput 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 anew physical record. This new record, once built and output, is the last one onthe print data set.

The following chart illustrates this relationship for Line Mode print data setsrequiring Concatenated Records:

Font Characteristics



In addition to defining the characteristics of the extended reporting printers, youalso must define the fonts that CA-Easytrieve/Plus can use in a print line. Interms of this discussion, a font is a collection of graphic characters of a giventypeface and size. You must define fonts in the extended reporting optionsmodule. Fonts are associated with an extended reporting printer and each one isgiven a unique font identifier number (1 to 256).

It is the font identifier that you code in a CA-Easytrieve/Plus program toassociate 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 theitem 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. ForCA-Easytrieve/Plus, this data type includes the field types of Alphabetic,Packed, Zoned Numeric, Unsigned Packed, and Binary, plus numeric andquoted EBCDIC literals.

2. The DBCS (Double Byte Character Set) data type consists of those charactersdefined using two bytes. This data type represents non-phonetic languagessuch as Japanese. This data type supports the DBCS field type, plus the DBCSand Conversion literals.

3. The MIXED data type is for fields containing a combination of EBCDIC andDBCS data types. Special Shift Codes identify one data type from the other.This data type supports MIXED fields and MIXED format literals.



You can define a font to support any one of the above data types. For EBCDICand DBCS data types, the definition of the font must include all thecharacteristics 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 portionof the MIXED field and the font that CA-Easytrieve/Plus uses to process theDBCS portion of the field.

When using a font, the data type of the field or literal to which the font has beenassigned must match the data type that the font supports. If this is not the case, asyntax error results.

Height and Width

For each font that the extended reporting options module defines, you mustdefine the width of the font as a number expressed in terms of the selectedW-units. CA-Easytrieve/Plus only requires the definition of the height of a fontwhen the Carriage Control system of the extended reporting printer does notsupport the ANSI or Machine systems in association with a Forms Control Block(FCB). When CA-Easytrieve/Plus requires the height definition, you must defineit as a number expressed in terms of the selected H-units.

Overprint Code

If the extended reporting printer supports Overprint Codes, all of the fontsassociated with that printer must include the Overprint Code. The FONTcommand defines the overprint code. Chapter 4 discusses the FONT command indetail.

Function Header and Function Trailer

If the extended reporting printer supports Function Codes, you must specifyeither the Function Header, the Function Trailer, or both. You specify theseattributes by using the FONT command. Chapter 4 discusses the FONTcommand in detail.

Space Replacement

For printers that support Overprint Codes and use the Merge Overprinttechnique to combine print records, the space character (X'40') is important. Thisincludes the occurrences of the EBCDIC space or the occurrences of the IBMDBCS code system space (X'4040'). From the point of view of certain printers,there is no difference between them.



The reason that the space is important is best demonstrated by an example. In thefollowing example, a DISPLAY statement builds a print line containing threeliterals. The first and third literals are to be output as 7-point characters and thesecond is to be output at 9-point. Assuming the printer supports Overprint Codesand uses the Merge Overprint technique, CA-Easytrieve/Plus builds two printrecords. The following example also demonstrates these records and the resultantprint line.

Note: Spaces in the first print record are replaced by non-blank characters in thesecond. Also, that a space in all the print records prints a space whose size is thatdefined by the font of the first print record.



CA-Easytrieve/Plus automatically compensates for space replacement when itassigns fields to print positions on a print line and when it determines thespacing between print items. However, CA-Easytrieve/Plus cannot directlycontrol the occurrence of spaces in the fields or literals that it moves into printrecords. CA-Easytrieve/Plus assumes that each character in a print item is outputat the same size; that size being defined by the width of the print item's assignedfont. CA-Easytrieve/Plus prints the size of space characters in an overprintrecord as the size of the space in the first record. The following example displaysthis.



The previous example illustrates that a space in the second literal results in thecharacter being positioned on the print line using the 7-point space (as opposedto the 9 point space that was requested for the print item). The result of thisprocess is demonstrated by comparing the print line produced by this examplewith the next example.

The previous example illustrates that the size of the second character in thesecond literal coded on the DISPLAY statement now prints at 9 point (as opposedto 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-blankcharacter) cause the characters that follow the space character to shift left 2 pointson the print line. This is not an error but a feature of the printer.CA-Easytrieve/Plus cannot prevent this from occurring.



CA-Easytrieve/Plus compensates for spaces between print items, but does notcompensate for spaces occurring within a print item. There are three approachesthat you can use to solve this problem.

� Ensure that the fonts being mixed on one print line all have the same W-unitwidth.

� Ensure that any field or literal that occurs on a print record other than thefirst does not contain spaces.

� Define an alternative space within each font set that CA-Easytrieve/Plususes. Nothing prohibits you from modifying a font set to replace one of theunused graphic characters with a space character. Once this replacementspace has been assigned to a font defined in the extended reporting optionsmodule, CA-Easytrieve/Plus automatically scans the contents of each field orliteral that uses this font. The scan occurs after CA-Easytrieve/Plus movesthe field or literal to the print record. The scan replaces all occurrences of thenormal space character with the replacement space. This ensures correctspacing on the report.

For printing DBCS data using the IBM DBCS code system, an alternativeDBCS space is already provided. CA-Easytrieve/Plus associates thischaracter (X'4242') with every DBCS font defined in the extended reportingoptions module for IBM printers that use the Merge Overprint technique.CA-Easytrieve/Plus then scans each DBCS field or literal and replaces thenormal DBCS space X'4040' with this alternative space.

Double Byte Alignment

Some printers that support Function Codes require Function Codes to occur onDouble Byte boundaries within Print Records. The only components of a PrintRecord that this alignment problem affects are EBCDIC print items. For printersthat require double byte alignment, DBCS data and the function codes are all twobytes in width. It is only those EBCDIC print items (fields and literals) whoselength 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. Thewidth of the additional character is not taken into account when the printerpositions 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 thepositioning of the print item on the print line. Where possible,CA-Easytrieve/Plus incorporates this space increase into the space following theprint item on the print line. If no spacing follows this item, the net affect ofdouble alignment is to increase the size of the field or literal by one.



Line Complexes

A special printing feature of some extended reporting printers is the ability todefine Line Complexes. For example, the IBM 3200 and the HITACHI 8196support the ability to expand a print item across multiple lines (2 or 4). Thismeans that the print items height is multiplied by the number of lines that theprint item includes but its width remains the same. The best way to describe aLine Complex is by a diagram.

As shown in the following example, a print item involved in a line complex mustbe included in all of the print records that generate the print lines that the LineComplex covers. For a two-line Line Complex, the print item must be includedin the two print records that are combined to form the line complex. Forfour-line complexes, the print item must be included in four print records.



A font defined for an extended reporting printer that supports Line Complexescan include the Line Complex attribute. CA-Easytrieve/Plus then positions theprint item assigned to such a font on the appropriate number of print lines. It isup to you to ensure that no other print items are positioned in the same area ofthose print lines that a Line Complex element occupies. If this occurs, a syntaxerror results.

Report Layout Processing



You request printed output from a CA-Easytrieve/Plus program by using eitherthe TITLE, LINE or DISPLAY statements. CA-Easytrieve/Plus then interprets theappropriate statement(s) and based on a set of user modifiable parameters(SPACE, SKIP, LINESIZE, PAGESIZE, and so on), automatically formats theprint line(s). From this format, CA-Easytrieve/Plus builds the print records thatproduce the correct lines.

The Extended Reporting Facility does not change this process.CA-Easytrieve/Plus still automatically formats the print line(s) and builds theprint records. The impact of the Extended Reporting Facility concerns theprocessing that CA-Easytrieve/Plus must perform to format a report. BecauseCA-Easytrieve/Plus now supports multiple fonts and extended reportingprinters, CA-Easytrieve/Plus can no longer rely on the same formattingalgorithm that supported line printers.

The CA-Easytrieve/Plus process to format a print line still supports all thestandard line printer report generation options, but a number of considerationsinfluence the format of the resultant print line. This section discusses theseconsiderations. Reading this section ensures that you can analyze and explain theresults that you obtain by using an extended reporting printer, when they differfrom 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 printline using three rules:

1. LINE 01 items and their associated headings are centered in an area whoselength is controlled by the longer of the following:

a. The line item entry. This item is expanded by the value of SUMSPACE ifthe 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) ispositioned under the first item of LINE 01. The data is left-justified under theLINE 01 data regardless of the heading size.



3. Blank characters (spaces) separate all line items according to the value of theSPACE parameter of the REPORT statement. In addition, the number ofspaces can be altered by the +/- spacing options plus the effect of theSPREAD operation.

The Extended Reporting Facility changes this process in one way.CA-Easytrieve/Plus must calculate the length of each of the elements associatedwith 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/Plusreport when the print item has heading and detail elements that use fonts ofdifferent width. This situation impacts the process CA-Easytrieve/Plus uses todetermine the appropriate window for the print item. When you are using fontsof 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 windowincludes any adjustments necessary to ensure that all the elements of the item fitwithin the window after each element has been positioned on its applicable printrecord. This means that the window can be larger than CA-Easytrieve/Plusoriginally determined.

The next five examples illustrate the effect of mixing fonts of different sizes in areport.

The following example illustrates CA-Easytrieve/Plus syntax that uses multiplefonts.

CA-Easytrieve/Plus Syntax:

DEFINE TEST-FIELD-1 1 8 A + HEADING (#1 'THE FIRST LINE' 'THE SECOND LINE') DEFINE TEST-FIELD-2 9 10 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 #2 7.2



To create a print line, CA-Easytrieve/Plus must analyze the heading lines andthe detail lines (the contents of TEST-FIELD-1 and TEST-FIELD-2) taking intoaccount the size of the fonts. CA-Easytrieve/Plus then calculates a window thatis large enough to encompass each of the elements of the print item that is to beoutput to the print line. The following example illustrates the windows thatCA-Easytrieve/Plus creates using the syntax in the CA-Easytrieve/Plus Syntaxexample.



After calculating the windows, CA-Easytrieve/Plus determines the format ofeach of the print lines. To do this, CA-Easytrieve/Plus must center each printelement within its own window and then determine the correct amount of spacebetween those elements that occur on the same print line. This step is illustratedin the following example.

As is shown above, there are four gaps that must be filled with spaces byCA-Easytrieve/Plus. CA-Easytrieve/Plus attempts to fill each gap using acombination of the fonts assigned to print items on the originalCA-Easytrieve/Plus statement.



In this example, not only does CA-Easytrieve/Plus use the default font (size of 10points), 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 thespacing factors that positions an element as close as possible to its assigned printposition. For the current example, the following example illustrates the resultsproduced by CA-Easytrieve/Plus.

As illustrated by the previous example, the first gap on Heading Line 1 was filledby 2 spaces using the 7.2-point font. This is as close to print position 14 as waspossible with the available fonts. For the gap on Heading Line 2, the insertion of3 spaces using the 10-point font filled the gap exactly. On the Detail Line, the firstgap was filled by 6 spaces using the 7.2-point font. The second gap to be filled onthe Detail Line was originally 95 points wide but because the first gap on thissame line actually increased, the second gap was reduced by 0.2 points (theincrease in the first gap). The resultant gap of 94.8 was then filled exactly byCA-Easytrieve/Plus using a combination of 9 spaces of 7.2 points in width and 3spaces of 10 points in width. Consequently, CA-Easytrieve/Plus was able toposition the second element on the Detail Line exactly at its assigned printposition.

As was illustrated by Heading Line 1 in the previous example, whenCA-Easytrieve/Plus cannot position an element at its assigned print position,CA-Easytrieve/Plus positions the element as close as possible to its assignedposition. If this movement of the element results in the element moving outsidethe item window for the element, the window expands and all the elements to bepositioned in that window are re-centered. The spacing between elements on thesame print line are then re-calculated.



When CA-Easytrieve/Plus expands the size of a window, CA-Easytrieve/Plusensures that a window does not overlap another window. This technique ensuresthat no two elements on the same print line ever overlap.

MIXED Field Printing

CA-Easytrieve/Plus supports EBCDIC, DBCS (Double Byte Character Set), andMIXED data types. MIXED data types contain both EBCDIC and DBCS data,with the Shift Codes identifying the DBCS data (EASYTRIEVE supports two shiftcode systems, see the DBCS Option User Manual for more details). BecauseMIXED fields contain DBCS data, you can only define them on print lines that areto be directed to extended reporting printers that support DBCS data.

The length of the MIXED field does not directly determine the size of the printitem on the print line. Normally, the number of bytes in an Alphabetic type fieldmultiplied by the print width of each character (in W-units) gives the size of thatprint item on the print line. CA-Easytrieve/Plus automatically performs thiscalculation during its compile phase and is thus able to position the field withinits appropriate window. For MIXED format fields, CA-Easytrieve/Plus cannotperform the same calculation. This is because:

� The support of a MIXED field requires the support of two fonts for the sameprint item. One for the EBCDIC data and a second for the DBCS data.

� CA-Easytrieve/Plus cannot determine the number of EBCDIC and DBCScharacters in the field at compile time. It must analyze the actual contents ofthe field during execution of your program to determine the actual mix ofEBCDIC and DBCS data.

As a result, CA-Easytrieve/Plus uses a special algorithm to analyze the length ofa MIXED field along with the size of the EBCDIC and DBCS fonts assigned tothat print item. This algorithm calculates two print widths for the field:

True Print Width

This W-units value defines the minimum print width of the MIXED field. Thisprint width is calculated so that any combination of EBCDIC and DBCS data inthe field plus the appropriate combination of EBCDIC and DBCS padding alwaysprints at the one True Print Width.

Base Print Width

This W-units value defines the maximum print width of the data in the MIXEDfield. From all the combinations of EBCDIC and DBCS data in the field, onecombination has the largest print width. CA-Easytrieve/Plus determines thiscombination and calculates the Base Print Width.



The Base Print Width is always less than or equal to the True Print width. Anydifference between these two values is always formatted as spaces byCA-Easytrieve/Plus. The additional spacing is added by CA-Easytrieve/Plus toensure that any combination of EBCDIC and DBCS data in the MIXED fieldprints at the one width - the True Print Width. By filling out the MIXED field tothe same length irrespective of the field's contents ensures that print items thatfollow the MIXED field on a print line always start at their assigned printposition.

For printers that support Structured Fields (All Points Addressable printers), theBase Print Width is always equal the True Print Width. The ability to position afield on the print line independent of any other field permits a MIXED field to beformatted at any print width. It does not disturb the positioning of other printitems on the same print line.

CA-Easytrieve/Plus always uses the True Print Width when allocating theMIXED field's window as this value represents the print space required to formatand print the field's contents. CA-Easytrieve/Plus only uses the Base Print Widthwhen the MIXED field is followed by another print item on the same print lineand the second print item is positioned some number of spaces to the right of theend of the MIXED field.

In this situation, CA-Easytrieve/Plus reduces the spacing between the two printitems 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 valuesis always spaces. This means that the MIXED field can be formatted correctly intoits True Print Width yet appear on the output as though only the Base Printwidth was allocated to the field. The print width of the MIXED field on the reportappears to be smaller than the True Print Width calculated byCA-Easytrieve/Plus.

To help illustrate this process, assume that a 50-byte MIXED field is to be printedfollowed by 3 DBCS spaces and then a 10-byte DBCS field. The EBCDIC font forthe MIXED field produces 6-point characters and the DBCS font for the MIXEDfield, the spacing and the DBCS field produces 9.6 point characters. For theMIXED field, CA-Easytrieve/Plus calculates the True Print Width as 324 pointswhile the Base Print Width is the print width of an all EBCDIC field or 300 points(50 characters at 6 points each).



The DBCS field prints at 48 points with 28.8 points of spacing between the twoprint items. The following example illustrates the results of positioning the DBCSfield to the right of the MIXED field and ignoring the Base Print Width.

Note: There is always spacing from print position 300 through to 352.8.

Now, examine the next example.

Note: The 28.8 points of spacing between the two print items has been reducedby 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 (inthe previous example), there is only 30 points (24 points being the differencebetween the True and Base Print Widths plus one EBCDIC space to get as closeas possible to the required gap of 28.8 points).

As demonstrated by the previous example, the apparent print width of theMIXED field is smaller than the print space required for the field. Not allsituations give the same results. If the spacing between the MIXED and DBCSfield is smaller than the difference between the True and Base Print Widths of theMIXED field, the actual spacing between the two fields increases. The True PrintWidth of the MIXED field must always be allocated so that CA-Easytrieve/Pluscan format the field correctly.



For example, assume that only two DBCS spaces are allocated between the twofields, that is, 19.2 points. The next example illustrates that the DBCS field ispositioned adjacent to the end of the MIXED field's True Print Width. This meansthat the spacing between the two items is actually 24 points, an increase over therequested 19.2 points. This spacing cannot be overcome. CA-Easytrieve/Plusmust have the True Print Width allocation on the print line so that it can correctlyformat 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 DBCSfields, yet the two fields are positioned adjacent to each other, can give resultsthat are at first not obvious.

For example, take the following CA-Easytrieve/Plus syntax:

DEFINE ADDRESS W 50 MDEFINE NAME W 10 K::::REPORT NOADJUST SPACE 2:LINE 1 ADDRESS NAMELINE 2 ADDRESS POS 2 -1 NAME



The result of formatting LINE 1 of the report, defined in the previous syntax, isthe same as that illustrated in the previous example. This assumes that thedefault 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 errorindicates that NAME overlapped a print item, namely the ADDRESS field. Thereason for the error is not obvious as there should be two DBCS spaces betweenthe two items on LINE 1, and the LINE 2 syntax specifies NAME to be positionedin only one of these spaces to the left of the position occupied by the second LINE1 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 theMIXED field's True Print Width. As a result, the DBCS field on LINE 1 starts atposition 324 on the print line. This is the “POS 2” value. WhenCA-Easytrieve/Plus reduces “POS 2” by the “-1” DBCS space, the start positionfor NAME on LINE 2 is 314.4. This print position is occupied by the ADDRESSfield 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 thefonts to be used by CA-Easytrieve/Plus when processing a MIXED field. Foreach MIXED font that you define, you must identify an EBCDIC and DBCS fontthat is to be used to format the respective data types of a MIXED field. Animportant factor that you must consider when selecting the EBCDIC and DBCSfonts are the print widths of these two fonts.

When CA-Easytrieve/Plus calculates the Base and True Print Widths of a MIXEDfield, the size of the MIXED field and the print widths of the assigned EBCDICand DBCS fonts are the chief inputs. The degree to which the True Print Widthexceeds the Base Print Width (and thus results in additional spacing to the rightof the MIXED field) is primarily dependent on the Lowest CommonDenominator of the print widths of the applicable EBCDIC and DBCS fonts.

A rule of thumb dictates that a Lowest Common Denominator, which is smallrelative to the print widths of the two fonts, denotes a smaller difference betweenthe 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 ofthe two fonts, there exists many other common denominators greater than theLowest Common Denominator. This means the algorithm that calculates the TruePrint Width has a greater possibility of calculating a True Print Width that is veryclose to the Base Print Width.

The next example shows the relationship between the print widths of the twofonts, their Lowest Common Denominator and the resultant True Print Width.



Note: The fonts at the top of the table produce better True Print Widths thanthose towards the bottom. In addition, the “worst case” situation is illustrated bythe EBCDIC 7-point font and the DBCS 7.2 font.

Because the Base Print Width of the 20-byte field does not exceed the LowestCommon Denominator of 252, the maximum True Print Width of 204.8 has beencalculated by CA-Easytrieve/Plus. The maximum True Print Width for anyMIXED field is calculated by summing the maximum number of EBCDICcharacters times the EBCDIC font size (20 * 7 = 140) and the maximum DBCScharacters times the DBCS font size (9 * 7.2 = 64.8). The maximum True PrintWidth occurs when the two font sizes do not have a relatively small LowestCommon Denominator and as a result, are a poor combination for MIXED fields.As the relationship improves (the Lowest Common Denominator becomesrelatively smaller), the True Print Width falls from the maximum True PrintWidth to the Base Print Width.

The best MIXED font combinations are those that result in the True Print Widthequaling the Base Print Width.

Also, the next example illustrates the impact of an EBCDIC font that requiresdouble byte alignment. Double byte alignment is a requirement of certainextended reporting printers. The alignment attribute means thatCA-Easytrieve/Plus, when calculating the True Print Width, must take intoaccount the addition of an EBCDIC space to any odd length EBCDIC subfield inthe MIXED field.

Automatically, CA-Easytrieve/Plus incorporates this attribute into the True PrintWidth calculation. The impact of this attribute is also related to the LowestCommon Denominator of the print widths of the assigned EBCDIC and DBCSfonts.



MIXED Field Support of Merge Overprint

The algorithm, which CA-Easytrieve/Plus automatically uses to determine thesize of a MIXED field, must use two fonts. One font is for the EBCDIC portion ofthe MIXED field, and the second font is for the DBCS portion. This algorithmmeans that some combinations of EBCDIC and DBCS data within a MIXED fielddo 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 withspaces. To determine the minimum window for the field while incorporating thepadding factor, CA-Easytrieve/Plus uses the size of the space characters ofEBCDIC and DBCS fonts assigned to that MIXED field.

This process generally does not present a problem as the majority of the printerssupport the printing of multi-sized EBCDIC and DBCS spaces. The printers thatdo not support function codes but support the Merge Overprint technique forcombining multiple print records on the same print line are the exception. Aspresented earlier, when examining the functions of the Space Replacementcharacter, merge processing ignores the fact that the character X'40' represents anEBCDIC space in one print record and represents part of a DBCS space in adifferent 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 aMIXED field can have different widths. If the space character is the same, the sizeof both spaces on output are the same. As a direct result of this, support ofMIXED fields on a print line directed to a printer supporting such an attribute isrestricted to those DBCS fonts assigned a Space Replacement character. If this isnot the case, CA-Easytrieve/Plus cannot support MIXED fields.

Print Item Positioning Considerations

The various characteristics of the numerous printers, which theCA-Easytrieve/Plus Extended Reporting Facility supports, has given rise to anumber of limitations with respect to item positioning on a print line that theExtended Reporting Facility cannot overcome. These limitations are primarilycaused by the techniques required by printers to build print records. This sectiondescribes each of these limitations in turn.

Overprint Gap

This output consideration was introduced by the discussion regarding the PrintOverprint technique for combining multiple print records on the one print line.The Overprint Gap results from the printer imaging each print recordindependent of other print records that can appear on the same line. Once theprinter images the records, the printer combines the records to form the print linethat is output to the page.



As a result of imaging each line separately (as opposed to the Merge Overprinttechnique which does not suffer from this limitation), the ability to position printitems of different fonts (thus different print records) adjacent to each other isrestricted. The following example illustrates the reasons.

Assume that three characters of different fonts must be printed adjacent to eachother. The first character is an output using a 9-point font, the second output usesa 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 afterthe Carriage Control. The following example illustrates these three records.

Note: The second print record cannot have the 12-point character in the firstbyte of the print record or it prints over the character output by the first printrecord. Therefore, CA-Easytrieve/Plus must insert one space byte into the12-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.



In doing this, the position of the 12-point character is not adjacent to the 9- pointcharacter. The 12-point space is 3 points too large but nothing can be done toovercome this -- it is the Overprint Gap.



The same process applies to the third character that is to print from a 7-pointprint 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-pointcharacter in the third print record. The correct amount of space is 24 points ofspaces as the 7-point character cannot print over the 12-point character that ispositioned 12 points from the start of the line (12 + 12 = 24).

For the 7-point print line though, 24 points of spacing is not possible using a 7point space. The closest CA-Easytrieve/Plus can come to this figure is 28 (four7-point spaces). As a result, there is a 4-point gap between the second and thirdcharacters. Again, another Overprint Gap.

CA-Easytrieve/Plus automatically calculates the correct positioning of printitems so they do not overlap, thereby incorporating this limitation into thepositioning of items on a report.

Item Placement Restrictions

CA-Easytrieve/Plus reporting provides a set of features that permit you tospecify the exact position where you want an item to appear on a print line. Theuse of the COL keywords on the DISPLAY, TITLE, and LINE statements, and thePOS keyword on the LINE and DISPLAY statements both provide this ability.

With the Extended Reporting Facility, getting the item precisely at the requestedCOL or POS position depends upon the use of multi-sized fonts within thereport.

� If you are using only one font, no problems arise.

� If you are using multiple fonts, it might not be possible to position the printitem exactly at the requested location.

All extended reporting printers except “All Points Addressable” printers sufferthis 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 Overprinttechnique of font combination on a line. Assume that CA-Easytrieve/Plus is toposition 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, theCOL value of 3 is interpreted as 2 X 12 points, thus 24 points from the start of theprint line. The characters though must print from a print record producing7-point characters.

As a result, the closest CA-Easytrieve/Plus can position the two characters totheir assigned location is 28 points (4 X 7 point spaces). CA-Easytrieve/Pluscannot solve the inability to position the characters on the 24th point.



CA-Easytrieve/Plus permits the effects of this limitation when it occurs bypositioning the print item as close as possible to the assigned location, but alwayson the right side of the location.

Extended Reporting Options Module 4–1

Chapter

4Extended Reporting OptionsModule

Introduction

The Extended Reporting Facility is installed during the CA-Easytrieve/Plusinstallation process. To activate this facility you must generate the extendedreporting options module to define the characteristics of the extended reportingprinter(s) that CA-Easytrieve/Plus uses. If your installation has an extendedreporting printer that this CA-Easytrieve/Plus feature supports, then read thischapter.

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 extendedreporting options module.

Note: You should read the previous chapter, “System Concepts,” beforegenerating this module.

Introduction


Installation Steps

The normal CA-Easytrieve/Plus installation includes all the componentsnecessary to support the Extended Reporting Facility. The only step that youmust complete before CA-Easytrieve/Plus can support an extended reportingprinter is to generate the extended reporting options module.

A program (EZTPX04), installed on the CA-Easytrieve/Plus executable libraryduring normal CA-Easytrieve/Plus installation, builds the extended reportingoptions module (EZTPXRPT). Use the following sample JCL to instruct EZTPX04to 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 thelibrary where CA-Easytrieve/Plus resides.

3. Change the data set name in the SYSLMOD DD statement to the name of thelibrary where the CA-Easytrieve/Plus extended reporting options moduleresides.

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 EXTENTstatements 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 toidentify a temporary file used to pass the output of EZTPX04 to the linkageeditor.

4. Change the cuu on the “hard” CLOSE and ASSGN statements for SYSPCHand SYSIPT to point back to the original addresses for SYSPCH and SYSIPT.

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 EXTENTstatements 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 toidentify a temporary file used to pass the output of EZTPX04 to the linkageeditor.

4. Change the cuu on the “hard” CLOSE and ASSGN statements for SYSPCHand SYSIPT to point back to the original addresses for SYSPCH and SYSIPT.

Linking the EZTPXRPT module into the CA-Easytrieve/Plus executable libraryactivates support for extended reporting printers. This is the only link requiredwhen 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.

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 thatCA-Easytrieve/Plus uses for producing its output. If you do not specify thiscommand then CA-Easytrieve/Plus uses the standard line printer format forproducing its output.

The PRINTER command defines the characteristics of an extended reportingprinter that CA-Easytrieve/Plus supports. You must code this command once foreach printer that you want CA-Easytrieve/Plus to support.

The FONT command defines fonts that the Extended Reporting Facility uses. Todefine multiple fonts for a printer you must specify multiple FONT commands.You must include at least one FONT command (default EBCDIC font) in thegeneration of the extended reporting options module except in the followingcases:

� 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 inthis 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 generationprogram ignores columns 73 through 80.

3. Start all XRPT commands with the command name.

4. Each operand is composed of a keyword and a value or values.



5. The value must immediately follow the keyword and be enclosed inparentheses. You must code at least one nonblank value within theparenthesis.

6. If you code multiple values within parentheses, you must separate eachvalue by one or more blanks.

7. Balance parentheses.

8. You must delimit the XRPT command from each operand by one or moretrailing 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 avalue, you must enclose the value in apostrophes. The maximum length of avalue enclosed in apostrophes is 256 bytes. Whenever a value contains anembedded apostrophe, you must code two apostrophes. For example, specifythe 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 thenext 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 theentire line. Use this type of line to code comments. You cannot continuecomments by using a hyphen. You cannot code comments betweencontinued 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 controlcodes 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 theextended reporting options module; and

� That code requires the merging of special control data.



Examples of control codes that fall into this category include:

� The value for Point Skip operations (requires the insertion of the number ofpoints to skip).

� Function Header codes that require the number of bytes of data that followthe code to be part of that code.

� Format Page headers (print record lengths and print record counts can beadded to this code).

� Set Vertical Position (requires either an offset from the current Y-directioncoordinate or the absolute address of the new Y-direction coordinate) and SetHorizontal Position (requires either an offset from the current X-directioncoordinate or the absolute address of the new X-direction coordinate).

See the individual commands later in this chapter for more details regarding theactual special code values.

To satisfy the above conditions, CA-Easytrieve/Plus provides special charactersthat you can specify as printer control codes. You must define the data for acontrol code that is fixed (that is not modified by CA-Easytrieve/Plus) as ahexadecimal value (consisting of the letters A - F and the numbers 0 - 9). WhereCA-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 foreach occurrence of a special control data subfield. These three characters definethe characteristics of the special control data. You must code them in the suppliedhexadecimal value such that they replace that portion of the control code that thespecial control data is to occupy.

The format of these three characters is:



Character 1

This character defines the format of the special control data thatCA-Easytrieve/Plus merges with the printer control code.

Code Description

# Marks the start of special control data. The special control data is abinary number.

& Marks the start of special control data. The special control data isUnsigned Packed Decimal number.

Character 2

This character defines the type of special control data that CA-Easytrieve/Plusmerges with the printer control code. You can use the following characters:

Code Description

S Indicates that the value to be added is a point skip amount. Use thiscode only when defining the point skip code for the PRINTERcommand.

R 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 printdata set prior to the record containing this code PLUS 1.

B Indicates that CA-Easytrieve/Plus requires a data byte count. Use thiscode for printer control codes that must include a count of the numberof bytes of print data. This includes those bytes after the control code upto the end-of-record or the next printer control code.

L Indicates that the length of the record containing this control code mustbe merged with the control code. This length does not include any bytesthat can exist prior to the start of the subfield allocated to receive thecount. This means that the count is from the start of the special controlcode subfield through to the end of the physical record.

V Is used in Set Vertical Position control codes to indicate the position forthe Absolute Y-direction coordinate.

W Is used in Set Vertical Position control codes to indicate the incrementalamount to be added to the current Y-direction coordinate.

H Is used in Set Horizontal Position control codes to indicate the positionfor the Absolute X-direction coordinate.

I Is used in Set Horizontal Position control codes to indicate theincremental amount to be added to the current X-direction coordinate.

SYSPRINT Command


Character 3

This character defines the length (in half bytes) of the special control code thatCA-Easytrieve/Plus merges with the printer control code. This character must bea numeric value in the range of 1 to 8. This means that 4 bytes (8 half bytes) is themaximum width of a special control code.

The following example illustrates the definition of a Function Header Coderequiring the insertion of a data byte count (in binary) into the fixed portion of aprinter function code for the TORAY 8500 Line Mode printer.

SYSPRINT Command

You can code this command only once in the command stream. The SYSPRINTcommand associates the characteristics of an extended reporting printer to theCA-Easytrieve/Plus system printer. The extended reporting printer that youspecify on this command must be defined in the command stream.

Use this command only if sending the CA-Easytrieve/Plus system output to anextended reporting printer. The output that CA-Easytrieve/Plus sends to thisprinter includes all the output that CA-Easytrieve/Plus generates (compilationlisting, syntax error messages, DMAP, PMAP and Cross Reference listings, andso on) plus any printed output that a user program generates that is not directedto an alternative output file.

Syntax

SYSPRINT NAME (xrpt-name) - [SYSNO (value-1) ]

SYSPRINT Command


Keywords

NAME

NAME is a required keyword that defines the name of the extended reportingprinter that receives the system output of CA-Easytrieve/Plus.

(xrpt-name)

Xrpt-name identifies one of the extended reporting printers defined by aPRINTER command within this command stream. CA-Easytrieve/Plus uses thecharacteristics of this extended reporting printer to build and format the requiredprint records to produce system output.

CA-Easytrieve/Plus uses the default EBCDIC font for the associated extendedreporting printer for printing any EBCDIC data. CA-Easytrieve/Plus uses thedefault 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 dataand a minimum record length of 133 bytes. If either of these conditions are notmet, the extended reporting printer cannot support CA-Easytrieve/Plus' systemoutput.

[SYSNO]

This keyword is only applicable to VSE systems. Standard printed output fromCA-Easytrieve/Plus is directed to SYSLST through the VSE LogicalInput/Output module for Compiler Processing (called DTFCP). This modulerestricts the devices that SYSLST supports to printers. This module also restrictsthe data set characteristics to unblocked, 133-byte records. Therefore, if youassign SYSPRINT to an extended reporting printer, then you cannot use SYSLST.In this case, you must assign an alternative Programmer Logical Unit. TheSYSNO keyword defines the number to be used for CA-Easytrieve/Plus systemoutput.

In addition to the logical unit number changing, CA-Easytrieve/Plus uses a filename of EZTLST instead of IJSYSLS. Therefore, when you assign an extendedreporting printer to the CA-Easytrieve/Plus system output file,CA-Easytrieve/Plus directs the output to the logical unit that the SYSNOkeyword defines and the file name becomes EZTLST.

The device type for CA-Easytrieve/Plus system output is assumed to be aprinter. If not altered, CA-Easytrieve/Plus uses the VSE Logical Input/Outputmodule DTFPR. If you want to have CA-Easytrieve/Plus system output directedto DISK or TAPE, you must specify the applicable device type for the DEVICEkeyword of the PRINTER command of the extended reporting printer assignedby the NAME keyword on this SYSPRINT command.

PRINTER Command


The record size of CA-Easytrieve/Plus system output is the larger of theLINESIZE option in the CA-Easytrieve/Plus Options module (see Appendix A ofthe CA-Easytrieve/Plus Installation Guide) or 121. The record format ofCA-Easytrieve/Plus system output is fixed unblocked. Should you change eitheror both of these values, you must define the applicable values for the RECORDkeyword of the PRINTER command of the extended reporting printer assignedby the NAME keyword on this SYSPRINT command.

(value-1)

This value defines the Programmer Logical Unit to be used as the logical unit forCA-Easytrieve/Plus system output. The value must be a number between 0 (forSYS000) to 240 (for SYS240).

PRINTER Command

Code this command once for each extended reporting printer thatCA-Easytrieve/Plus supports. This command defines the characteristics of theprinter. By default, CA-Easytrieve/Plus supports no extended reporting printers,so you must specify one PRINTER entry to activate the extended reportingoptions module.

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-1 - - [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 ....])]

PRINTER Command


Keywords

NAME

NAME is a required keyword on the PRINTER command. It defines the extendedreporting printer name that is associated with the printer characteristics definedby:

� The other keywords on this PRINTER command.

� The fonts defined immediately after this PRINTER command.

(xrpt-name)

Xrpt-name is the 1-to 8-character extended reporting printer name. This name isuser selectable but it must conform to the requirements of a CA-Easytrieve/Plusname. This means that it cannot contain any of the CA-Easytrieve/Plusdelimiters including commas, apostrophes, left and right parenthesis, colons, andspaces.

Code xrpt-name on the CA-Easytrieve/Plus FILE statement when using the filefor extended reporting output. The xrpt-name associates the printercharacteristics and fonts defined for this extended reporting printer with anyprinted output directed to that CA-Easytrieve/Plus file. See theCA-Easytrieve/Plus FILE statement for more details.

MODEL

MODEL is the keyword that generates the characteristics for an extendedreporting printer by using one of a set of model definitions. MODEL,STRUCTURED-FIELDS, OVERPRINT-CODES, and TERMINAL are mutuallyexclusive. For information on the extended reporting models, refer to Chapter 6.

Where an installation has a printer whose characteristics are covered by one ofthe models, the use of the MODEL keyword means that the definition of theprinter's characteristics, through the use of the other PRINTER commandkeywords, is not necessary. On the other hand, the use of a model definition doesnot 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 bythe model.

The use of the MODEL keyword also results in a set of fonts being associatedwith the defined extended reporting printer. You can modify or expand thesefonts by using the FONT command after this PRINTER command.

PRINTER Command


model-name

Model-name is the name of a model-extended reporting printer whosecharacteristics are known by the Extended Reporting Facility. The valid entriesfor 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 3835printers in compatibility mode. This model does not includesupport of DBCS data through the Extended GraphicCharacter Set.

IBM3800B Defines the characteristics that support the IBM 3800 Model II,VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers (DBCSsupport) in compatibility mode. This model includes supportof DBCS data through the Extended Graphic Character Set.

IBM3800C Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820,IBM 3827, and IBM 3835 printers. The “All PointsAddressable” coordinates are generated as absolutecoordinates on a page. This model does not include support ofDBCS data through the Extended Graphic Character Set.

IBM3800D Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820,IBM 3827, and IBM 3835 printers. The “All PointsAddressable” coordinates are generated as relativecoordinates on a page. This model does not include support ofDBCS data through the Extended Graphic Character Set.

IBM3800E Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, andIBM 3835 printers. The “All Points Addressable” coordinatesare generated as absolute coordinates on a page. This modelincludes support of DBCS data through the Extended GraphicCharacter Set.

IBM3800F Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, andIBM 3835 printers. The “All Points Addressable” coordinatesare generated as relative coordinates on a page. This modelincludes support of DBCS data through the Extended GraphicCharacter Set.

SHOWA7 Defines support for the SHOWA Informational Systems SP-7printer.

SHOWA8 Defines support for the SHOWA Informational Systems SP-8printer.

PRINTER Command


Model-Names Description

M8250 Defines the characteristics of the MELCOM 8250 printer.

M8290 Defines the characteristics of the MELCOM 8290 printingsystem.

T8500 Defines support for the TORAY 8500 printer.

IBM3200 Defines the characteristics of the IBM 3200 printing system.

H8196 Defines support for the HITACHI 8196 printer.

F6715D Defines support for the FUJITSU 6715D and 6716D printers.

Chapter 6, “Extended Reporting Models,” contains a review of the characteristicsand fonts automatically defined by the above set of models.

[STRUCTURED-FIELDS]

This keyword indicates if the extended reporting printer being defined supportsStructured Fields. Printers that support Structured Fields permit Page or “AllPoints 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 hexadecimalstring defines the data to be used as the printer control code for Set VerticalPosition. The second value defines the hexadecimal string for the printer's SetHorizontal Position code.

value-1

This hexadecimal value defines the control data that CA-Easytrieve/Plus uses toestablish the Y-direction coordinate on the current page.

Define value-1 using the characters A - F and the numbers 0 - 9. Additionally, youmust include the special control code indicator for the insertion of either the SetAbsolute Y-direction address (character 2 = V) or the Set Relative Y-directionaddress (character 2 = W). For information on the three-byte code, refer to “XRPTCommands Overview,” earlier in this chapter.

value-2

This hexadecimal value defines the control data that CA-Easytrieve/Plus uses toestablish the X-direction coordinate on the current page.

Define value-2 using the characters A - F and the numbers 0 - 9. Additionally, youmust include the special control code indicator for the insertion of either the SetAbsolute X-direction address (character 2 = H) or the Set Relative X-directionaddress (character 2 = I). For information on the three-byte code, refer to “XRPTCommands Overview,” earlier in this chapter.

PRINTER Command


START-PAGE

CA-Easytrieve/Plus requires this keyword if the printer being defined is a PagePrinter (STRUCTURED-FIELDS keyword is specified). If the printer is not a PagePrinter, it is invalid to specify this keyword and if specified, an error message isoutput.

This keyword requires at least one value. Each value defines a hexadecimalstring that consists of the characters A - F and the numbers 0 - 9. In addition, youmust incorporate the appropriate three-byte code into the definition of the valueif any of the control codes require the insertion of either a Record Length specialcontrol code (character 2 = L) or a Record Count special control code (character 2= R). For information on the three-byte code, refer to “XRPT CommandsOverview,” 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 hexadecimalvalue that defines control data that CA-Easytrieve/Plus inserts at the front ofeach 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, ifthe control code requires the insertion of either a Record Length special controlcode (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 hexadecimalstring that consists of the characters A - F and the numbers 0 - 9. In addition, youmust incorporate the appropriate three-byte code into the definition of the valueif any of the control codes require the insertion of either a Record Length specialcontrol code (character 2 = L) or a Record Count special control code (character 2= R). For information on the three-byte code, refer to “XRPT CommandsOverview,” earlier in this chapter.

PRINTER Command


[OVERPRINT-CODES]

This keyword indicates if the extended reporting printer supports OverprintCodes. The OVERPRINT-CODES, MODEL, STRUCTURED-FIELDS, andTERMINAL keywords are all mutually exclusive.

If the printer requires control information immediately after the Paper Controlcode but before any Function codes or print text, then you must code thiskeyword.

If you do not code this keyword, CA-Easytrieve/Plus does not support Overprintcodes for this extended reporting printer.

This keyword has two required operands:

{ MERGE}{ }{ PRINT}

This required operand defines the technique that the printer uses to combinemultiple print records into a single print line.

Code the MERGE operand when the printer supports Overprint Codes and usesthe Merge Overprint technique to combine multiple print records into the oneprint line.

Code the PRINT operand when the printer being defined supports OverprintCodes and uses the Print Overprint technique to combine multiple print recordsinto the one print line.

The order in which CA-Easytrieve/Plus outputs overprint print records iscontrolled by the font number of the font defining the Overprint Code value. Thefirst overprint record is the record whose Overprint Code is defined on a fontwith the lowest font number. The last overprint print record is the record whoseOverprint 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 theprint records in the correct order. For more details regarding font numbers, seethe NUMBER and OVERPRINT-CODE keywords of the FONT command later inthis chapter.

value-3

This required operand identifies the maximum number of print records that canbe generated for the one print line. Value-3 must be a number between 1 and 256.

PRINTER Command


{TERMINAL}

This keyword indicates that the output for this extended reporting printer is to beviewed on a terminal that supports Double Byte (KANJI) data.CA-Easytrieve/Plus formats the print records such that you can view the outputon a terminal such as the IBM 5550. The important distinction between this typeof extended reporting printer and an extended reporting printer that supportsfunction codes is that the function codes for a TERMINAL extended reportingprinter occupy character positions on the screen. Normally, function codes in aprint record are instructions to the printer and do not occupy any space on thefinal print line. They are in fact absorbed by the printer. The display devicessupported by the TERMINAL keyword do not delete the function codes - theyoccupy space on the display line equivalent to the size of one EBCDIC character.

The two required values for this keyword define the appropriate codes toidentify DBCS (Double Byte) data from EBCDIC data on a display line. The firstvalue (Shift-out code) defines the control data to appear before DBCS data (Shiftout of EBCDIC). The second value (Shift-in code) defines the control data toappear after DBCS data (Shift into EBCDIC). Each of these codes is assumed tooccupy the space of one EBCDIC character regardless of the control codes length.

The size of EBCDIC characters and DBCS characters is assumed fixed for thisextended reporting printer type. The size of one DBCS character is assumed byCA-Easytrieve/Plus to be twice the size of one EBCDIC character. Therefore,CA-Easytrieve/Plus automatically generates three fonts for this extendedreporting printer.

� Font Number 1 is for EBCDIC data and its size is assumed to be 1.00. This isthe default EBCDIC font.

� Font Number 2 is the DBCS data and its size is assumed to be 2.00. This is thedefault DBCS font.

� Font Number 3 is for MIXED data and it is defined as a combination of fonts1 and 2. This is the default MIXED font.

Because the fonts are fixed by CA-Easytrieve/Plus, you cannot define additionalfonts 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 forthis printer type so you cannot code the POINT-SKIP keyword. Also, you cannotspecify 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 thatyou specify must be the one supplied by the display device.

PRINTER Command


shift-out

This required value defines a hexadecimal value that CA-Easytrieve/Plus insertsprior to any DBCS data in a print record directed to this extended reportingprinter. 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 insertsafter 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 aForms 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 theprinter supports an FCB means that CA-Easytrieve/Plus uses ANSI FormsControl codes, leaving the line spacing to the definitions in the FCB.

If the printer supports an FCB, but the printer requires Machine carriage controlcodes, specify the letter M. CA-Easytrieve/Plus performs the same processing asthat defined for ANSI codes above except that the carriage control values areMachine code equivalent of the ANSI codes.

If the printer does not support an FCB, specify the letter N. If you do not code thePOINT-SKIP keyword, CA-Easytrieve/Plus assumes the carriage control systemto be ANSI without an FCB. If you code the POINT-SKIP keyword, the only validvalue for the FCB keyword is N.

[POINT-SKIP]

For Line Mode printers that do not support FCB or ANSI Paper Control codes, orthat do not support Machine Control codes, you must use the POINT-SKIPkeyword to define the appropriate skip codes. This keyword is only valid if theoperand for the FCB keyword is specified as N (no FCB support). If the operandfor the FCB keyword is not N or the printer is a Page printer, this operand isinvalid.

When you define the POINT-SKIP keyword, you must also include theCONCATENATE 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 thatCA-Easytrieve/Plus uses to perform a skip to the first line of a new page. Definevalue-4 using the characters A - F and the numbers 0 - 9. Value-4 is the PaperControl code for print records that must start a new page.

PRINTER Command


value-5

This hexadecimal value defines the code that CA-Easytrieve/Plus uses to invokea point skip operation. The code is the Paper Control code for print records thatmust start a new line. The point skip operation requires the insertion of a numberof H-units into the control code to indicate the number of H-units to skip beforepositioning the next print line. Specify value-5 using the three-character code forthe point skip special control code (character 2 = S). For information on thethree-byte code, refer to the XRPT Commands Overview topic earlier in thischapter.

[DEFAULT-SIZE]

The DEFAULT-SIZE keyword defines the width and optionally the height thatCA-Easytrieve/Plus uses to convert the values assigned to various report andprinting attributes. These attributes include LINESIZE, PAGESIZE, and so on.These attributes are currently character-based settings. To convert them into thesame Unit of Measure used to define the heights and widths of fonts for thisprinter, CA-Easytrieve/Plus must multiply their character based settings by abase width and height that are expressed in terms of the appropriate W-units andH-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 tobe different from the width and height assigned to the default EBCDIC font. Ifyou do not code the keyword, then CA-Easytrieve/Plus uses the width andheight of the default EBCDIC font.

font-1

CA-Easytrieve/Plus always requires this value when you code theDEFAULT-SIZE keyword. Font-1 identifies the font whose width is to be thedefault W-unit for this extended reporting printer. Font-1 is the font numberassigned to the font whose width is to be the default width. The data format ofthe identified font must be EBCDIC or DBCS. The font identified by font-1 cannotdefine a Line Complex. CA-Easytrieve/Plus processes the W-unit of theidentified font as the default print width of the printer. CA-Easytrieve/Plus thenuses this value to convert character based values, such as LINESIZE into theappropriate W-unit of the printer.

font-2

You need only code this value for printers that do not support an FCB (FormsControl 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/Plusprints (that is the Base Height for this printer). Font-2 cannot define a LineComplex. CA-Easytrieve/Plus multiplies this value by the value of PAGESIZE toexpress the length of a page in terms of the H-units selected for this extendedreporting printer.

PRINTER Command


[DEFAULT-FORM]

The DEFAULT-FORM keyword defines the width and height thatCA-Easytrieve/Plus uses to validate specifications of LINESIZE, PAGESIZE, andso on, in a CA-Easytrieve/Plus program. These values ensure that the print linesthat 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 checkingof 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 keywordwhen defining a Page Printer. These two values define the initial co-ordinates onthe Logical Page that CA-Easytrieve/Plus uses whenever it starts a new page. Ifthese values are not coded, CA-Easytrieve/Plus assumes a W-units-2 value ofzero (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 theDEFAULT-FORM keyword. W-units-1 defines the maximum width of the logicalpage 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 twodecimal 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 DBCSdata. Normally, in this situation CA-Easytrieve/Plus produces output consistingof 106 DBCS characters per line (212 bytes of data). The font thatCA-Easytrieve/Plus uses is the default DBCS font for the extended reportingprinter.

In some situations, the extended reporting printer cannot support 106 DBCScharacters on the one print line. Should this situation exist for your extendedreporting 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 lineis 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 by2 to give the maximum number of DBCS characters.

The maximum data value is defined by value-10 of the MAX-RECORD keywordof the PRINTER command. This keyword is discussed later in this chapter.

PRINTER Command


H-units-1

CA-Easytrieve/Plus requires this value when you code the DEFAULT-FORMkeyword. H-units-1 defines the maximum depth of the logical page upon whichprint lines that CA-Easytrieve/Plus generates are to appear. H-units-1 must be interms of the printers H-units. You can specify up to two decimal places with thisvalue.

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 definesthe initial Set Horizontal Position that CA-Easytrieve/Plus must use whenever itbegins to format a new line.

Therefore, W-units-2 defines the position for the left-hand margin of any outputon the printers logical page. The W-units-2 value must be in terms of the printersW-units. It cannot contain any decimal positions.

H-units-2

This value can only be specified when defining a Page Printer, and it must bespecified when you code the W-units-2 value. H-units-2 defines the initial SetVertical Position that CA-Easytrieve/Plus must use whenever it begins to formata new page. Therefore, H-units-2 defines the position for the top of any output onthe printers logical page. The H-units-2 value must be in terms of the printersH-unit. It cannot contain any decimal positions.

[DEFAULT-FONT]

The DEFAULT-FONT keyword defines the fonts that CA-Easytrieve/Plus useswhen 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 printitem using that specified font.

CA-Easytrieve/Plus uses the fonts defined by the DEFAULT-FONT keywordwhen assigning this printer as the extended reporting printer for theCA-Easytrieve/Plus system output (see the SYSTEM command discussedpreviously).

The three operands are the numbers assigned to the fonts that are established asthe default EBCDIC, DBCS, and MIXED fonts for this printer. Therefore, all theoperands must identify a font that is to be defined for this extended reportingprinter.

PRINTER Command


If you do not specify this keyword,

� The first font defined for this printer that supports EBCDIC data becomes thedefault EBCDIC font.

� The first font defined for this printer that supports DBCS data becomes thedefault DBCS font.

� The first MIXED font defined for this printer becomes the default fonts forMIXED format data.

The fonts that the DEFAULT-FONT command identifies cannot support LineComplexes.

font-3

Font-3 is always required for the DEFAULT-FONT keyword. Font-3 defines thenumber 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 mustsupport 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 notsupport DBCS data, this operand is invalid and its use results in an errormessage. For printers supporting DBCS data, the number coded as font-4 mustidentify a font defined for this printer and that font must support DBCS dataotherwise an error message is printed. If you do not code font-4 and DBCS data issupported, the first DBCS font defined by the FONT command is established asthe default. You must code at least one DBCS font if the printer supports DBCSdata.

font-5

Only code font-5 if the printer supports DBCS data. If the printer does notsupport DBCS data, this operand is invalid and its use results in an errormessage. For printers supporting DBCS data, the number coded as font-5 mustidentify a font defined to support MIXED format data, otherwiseCA-Easytrieve/Plus outputs an error message. You must code at least oneMIXED font if the printer supports DBCS data.

[DBCS-CODE]

When an extended reporting printer supports DBCS data, code the DBCS-CODEkeyword to define that DBCS code system. You must define multiple extendedreporting 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 unableto support DBCS data. When you code this keyword, CA-Easytrieve/Plusassumes support for DBCS data. A printer that processes DBCS data is onlysupported after the installation of the CA-Easytrieve/Plus DBCS Option.

PRINTER Command


code-system

Code-system defines the name of one of the DBCS code systems thatCA-Easytrieve/Plus supports. The valid entries for this operand are:

Term Description

IBM Defines the IBM DBCS code system for Japan.

IBMKOREA Defines the IBM DBCS code system for Korea.

JEF Defines the FACOM code system (blank = X'A1A1').

JEF4040 Defines the FACOM code system (blank = X'4040').

JIPSE Defines the NEC code system.

JIS Japanese Industrial Standards code system.

KEIS Defines the HITACHI code system.

MELCOM Support of MELCOM printer code system.

SHOWA Defines the SHOWA Information code system.

TORAY Defines the TORAY 8500 code system.

If you assign a DBCS code system to an extended reporting printer file (definedon a FILE statement in your CA-Easytrieve/Plus program), the DBCS optionsmodule must define support for that system. If the DBCS options module doesnot define support for the system you are using, then a syntax error is generated.

[DEVICE]

The DEVICE keyword specifies the default output device type of the print dataset. For VSE environments, the device type defines the type of Input/Outputmodule that CA-Easytrieve/Plus uses for output print records. You can selectany one of the three options. For OS/390 environments, the three operands aremeaningless as CA-Easytrieve/Plus obtains the required information from theJCL.

Note: The operand selected here is only the default. You can alter the default bycoding different values on the FILE statement in a CA-Easytrieve/Plus program.

{DISK device-type}

The DISK operand indicates that the print data set resides on a direct access diskdevice. Device-type can be any of the following devices: DISK, FBA, 3390, 3380,3375, 3350, 3340, or 3330. CA-Easytrieve/Plus issues an error message if youcode any other value. If you do not code a device type, CA-Easytrieve/Plusobtains the default device type from the CA-Easytrieve/Plus options module atcompile time. For programs executing on DOS AF2 or later, CA-Easytrieve/Plusdetermines the specific disk device when the file is opened.

PRINTER Command


{TAPE}

The TAPE option indicates that CA-Easytrieve/Plus is to output the print dataset to magnetic tape. For the TAPE device, you can use three options to specify anaction against the tape's position. The REWIND option is assumed if you do notspecify 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 thetape is used.

{PRINTER}

The PRINTER option indicates that CA-Easytrieve/Plus is to direct the outputfile to an online printer. This means that a spooling system, such as JES2 andPOWER processes to print data set.

[RECORD]

The RECORD keyword is an optional keyword that defines the default recordformat CA-Easytrieve/Plus uses for the print data sets created for this printer.You can alter the defaults established here by specifying new record formatoptions on the CA-Easytrieve/Plus FILE statement that associates the print dataset to this extended reporting printer.

For VSE environments, the RECORD keyword is used when the record formatparameters are not coded on the CA-Easytrieve/Plus FILE statement. If you donot code this keyword and do not specify the record format parameters on theCA-Easytrieve/Plus FILE statement, CA-Easytrieve/Plus outputs a syntax error.

For OS/390 environments, the RECORD keyword is used when the recordformat parameters are not coded on the CA-Easytrieve/Plus FILE statement. Ifyou do not code this keyword and do not specify the record format parameterson the CA-Easytrieve/Plus FILE statement, the operating system obtains therecord format when CA-Easytrieve/Plus opens the file.

rec-fmt

This required operand defines the record format of the print data set. Validentries for this operand are the letters F for fixed, V for variable, and U forundefined record formats. Fixed and variable length records can be blocked (FB,VB). For OS/390 environments, the letters VBS indicate Variable Block Spannedrecords.

PRINTER Command


value-6

Value-6 is a required operand. If the records are fixed or variable length, itdefines 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 theprint data set.

value-7

CA-Easytrieve/Plus only requires this value when the record format supportsblocked records. This operand defines the maximum size of a block. IfCA-Easytrieve/Plus requires this operand, an error message is output if you donot 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 maximumprint record length that this extended reporting printer supports. Optionally, thiskeyword defines the maximum amount of print data (as opposed to printercontrol 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 theextended reporting printer has a limitation on the number of data bytes that canbe contained within its maximum record length.

value-8

Although it is possible to define the default record length through the RECORDkeyword (discussed previously), it is also possible to override this value on theCA-Easytrieve/Plus FILE statement that associates the print data set to thisextended reporting printer. When you specify the MAX-RECORD keyword,CA-Easytrieve/Plus validates the record length specified on that FILE statementto ensure that value-8 is not exceeded. If you do not code the MAX-RECORDkeyword, CA-Easytrieve/Plus does not perform a validity check. Value-8 mustbe greater than or equal to 133.

value-9

CA-Easytrieve/Plus requires this value only when the printer being defined hasa limitation on the amount of print data (as opposed to printer control codes) thatcan be defined within its maximum print record. If the only limitation is therecord 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 thespecified number of bytes of print data. CA-Easytrieve/Plus outputs acompilation error when value-9 is exceeded. Value-9 cannot be less than 132.

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, inthis situation CA-Easytrieve/Plus produces output consisting of 106 DBCScharacters per line (212 bytes of data).

In some situations, the extended reporting printer cannot support 212 bytes ofdata in a print record. Should this situation exist for your extended reportingprinter, value-9 can define the maximum number of “DISPLAY HEX” data bytesthat are formatted for the printer. The number of characters printed on each lineis 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 reportingprinter divided by the width of the default DBCS font. The form's maximumwidth is defined by the W-units-1 value of the DEFAULT-FORM keyword ofthe PRINTER command. This keyword was discussed earlier in this chapter.

[CONCATENATE]

The CONCATENATE keyword indicates whether the printer supportsconcatenated print records. CA-Easytrieve/Plus does not require this keyword. Ifyou do not code this keyword, the building of the print data set does not involveconcatenated print records. That is, the default assumes a value of N. Where theextended reporting printer does require concatenated records, you must code thiskeyword and specify the letter Y.

You can only specify the CONCATENATE keyword for printers that do notsupport ANSI or Machine carriage control systems. This means that only PagePrinters and Point Skip supportive printers can use the CONCATENATE option.

[RECORD-END]

This keyword defines a string of characters (in hexadecimal) thatCA-Easytrieve/Plus places at the end of either non-concatenated records orconcatenated blocks to indicate the end of data. If the printer does not supportsuch a control character then you should use the default of EBCDIC X'40'. Thisindicates to delimit the records/blocks with a space.

value-10

The required operand for the RECORD-END keyword defines the string ofcharacter(s) that CA-Easytrieve/Plus uses as the record delimiter. Value-10 is ahexadecimal literal consisting of the letters A - F and the numbers 0 - 9.

PRINTER Command


[RECORD-PAD]

This keyword defines a string of characters (in hexadecimal) thatCA-Easytrieve/Plus inserts after the Record End string and then adds to the endof an unconcatenated record or the end of a concatenated block. Should theprinter not support a particular character for record/block padding, use thedefault 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 Modeprinter. You can use this code to repeat a single byte character along the currentline. If you code this keyword, CA-Easytrieve/Plus uses this control code toreplace the insertion of space characters when inserting padding between printitems in a print record. CA-Easytrieve/Plus only uses this code if the number ofbytes of space characters being replaced is greater than the number of bytesoccupied by this control code. In this way, CA-Easytrieve/Plus is able to reducethe 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 setnumber of spaces on a print line. CA-Easytrieve/Plus adds this code to printrecords in place of padding spaces.

You must define this value as a hexadecimal string consisting of the letters A - Fand the numbers 0 - 9. In addition, you must identify the position in the printercontrol code to be updated with the number of bytes to be propagated by usingthe three-byte special control code subfield marker for data byte count (character2 = B).

[FILE-HEADER]

The FILE-HEADER keyword defines a set of values that individually define printrecords that CA-Easytrieve/Plus outputs to the print data set just after openingthe file but prior to outputting any user initiated print records. You should onlycode this keyword where CA-Easytrieve/Plus requires file header records. If youcode FILE-HEADER, then you must specify at least one header operand.

FONT Command


header-1 [header-2 ....]

The operands for the FILE-HEADER keyword consist of a series of values. Eachvalue can be either a hexadecimal string or a character string. If you enclose thevalue within apostrophes CA-Easytrieve/Plus interprets the value as a characterstring. Otherwise, CA-Easytrieve/Plus interprets the value as a hexadecimalstring and converts the value appropriately. Each header value constitutes a printrecord 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 theheaders in the order in which they are defined.

[FILE-TRAILER]

The FILE-TRAILER keyword defines a series of values that individually defineprint records that CA-Easytrieve/Plus outputs to the print data set just beforeclosing the file. Only code this keyword where CA-Easytrieve/Plus requires filetrailer records. Once you code FILE-TRAILER, you must specify at least onetrailer operand.

trailer-1 [trailer-2 ....]

The operands for the FILE-TRAILER keyword consist of a series of values. Eachvalue can be either a hexadecimal string or a character string. If you enclose thevalue within apostrophes, CA-Easytrieve/Plus interprets the value as a characterstring. Otherwise, CA-Easytrieve/Plus interprets the value as a hexadecimalstring and converts the value appropriately. Each trailer value constitutes a printrecord 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 thetrailers 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 thatdefines the extended reporting printer to which the fonts belong. The nextPRINTER command or the end of the command stream delimit the fonts for aprinter.

Each font is given a unique number (1 to 256). Font commands can define fonts inany order. However, you cannot define a font for one particular printer twice byusing two FONT commands in the same command stream. If you specify theMODEL keyword on the PRINTER keyword, all the fonts associated with themodel definition become associated with the extended reporting printer beingdefined. If necessary, you can use FONT commands to modify any of theseexisting font definitions. To do this, the font number coded on the FONTcommand should match the number of the font obtained from the printerMODEL definition.

FONT Command


If the extended reporting printer that the previous PRINTER command defines isnot a standard line printer, you must define one EBCDIC font. If the printer alsosupports 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 definesthe number that CA-Easytrieve/Plus programs use to uniquely identify the fontfor a print item (field or literal). The combination of the extended reportingprinter assigned to the print data set that receives the print record plus the fontnumber identify the font and its characteristics.

pvalue-1

Value-1 defines the number that identifies the font that this FONT commanddefines. The value can be in the range of 1 to 256.

WIDTH

You must specify the WIDTH keyword for each font that defines either EBCDICor DBCS format data. This keyword defines the width of the character that thisfont produces. By multiplying this value by the number of characters in a printitem, CA-Easytrieve/Plus determines the actual print width of the print item.

FONT Command


W-units-1

You must use a common Unit of Measure (W-unit) to define the widths of allfonts for a given extended reporting printer. The W-units-1 value defines thewidth 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 thewidth of the character. The exception is a printer that supports theSTRUCTURED-FIELDS keyword of the PRINTER command. No decimal placesare supported for these printers.

HEIGHT

The HEIGHT keyword is only required if the extended reporting printer for thefont does not support an FCB (Forms Control Block) and ANSI/MachineCarriage Control codes. Should the printer support such codes and you code theHEIGHT 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 thevertical space that a character printed using this font occupies.CA-Easytrieve/Plus requires the height for line spacing and line counting can beachieved.

CA-Easytrieve/Plus does not support this keyword when you are defining fontssupporting MIXED format data.

H-units-1

You must use a common Unit of Measure (H-unit) to define the heights of allfonts for a given extended reporting printer. The H-units-1 value defines theheight 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 theheight of a character. The exception is a printer that supports theSTRUCTURED-FIELDS keyword of the PRINTER command. No decimal placesare supported for these printers.

NAME

The NAME keyword is optional. This entry associates an alphanumeric name tothe font that this FONT command defines.

value-2

This value is a 1 to 40 alphanumeric name that is associated with this FONTdefinition. If the value contains spaces or parentheses, enclose the value withinquotes.

FONT Command


DATA-TYPE

This optional keyword indicates the data type that this font supports. A font cansupport 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 typeof 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 formatdata only. This means that the font can be associated with any of the EBCDICprint items that CA-Easytrieve/Plus supports including Alphabetic, ZonedNumeric, Packed, Unsigned Packed, and Binary fields, plus EBCDIC quotedliterals.

{DBCS}

The DBCS operand indicates that the font supports DBCS format data only. TheDBCS-CODE keyword on the PRINTER command defines the DBCS code systemof this DBCS format data. A font that supports DBCS data can be associated witha DBCS/Kanji field (field type of K) plus any DBCS or Source Conversion literals.

{font-1 font-2}

Use this form of the DATA-TYPE operands to define a font for a MIXED formatfield. MIXED format fields are a combination of EBCDIC and DBCS data.Therefore, defining a font for this data type involves defining an EBCDIC font forthe EBCDIC data found in the print item and a DBCS font for the DBCS datafound in the print item.

Font-1 is the number of the font defined for the current extended reportingprinter that is to be used for the EBCDIC portion of MIXED print items. This fontcannot support Line Complexes.

Font-2 is the number of the font defined for the current extended reportingprinter that is to be used for the DBCS portion of MIXED print items. This fontcannot support Line Complexes.

OVERPRINT-CODE

If the extended reporting printer that the previous PRINTER command definessupports Overprint Codes, you must code the OVERPRINT-CODE keyword foreach EBCDIC or DBCS font defined. CA-Easytrieve/Plus does not support theOVERPRINT-CODE keyword for MIXED format fonts. Use this keyword todefine the control code value that CA-Easytrieve/Plus inserts into any printrecord that outputs print items associated with this font.

FONT Command


value-3

This keyword consists of a hexadecimal string consisting of the letters A - F andthe numbers 0 - 9. CA-Easytrieve/Plus requires this operand when you code theOVERPRINT-CODE keyword.

FUNCTION-HEADER

If the extended reporting printer defined by the previous PRINTER commandrequires printer control information before the data of a print item, then youmust define that control information through the FUNCTION-HEADERkeyword. You can only code this keyword for EBCDIC and DBCS fonts. Use it todefine the control code value that CA-Easytrieve/Plus inserts into each printrecord that uses this font. CA-Easytrieve/Plus inserts the control informationimmediately before the text belonging the associated print item.

value-4

CA-Easytrieve/Plus requires this value when you code theFUNCTION-HEADER keyword. Value-4 is a hexadecimal string consisting of theletters A - F and the numbers 0 - 9. If the function code requiresCA-Easytrieve/Plus to insert a data byte count into the control code, you shouldadd a three-byte special control code for data byte counts (Character 2 = B) to thedefinition of value-4. For information on the three-byte code, refer to the XRPTCommands Overview topic earlier in this chapter.

FUNCTION-TRAILER

If the extended reporting printer defined by the previous PRINTER commandrequires printer control information after data of a print item, then you mustdefine that control information with the FUNCTION-TRAILER keyword. Youcan only code this keyword for EBCDIC and DBCS fonts. Use it to define thecontrol code value that CA-Easytrieve/Plus inserts into each print record thatuses this font. CA-Easytrieve/Plus inserts the control information immediatelyafter 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 theFUNCTION-TRAILER keyword.

FONT Command


ALIGN

Use the ALIGN keyword to indicate the need for double alignment with respectto 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 extendedreporting printer that the previous PRINTER command defines:

� Supports EBCDIC data as Half-Sized characters (half the size of DBCS/Kanjicharacters).

� Requires that Half-Sized character print items have a length that is a multipleof two, then you should specify the ALIGN keyword.

This keyword has one required operand. The letter Y indicates that double bytealignment is required and that the EBCDIC space character must be added to theEBCDIC print item to round it up to a double byte boundary.

If double byte alignment is necessary but the printer supports a special one byteNOP (No OPeration) function code, then you can define this code for thiskeyword. The NOP character is a special function code that CA-Easytrieve/Pluscan add to the print record to perform alignment. However, the printer does notprint the NOP character.

If an extended reporting printer does not have this requirement, do not code theALIGN keyword.

{Y}

Code this operand for the ALIGN keyword when the extended reporting printerrequires double byte alignment but does not support a special NOP character.When you code a Y, CA-Easytrieve/Plus aligns odd length EBCDIC print itemsby adding one EBCDIC space.

{value-6}

You can specify value-6 where the extended reporting printer requires doublebyte 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 theletters A - F and the numbers 0 - 9.

COMPLEX

The COMPLEX keyword indicates that a Line Complex is required. Only codethis keyword if:

� The font does define a Line Complex.

� The extended reporting printer that the previous Printer command definessupports Line Complexes.

CA-Easytrieve/Plus only supports Line Complexes when the printer uses an FCB(Forms Control Block) and ANSI/Machine Carriage Control Codes.

FONT Command


CA-Easytrieve/Plus does not support this keyword for fonts defining MIXEDformat data. CA-Easytrieve/Plus outputs an error message if you attempt to usethis keyword with MIXED format data.

The operand of the COMPLEX keyword indicates the number of lines that thecomplex 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 thisFONT command. CA-Easytrieve/Plus inserts this code before the associatedprint item on each print record that makes up the Line Complex. In addition toinserting the Function Code in each print record, CA-Easytrieve/Plus changesthe last byte of the Function Code to indicate the item's position in the LineComplex. CA-Easytrieve/Plus OR's the last byte with the following values:

1. X'00' for Line 1 of the Complex




Therefore, the definition of the FUNCTION-HEADER value must be inconsideration of this processing.

SPACE-REPLACE

The SPACE-REPLACE keyword is optional. You can only code this keyword forOverprint Printers that support the Merge Overprint technique for combiningmultiple print records into the same print line. The operand for this keyworddefines the one-byte value that replaces occurrences of X'40' in any fieldassociated with this font.

value-7

Value-7 is the hexadecimal value that replaces occurrences of X'40' in any fieldassociated with this font. Value-7 must consist of the characters A - F or theletters 0 - 9.

EZTPX04 Error Diagnostics



Introduction

The EZTPX04 provides a set of diagnostic messages that describe the types oferrors 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 andcontext of the message. If possible, CA-Easytrieve/Plus provides a supplement toidentify the particular object which is in error.



Diagnostic Messages

The following is a list and a brief description of the EZTPX04 diagnosticmessages.

01 *** COMMAND EXPECTED BUT NOT FOUND

Each new card that is not a comment or continuation card must begin with avalid EZTPX04 command. Only SYSPRINT, PRINTER, and FONT commands areallowed.

02 *** FONT COMMAND OUT OF SEQUENCE

You can code one or more FONT commands AFTER a PRINTER command. AFONT command cannot precede the first PRINTER command.

03 *** INVALID COMMAND. REMAINING DATA IGNORED

Only the SYSPRINT, PRINTER, and FONT commands are valid for EZTPX04.

04 *** 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 thecommand stream was reached prematurely.

06 *** CONTINUATION EXPECTED BUT NOT FOUND

The end of a command is detected while CA-Easytrieve/Plus is expecting akeyword 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 aredetected prior to the end of the keyword or set of values.



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-CODESkeywords for the same PRINTER command. They are mutually exclusive.



17 *** INVALID FONT BECAUSE PRINTER DOES NOT SUPPORT DBCS

You can only define a font for DBCS and MIXED format data when the previousPRINTER command indicates that DBCS data is supported through theDBCS-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 thatkeyword. 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 printerby a previous FONT command.



26 *** INVALID HEX VALUE

The value contains an invalid hexadecimal string. You can use only thecharacters A - F and the numbers 0 - 9.

27 *** 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 eightcharacters.

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 aSet 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 aSet 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 Countspecial control code in the printer control code.



35 *** SPECIAL CONTROL CODE INDICATOR S REQUIRED IN THIS VALUE

The definition of a point skip printer control code requires the definition of apoint 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 abyte 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 forfixed blocked files.



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 itsassociated 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 currentPRINTER 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 PRINTERcommand is defining a Page Printer.



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 PointSkip Paper Control Codes.

54 *** NO FONT BLOCK FOR EBCDIC FOUND

You must specify at least one font for EBCDIC data if the previous PRINTERcommand 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 PRINTERcommand supports DBCS data.

56 *** FONT DOES NOT MATCH WITH DATA TYPE

The font specified as the default font for either EBCDIC, DBCS, or MIXED formatdata 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 MIXEDformat data.

58 *** DBCS CODE SYSTEM NOT DEFINED FOR DEFAULT DBCS FONT

CA-Easytrieve/Plus only supports a font for DBCS format data if the previousPRINTER 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 supportedfor 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 hasnot been defined.



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 notbeen defined.

62 *** FONT BLOCK CORRESPONDING TO FONT NUMBER SPECIFIED NOT FOUND

The indicated font number has not been defined for the current extendedreporting printer.

63 *** FONTS CANNOT BE SUPPORTED FOR STANDARD LINE PRINTER

If the previous PRINTER command defines a standard Line Printer then youcannot 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 supporta 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 theWIDTH keyword.

66 *** KEYWORD HEIGHT REQUIRED FOR PRINTERS NOT SUPPORTING FCB

You must specify the HEIGHT keyword for fonts supported by printers that donot 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 FormsControl Block.

68 *** KEYWORD HEIGHT CANNOT BE CODED FOR MIXED FORMAT DATA

The definition of a MIXED format font does not require the HEIGHT keyword.



69 *** IF OVERPRINT-CODES CODED OVERPRINT-CODE MUST BE CODED

The PRINTER command defined support for Overprint Codes. TheOVERPRINT-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-CODEkeyword.

71 *** DECIMAL POSITIONS ARE NOT SUPPORTED FOR PAGE PRINTERS

The values for the WIDTH and HEIGHT keywords must be whole numberswhen 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 theFUNCTION-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 theFUNCTION-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 FormsControl Block.

76 *** NO PRINTER COMMAND CODED. MUST BE CODED ONCE FOR EACH PRINTER

At least one PRINTER command is required in the command stream.



77 *** PRINTER BLOCK ASSIGNED TO RECEIVE SYSPRINT OUTPUT NOT FOUND

The printer name defined by the NAME keyword of the SYSPRINT command isnot 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 aprevious PRINTER command.

79 *** AT LEAST ONE FONT COMMAND FOR EBCDIC FONT MUST BE CODED

A new PRINTER definition has been encountered. The previous PRINTERcommand is missing at least one EBCDIC FONT definition. Alternately, an EOFcondition has been detected and the last PRINTER command is missing at leastone 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 linecomplex definition.

83 *** CONCATENATE CAN ONLY BE CODED FOR PAGE PRINTER OR POINT SKIP

CA-Easytrieve/Plus only supports the CONCATENATE option for non-ANSIand non-machine code printers.

84 *** DEVICE TYPE MUST BE SPECIFIED

The device type keyword is required for the current printer.



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 maximumrecord 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 requiresupport 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 PRINTERcommand 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 themaximum 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 themaximum value supported by the Set Horizontal Position special control code.



93 *** ONLY ONE SPECIAL CONTROL CODE IDENTIFIER CAN BE CODED

You cannot define more than the one special control code identifier in the currentvalue.

94 *** OVERPRINT-CODE IS ONLY VALID IF OVERPRINT-CODES WAS CODED

The OVERPRINT-CODE keyword can only be specified on a FONT commandwhen the previous PRINTER command defined support for overprint codesthrough 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 codesystem. You must specify the DBCS-CODE keyword and one valid DBCS codesystem as its value.

97 *** DEFAULT-FORM KEYWORD IS INVALID FOR TERMINAL KEYWORD

The DEFAULT-FORM keyword cannot be specified when defining a TERMINALtype printer.

98 *** DEFAULT-FONT KEYWORD IS INVALID FOR TERMINAL KEYWORD

The fonts for a TERMINAL type printer are automatically defined so you cannotdefine 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 TERMINALtype printer.

100 *** CONCATENATE KEYWORD IS NOT SUPPORTED FOR TERMINAL KEYWORD

The CONCATENATE keyword cannot be specified when defining a TERMINALtype printer.



101 *** CARRIAGE CONTROL CAN ONLY BE FCB OR MACHINE CODES

The Carriage Control system supported for this printer type must support anFCB 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 additionalfonts 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 cannotdefine 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 DBCSdata 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 LineComplex.

106 *** COMPLEX NOT SUPPORTED FOR DBCS PORTION OF MIXED FIELD

The DBCS portion of a MIXED format font cannot define support for a LineComplex.

107 *** DBCS CODE SYSTEM NOT DEFINED FOR DBCS DATA

The printer defined by the previous PRINTER command must support DBCSdata 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 theprevious PRINTER command is not defined by a FONT command.



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 theprevious 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 theprevious PRINTER command.

111 *** DEFAULT-FONT KEYWORD INVALID WHEN NO FONTS COMMAND IS CODED

You cannot specify the DEFAULT-FONT keyword on the PRINTER command ifyou 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 aredefining 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 EBCDICdata.

114 *** KEYWORD SPACE-REPLACE CANNOT BE CODED FOR MIXED FORMAT DATA

You cannot specify the SPACE-REPLACE keyword when defining a font forMIXED format data.

Extended Reporting 5–1

Chapter

5 Extended Reporting

Introduction

This chapter describes the enhancements made to normal CA-Easytrieve/Plussyntax that are necessary for using the Extended Reporting Facility.

For complete information on CA-Easytrieve/Plus syntax, refer to theCA-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) filesonly. The syntax of the FILE statement relative to extended reporting is asfollows:

FILE file-name + . . . [EXTENDED xrpt-name]

[EXTENDED]

The EXTENDED option indicates that the file is to be associated with anextended reporting printer. This means that input/output statements (GET, PUT,READ, WRITE) cannot reference these printer files. However, the DISPLAYstatement and REPORT statements can reference these printer files. Unless youcode them, record length and blocksize default to those defined for the printer inthe extended reporting options module.

DEFINE Statement


[xrpt-name]

The xrpt-name entry identifies the extended reporting printer whosecharacteristics are to be associated with this file. You must define the xrpt-namein the extended reporting options module.

DEFINE Statement

Code the DEFINE statement in the library section of the program directly afterthe FILE statement or anywhere else in the activity. The syntax relative toextended 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' whenyou use field-name-1 in a report directed to an extended reporting printer. If thereport 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 theparentheses are stacked vertically over the field when printed. Each 'literal-1' canuse 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 fontidentified in the extended reporting options module. See your SystemAdministrator for details regarding the Default Fonts for an extended reportingprinter.

DEFINE FULL-NAME 10 45 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 1

DISPLAY Statement


DISPLAY Statement

The DISPLAY statement formats and transfers data to the system output deviceor to a named file. It is the only input/output processing statement that theExtended Reporting Facility affects. The DISPLAY statement syntax has threeformats 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]

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 (notvalid for use in report procedures). CA-Easytrieve/Plus supports literal-1 ineither of these cases:

� When file-name-1 is not associated with an extended reporting printer

� When the extended reporting printer supports ANSI or Machine carriagecontrols.

Should file-name-1 be associated with a extended reporting printer that does notsupport ANSI or Machine codes, then CA-Easytrieve/Plus does not supportliteral-1.

[COL integer-3]

The COL integer-3 option specifies the print column number whereCA-Easytrieve/Plus places the next display item. Integer-3 is any value that doesnot extend beyond the end of the line.

When using an extended reporting printer that is not a standard Line Printer, anerror results if two or more fields and/or literals overlap.

Report Processing


[POS integer-4]

Within report procedures the POS integer-4 option causes CA-Easytrieve/Plus toposition the next display item under the corresponding integer-4 item on theLINE 01 statement.

When using an extended reporting printer that is not a standard Line Printer, anerror 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 thenext display item. You can only specify this option if file-name-1 has beenassociated with an extended reporting printer. Integer-5 identifies the fontnumber of a font defined for the extended reporting printer assigned to receivethe print output. If you do not code the font index, then the next display itemuses 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 theassigned extended reporting printer. If you code the font index before either ofthese options, then integer-2 or integer-3 refers to horizontal sizes based on thewidth of the font identified by integer-5.

Format 3

You can use Format 3 to output printer control records. Literal-3 can be analphanumeric or hexadecimal literal that CA-Easytrieve/Plus outputs to the printfile without paper control information. These control cards contain instructions toextended reporting printers. Print control records for some printing systemsdefine the specification of the Font sets that CA-Easytrieve/Plus uses for aparticular report. Such control cards can be output to the print data set before areport that uses the loaded font sets.

You can only use this format of the DISPLAY statement when file-name-1 isassociated with an extended reporting printer. CA-Easytrieve/Plus outputs asyntax 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 printedreports. The non-procedural nature of CA-Easytrieve/Plus report syntax isreadily adaptable to the production of basic and extremely complex reports, bothwith minimum programming effort.

Report Processing


The introduction of the Extended Reporting Facility does not alter thenon-procedural nature of CA-Easytrieve/Plus report syntax. The functions ofCA-Easytrieve/Plus reporting have not been changed. There are, however, someadded considerations when using the Extended Reporting Facility to producereports. Such considerations are noted for pertinent items of syntax on thefollowing pages.

If you do not associate a report with an extended reporting printer, then there isno change in the use of CA-Easytrieve/Plus.

REPORT Statement

The REPORT statement is the first statement coded in a report declaration. Thisstatement establishes the type and characteristics of the report. Only the REPORTstatement parameters requiring special consideration when using extendedreporting 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 eachlabel. The value of literal-5 is the number of print positions on a label. Literal-5has 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/Plusmultiplies literal-5 by the default width defined for the assigned extendedreporting printer. This result determines the width of each label.

Report Processing


File Directing Parameters

[PRINTER file-name-3]

The optional PRINTER parameter directs the report's printed output. File-name-3identifies the FILE that receives the report. This file must have the PRINTER orEXTENDED attribute specified. The default is the CA-Easytrieve/Plus systemprint output file: SYSPRINT for OS/390, SYSLST for VSE.

If the system print output file or file-name-3 has been associated with anextended reporting printer, then CA-Easytrieve/Plus automatically formats thereport to satisfy the requirements defined for that extended reporting printer.CA-Easytrieve/Plus restricts the support of extended reporting facilities to thosereports that are output to printer files that have been associated with an extendedreporting printer.

Spacing Control Parameters

[PAGESIZE literal-6]

The PAGESIZE option establishes the length of each printed page. The value ofliteral-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 notsupport an Forms Control Block (FCB), then CA-Easytrieve/Plus multiplies thePAGESIZE value by the default height of the assigned extended reportingprinter. This permits CA-Easytrieve/Plus to compare PAGESIZE with theheights of fonts used on the report as they are both in the same base unit -- theH-unit.

The value of literal-6 multiplied by the default height of the assigned extendedreporting printer cannot exceed the maximum page length of that extendedreporting printer.

Report Processing


[LINESIZE literal-7]

The LINESIZE option determines the length of each line on a page. Literal-7 isthe number of print positions on each report line. The value of literal-7 must be 1to 'nnn' where 'nnn' is one less than the physical length (record size) of the printerfile receiving the report. The first character in a PRINTER file contains the ASAcarriage control information.

When the report is assigned to an extended reporting printer that is not astandard Line Printer, the maximum value of LINESIZE is not dependent uponthe record size of the print data set. The insertion of Overprint and FunctionCodes into print records plus the support of different fonts on the same print lineall impact the relationship between LINESIZE and print data set record size.CA-Easytrieve/Plus supports any LINESIZE provided literal-7 multiplied by thevalue of the assigned extended reporting printers default width does not exceedthe maximum page width of that extended reporting printer.

Literal-7 overrides the value defined in the CA-Easytrieve/Plus systems optionsmodule. If the report is directed to an extended reporting printer,CA-Easytrieve/Plus multiplies the LINESIZE value by the default width of theassigned extended reporting printer. This value defines the width of the printline 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 betweenline groups (between 'LINE nnn' and the next 'LINE 01'). Literal-8 has a validrange of 0 to 'nnn', where 'nnn' permits the printing of at least one line group oneach page. If you specify a value of 0, a line group containing multiple lines canbe spanned across a page break. A nonzero value inhibits this spanning.

When the report is directed to an extended reporting printer that does notsupport an Forms Control Block (FCB), the default height of the assignedextended 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 ofliteral-9 has a valid range of 0 to 'nnn' (default is 3), where 'nnn' does not cause aline 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 theassigned extended reporting printer. This operation expresses the SPACE factorin terms of the printer's W-unit.

Report Definition Statements


[TITLESKIP literal-10]

The TITLESKIP option inserts blank lines between the last title line and the firstheading line (or LINE 01) of a report. The value of literal-10 has a valid range of 0to '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 notsupport an Forms Control Block (FCB), the height of each line is defined by thedefault height of the assigned extended reporting printer. This operation convertsthe number of lines into the H-units applicable to the printer.


The REPORT statement and its associated parameters define the physicalattributes of a report. However, to define the content of a report, report definitionstatements are used. For extended reporting, the following statements have beenmodified:

� TITLE

� HEADING

� LINE.

TITLE Statement

One or more TITLE statements define the optional report title. The TITLEstatement 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 itemis placed. The value of integer-2 has a valid range of 1 to 'nnn', where 'nnn' cannotforce the following title item beyond the end of the title line LINESIZE. COL isonly permitted when you specify the NOADJUST parameter of the REPORTstatement.



When the report is associated with an extended reporting printer is not astandard Line Printer, an error results if two or more fields and/or literalsoverlap.

Each title line is centered within the title area of the report unless you use theNOADJUST 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 titlearea.

� Unless overridden by the NOPAGE parameter, the value in the PAGEWRDoption and the current page count are placed at the righthand end of the titlearea.

[#integer-3]

The #integer-3 value defines a font index. The value of integer-3 identifies a fontwhose specifications are to be used for the next display item. You can onlyspecify this option if the report has been associated with an extended reportingprinter. Integer-3 identifies the font number of a font defined for the associatedextended reporting printer.

� If you do not code the font number, then the next display item uses thedefault 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 ofthe assigned extended reporting printer.

� If you code integer-3 before either of these options, integer-1 or integer-2refers to horizontal sizes based on the width of the font that integer-3identified.

HEADING Statement

The HEADING statement optionally defines an alternative heading for a field. Itssyntax is:



Syntax

HEADING field-name ([#integer-1] 'literal-1' ......)

[#integer-1]

Integer-1 defines the font number of a font that CA-Easytrieve/Plus uses toformat 'literal-1' in the heading area of a report. You can only specify integer-1 ifyou direct the report to an extended reporting printer. If you direct the report toa normal printer, CA-Easytrieve/Plus outputs a syntax error when you codeinteger-1. Each 'literal-1' can use a unique font index by coding the # sign and avalue for integer-1 before 'literal-1'. Any 'literal-1' that does not have a font indexassigned uses the default font for the assigned extended reporting printer.

Example

HEADING FULL-NAME (#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 1

LINE Statement

The LINE statement defines the content of a report line. One or more field valuesor literals can be contained on a report line; each one is a line item. The syntax ofthe 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 isplaced. The NOADJUST option must be coded on the REPORT statement to usethe 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 linedefined by LINESIZE.



When the report is associated with an extended reporting printer that is not astandard Line Printer, an error results if two or more fields and/or literalsoverlap.

[#integer-4]

The font index option identifies the font specifications to be used for the nextdisplay item. You can only specify this option if the report has been associatedwith an extended reporting printer. Integer-4 identifies the number of a fontdefined for the associated extended reporting printer.

� If you do not code the font, the next display item uses the default font for theassigned 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 ofthe assigned extended reporting printer.

� If you code the font index before either of these options, then integer-1 orinteger-2 refers to horizontal sizes, based on the width of the font thatinteger-4 identifies.

Extended Reporting Models 6–1

Chapter

6 Extended Reporting Models

Introduction

The extended reporting options module defines the characteristics of theextended reporting printers that CA-Easytrieve/Plus supports. To assist in thegeneration of this module, the characteristics of commonly used printers wereidentified and stored as models. This enables the characteristics of an extendedreporting printer to be identified by associating it with one of the models. TheMODEL keyword on the PRINTER command accomplishes the association.

This chapter details the characteristics for each of the models currently providedwhich are:

Reporting Printer Description

IBM3800A Defines the characteristics that support the IBM 3800 ModelI, II, III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM3835 printers in compatibility mode. This model does notinclude support of DBCS data via Extended GraphicCharacter Set.

IBM3800B Defines the characteristics that support the IBM 3800 ModelII, VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers(DBCS support) in compatibility mode. This model includessupport of DBCS data via Extended Graphic Character Set.

IBM3800C Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model III, VI, VIII, IBM 3812, IBM3820, IBM 3827, and IBM 3835 printers. The “All PointsAddressable” coordinates are generated as absolutecoordinates on a page. This model does not include supportof DBCS data via Extended Graphic Character Set.

Introduction


Reporting Printer Description

IBM3800D Defines the “All Points Addressable” characteristics thatsupport the IBM 3800 Model III, VI, VIII, IBM 3812, IBM3820, IBM 3827, and IBM 3835 printers. The “All PointsAddressable” coordinates are generated as relativecoordinates on a page. This model does not include supportof DBCS data via Extended Graphic Character Set.

IBM3800E Defines the “All Points Addressable” characteristics thatsupport 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 ExtendedGraphic Character Set.

IBM3800F Defines the “All Points Addressable” characteristics thatsupport 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 ExtendedGraphic Character Set.

SHOWA7 Defines support for the SHOWA Informational SystemsSP-7 printer.

SHOWA8 Defines support for the SHOWA Informational SystemsSP-8 printer.

M8250 Defines the characteristics of the MELCOM 8250 printer.

M8290 Defines the characteristics of the MELCOM 8290 printingsystem.

T8500 Defines support for the TORAY 8500 printer.

IBM3200 Defines characteristics of the IBM 3200 printing system.

H8196 Defines support for the HITACHI 8196 printer.

F6715D Defines support for the FUJITSU 6715D and 6716D printers.

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 compatibilitymode. This model does not include support of DBCS data through ExtendedGraphic 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 (206 204) * * 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)

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) *

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 compatibilitymode. This model includes support of DBCS data through Extended GraphicCharacter 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 (1 102 201) - DBCS-CODE (IBM) - DEVICE (PRINTER) - RECORD (F 206) - MAX-RECORD (206 204) * * * 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)

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.

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) *

IBM3800C Model


IBM3800C Model

This model defines the “All Points Addressable” characteristics that support theIBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835printers. The “All Points Addressable” coordinates are generated as absolutecoordinates on a page. This model does not include support of DBCS datathrough 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 (3168 2400 0 0) - 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)

IBM3800D Model


IBM3800D Model

This model defines the “All Points Addressable” characteristics that support theIBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835printers. The “All Points Addressable” coordinates are generated as relativecoordinates on a page. This model does not include support of DBCS datathrough 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 (3168 2400 0 0) - 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)

IBM3800E Model


IBM3800E Model

This model defines the “All Points Addressable” characteristics that support theIBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The “AllPoints Addressable” coordinates are generated as absolute coordinates on a page.This model includes support of DBCS data through Extended Graphic CharacterSet.

* * 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 (3168 2400 0 0) - DEFAULT-FONT (2 101 201) - 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 (002 101) * FONT NUMBER (202) - DATA-TYPE (002 102)

IBM3800F Model


IBM3800F Model

This model defines the “All Points Addressable” characteristics that support theIBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The “AllPoints Addressable” coordinates are generated as relative coordinates on a page.This model includes support of DBCS data through Extended Graphic CharacterSet.

* * 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 (3168 2400 0 0) - DEFAULT-FONT (2 101 201) - 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 (002 101) * FONT NUMBER (202) - DATA-TYPE (002 102)

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 (7 107 207) - 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) *

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) *

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) *

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 (001 101) * FONT NUMBER (202) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE (002 102) * FONT NUMBER (203) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE (003 103) * FONT NUMBER (204) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE (004 104) * FONT NUMBER (205) - NAME ('MIXED FONT - 14 POINT') - DATA-TYPE (005 105) * FONT NUMBER (206) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE (006 106) * FONT NUMBER (207) - NAME ('DEFAULT MIXED FONT - 10 INCH') - DATA-TYPE (007 107) *

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 (7 107 207) - 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 (F0009000) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (002) - WIDTH (4 ) - HEIGHT (8 ) - NAME ('HALF SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0019000) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (003) - WIDTH (4.5) - HEIGHT (9 ) - NAME ('HALF SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0029000) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (004) - WIDTH ( 5 ) - HEIGHT (10 ) - NAME ('HALF SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0039000) - FUNCTION-TRAILER (001F) - ALIGN (00)

SHOWA8 Model


* FONT NUMBER (005) - WIDTH ( 7 ) - HEIGHT (14 ) - NAME ('HALF SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0049000) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (006) - WIDTH ( 6 ) - HEIGHT (12 ) - NAME ('HALF SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0059000) - 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 (F0069000) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (008) - WIDTH ( 3 ) - HEIGHT ( 6 ) - NAME ('HALF SIZE 6 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0099000) - 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 (F0009001) - FUNCTION-TRAILER (001F) - ALIGN (00)

SHOWA8 Model


* FONT NUMBER (012) - WIDTH ( 8 ) - HEIGHT ( 8 ) - NAME ('FULL SIZE 8 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0019001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (013) - WIDTH ( 9 ) - HEIGHT ( 9 ) - NAME ('FULL SIZE 9 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0029001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (014) - WIDTH (10 ) - HEIGHT (10 ) - NAME ('FULL SIZE 10 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0039001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (015) - WIDTH (14 ) - HEIGHT (14 ) - NAME ('FULL SIZE 14 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0049001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (016) - WIDTH (12 ) - HEIGHT (12 ) - NAME ('FULL SIZE 12 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0059001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (017) - WIDTH (7.2) - HEIGHT (9 ) - NAME ('FULL SIZE 10 INCH FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0069001) - FUNCTION-TRAILER (001F) - ALIGN (00) * FONT NUMBER (018) - WIDTH ( 6 ) - HEIGHT ( 6 ) - NAME ('FULL SIZE 6 POINT FONT') - DATA-TYPE (EBCDIC ) - FUNCTION-HEADER (F0099001) - FUNCTION-TRAILER (001F) - ALIGN (00)

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)

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 (001 101) * FONT NUMBER (202) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE (002 102) * FONT NUMBER (203) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE (003 103) * FONT NUMBER (204) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE (004 104) * FONT NUMBER (205) - NAME ('MIXED FONT - 14 POINT') - DATA-TYPE (005 105) * FONT NUMBER (206) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE (006 106) * FONT NUMBER (207) - NAME ('DEFAULT MIXED FONT - 10 INCH')- DATA-TYPE (007 107) * FONT NUMBER (208) - NAME ('MIXED FONT - 6 POINT') - DATA-TYPE (008 108)

M8250 Model


* FONT NUMBER (209) - NAME ('MIXED FONT - NEW 7 POINT') - DATA-TYPE (009 109) * FONT NUMBER (210) - NAME ('MIXED FONT - NEW 10 INCH FONT')- DATA-TYPE (010 110) *

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 ( 4222 41&S2 ) - DEFAULT-SIZE ( 6 6 ) - DEFAULT-FONT ( 6 106 206 ) - 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 ) *

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 )

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 ( 001 101 ) * FONT NUMBER ( 202 ) - NAME ('MIXED FONT - 8 POINT') - DATA-TYPE ( 002 102 ) * FONT NUMBER ( 203 ) - NAME ('MIXED FONT - 9 POINT') - DATA-TYPE ( 003 103 ) * FONT NUMBER ( 204 ) - NAME ('MIXED FONT - 10 POINT') - DATA-TYPE ( 004 104 ) * FONT NUMBER ( 205 ) - NAME ('MIXED FONT - 12 POINT') - DATA-TYPE ( 005 105 ) * FONT NUMBER ( 206 ) - NAME ('MIXED FONT - 10 INCH') - DATA-TYPE ( 006 106 ) *

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 ( 2 102 203 ) - DBCS-CODE ( JIS ) - DEVICE ( TAPE UNLOAD ) - RECORD ( FB 350 8400 ) - 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 )

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 )

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 ( 001 101 ) * FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( 004 101 ) * * 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 ( 002 102 ) * FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 005 102 ) * FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 007 102 ) * * * 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 ( 001 103 ) * FONT NUMBER ( 207 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( 004 103 ) * * 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 ( 002 104 )

M8290 Model


* FONT NUMBER ( 209 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 005 104 ) * FONT NUMBER ( 210 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 007 104 ) * * 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 ( 003 105 ) * FONT NUMBER ( 212 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 006 105 ) * FONT NUMBER ( 213 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 008 105 ) * FONT NUMBER ( 214 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 009 105 ) * * 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 ( 001 106 ) * FONT NUMBER ( 216 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( 004 106 ) * * 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 ( 002 107 ) * FONT NUMBER ( 218 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 005 107 ) * FONT NUMBER ( 219 ) - NAME ('MIXED FONT AT 6 CPI') - DATA-TYPE ( 007 107 ) * * * 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 ( 003 108 ) * FONT NUMBER ( 221 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 006 108 )

T8500 Model


* FONT NUMBER ( 222 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 008 108 ) * FONT NUMBER ( 223 ) - NAME ('MIXED FONT AT 7.5 CPI') - DATA-TYPE ( 009 108 ) *

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 ( 1 102 201 ) - DBCS-CODE ( TORAY ) - DEVICE ( TAPE UNLOAD ) - RECORD ( FB 410 8200 ) - MAX-RECORD ( 410 ) - RECORD-END ( 1E ) - RECORD-PAD ( 1E ) * * * Define Half Size EBCDIC Fonts for TORAY 8500. * * 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 )

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 8500. * 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 )

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 8500. * * 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 ( 001 102 ) * FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 9 CPI') - DATA-TYPE ( 002 103 ) * FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 10 CPI') - DATA-TYPE ( 003 104 ) * FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 12 CPI') - DATA-TYPE ( 004 105 ) * FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT 14 CPI') - DATA-TYPE ( 005 106 ) *

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 ( 2 101 201 ) - DBCS-CODE ( IBM ) - DEVICE ( PRINTER ) - RECORD ( F 206 ) - MAX-RECORD ( 384 204 ) * * * Define EBCDIC Fonts for IBM 3200. * * EBCDIC fonts supported are 10, 12 and 15 CPI but size * depends upon font selection. 3200 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 )

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 3200. * * DBCS Fonts supported are 6, 7.5 and 10 CPI but size * depends upon font selection. 3200 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 )

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 ( 002 101 ) * FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 7.5 CPI AS 3200 FONT 1')- DATA-TYPE ( 003 102 ) * FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 6 CPI AS 3200 FONT 2') - DATA-TYPE ( 005 104 )

H8196 Model


* FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 7.5 CPI AS 3200 FONT 2')- DATA-TYPE ( 006 105 ) *

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 ( 1 102 201 ) - DBCS-CODE ( KEIS ) - DEVICE ( PRINTER ) - RECORD ( F 384 ) - MAX-RECORD ( 384 204 ) * * * Define EBCDIC Fonts for HITACHI 8196. * 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 )

H8196 Model


* * * Define DBCS fonts for HITACHI 8196. * 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 1.875 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 )

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 1.875 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 )

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 1.875 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 8196. * * 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 ( 001 102 ) * FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 5 CPI') - DATA-TYPE ( 002 103 ) * FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 3.75 CPI') - DATA-TYPE ( 003 104 ) * FONT NUMBER ( 204 ) - NAME ('MIXED FONT AT 1.875 CPI') - DATA-TYPE ( 004 105 ) * FONT NUMBER ( 205 ) - NAME ('MIXED FONT AT .9372 CPI') - DATA-TYPE ( 005 106 ) *

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 ( 2 101 201 ) - 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 )

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 ( 002 101 )

F6715D Model


* FONT NUMBER ( 202 ) - NAME ('MIXED FONT AT 7.5 CPI - DBCS 9 POINT')- DATA-TYPE ( 001 102 ) * FONT NUMBER ( 203 ) - NAME ('MIXED FONT AT 6 CPI - DBCS 9 POINT') - DATA-TYPE ( 002 103 ) *

Extended Reporting Usage 7–1

Chapter

7 Extended Reporting Usage

Introduction

This chapter provides further explanation on printer definitions, JCL usage, andCA-Easytrieve/Plus program examples. Descriptions include usage of the morecommonly 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 inchresolution. The following conversion aids should be used when working withIBM printers:

Width (Pels) Pitch (Chars per inch/CPI)

48 5

40 6

32 7.5

24 10

20 12

16 15

1 pel = 1/240 inch

240 pels = 1 inch



Formula for converting PELS to Pitch:

240/pels = pitch

Formula for converting Pitch to PELS:

240/pitch = pels

Height (Pels) LPI (Lines per inch)

40 6

30 8

24 10

20 12

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. Thefirst 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/Plusprinter definition. All subsequent printer information is then given using APAcommands.

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 printedpage. 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 aslarge as possible to get the most advantage of a page mode printer (3800-3 or3820). Coding a value of U(32760) would be a good value.



To make a USER3801 printer definition, using the definition IBM3800C as aprinter model, usable for a single 10-pitch font with 6 LPI, code the printerdefinition 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 ASAJOB INPUT NULL DISPLAY filename #1 'GS10' STOP

To make a USER3802 printer definition, using the definition IBM3800D as aprinter 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:



To make a USER3804 printer definition using the definition IBM3800D as aprinter model usable for a 15-pitch font with 8 LPI, code the printer definition as:


With the JCL:





To make a USER3805 printer definition, using the definition IBM3800D as aprinter model, usable for a 15-pitch font with 10 LPI, code the printer definitionas:


With the JCL:



To make a USER3806 printer definition, using the definition IBM3800D as aprinter 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 )*



*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 tofont 1 (GS10), #2 refers to font 2 (GS12), #3 refers to font 3 (GS15), and #4 refersto font 4 (GB10).

FILE filename EXTENDED USER3806 ASAJOB INPUT NULL DISPLAY filename #1 'GS10' #2 'GS12' #3 'GS15' #4 'GB10' STOP

To make an IBM3820 printer definition, using the definition IBM3800E as aprinter model, usable for a 15-pitch EBCDIC font and a 7.5-pitch DBCS font with8 LPI, code the printer definition as follows. The default font is 15-pitch EBCDICand 7.5-pitch DBCS.

PRINTER NAME (IBM3820) MODEL (IBM3800E) - DEFAULT-FONT (3 103 203)** 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) - DATA-TYPE (3 103) - NAME ('MIXED FONTS')

With the JCL:

//filename DD SYSOUT=*,CHARS=(GS15,M32F)



In the CA-Easytrieve/Plus program, #3 (the default, if not specified) refers toEBCDIC font 3 (GS15), #2 refers to DBCS font 103 (M32F). Font 203 is used formixed EBCDIC and DBCS characters.

FILE filename EXTENDED IBM3820 ASAJOB 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 DDstatement as described in the above examples, or the information can be specifiedby 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 pertinentinformation) 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 onthe SETPRT statement, or the information can be specified in a Printer-ParameterMember.

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

Working with Line Compatibility Mode Printers



The IBM 3800 family of printers produces output with 240 dots (pels) per inchresolution. The following conversion aids should be used when working withIBM printers:

Width (Points) Pitch (Chars per inch/CPI)

7.2 10

6 12

4.8 15

1 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 iscontrolled 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 thanone WGCM.

To make a USER3801 printer definition, using the definition IBM3800A as aprinter model, usable for a set of 10-, 12-, and 15-pitch fonts, code the printerdefinition 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:




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 bereferenced by font number 5 (#5). CHAR GS15 would be referenced by fontnumber 9 (#9).

MVS FILE statement: FILE filenme EXTENDED USER3801 ASAVSE FILE statement: FILE filenme EXTENDED USER3801 SYSxxxJOB 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 aprinter model, usable for a set of 12-, 15- and 10-pitch fonts, code the printerdefinition 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:


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 fontnumber 7 (#7).

MVS FILE statement: FILE filenme EXTENDED USER3802 ASAVSE FILE statement: FILE filenme EXTENDED USER3802 SYSxxxJOB 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.

Working with XEROX Printers



The XEROX 8700 and 9700 printers produce output with 300 dots per inchresolution. The following conversion aids should be used when working withXEROX printers:

Width (Dots) Pitch (Chars per inch/CPI)

30 10

22 13.6

20 15

1 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)

50 6

37 8.1

28 10.7

24 12.5

Formula for converting DOTS to LPI:

300/dots = lpi

Formula for converting LPI to DOTS:

300/lpi = dots



Assume that you define a PDE, call it PDE200, and use the following fonts:

font width approx typename (dots) point size faceL0112A 22 9 1200L02BOA 20 9 BOLDL03BOA 22 7 BOLDL0412A 20 7 1200L0512A 30 12 1200L05SCA 30 12 SCRIPT

The following CA-Easytrieve/Plus extended reporting printer definition wouldbe 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 followingCA-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 ASAVSE FILE statement: FILE filenme EXTENDED XEROX01 SYSxxxJOB 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

Index–1

Index

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/Plusreporting characteristics, 3-7syntax, 5-1

Character cell, defined, 3-5

Character sets, mixing, 2-1

COL parameterLINE statement, 5-10TITLE 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-36line mode, 3-38structured fields, 3-37

Control code specification, printer, 4-6

CONTROL parameter, DISPLAY statement, 5-3

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-2HEADING, 5-2

DEVICE, PRINTER command, 4-24

Diagnostic message, 4-37format, 4-36

DISK, PRINTER command, 4-24

DISPLAY statement, 5-3COL, 5-3CONTROL, 5-3POS, 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–2 CA-Easytrieve/Plus Extended Reporting Facility Guide

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-5syntax 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-5EXTENDED, 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

Fontdefined, 2-2, 3-1height, 3-5identification, 2-6mixing different sizes, 3-48sizes, 3-4width, 3-6

Font characteristics, 3-39

Font codes, 2-5

FONT command, 4-29ALIGN, 4-34COMPLEX, 4-34DATA-TYPE, 4-32DBCS, 4-32EBCDIC, 4-32FUNCTION-HEADER, 4-33FUNCTION-TRAILER, 4-33HEIGHT, 4-31NAME, 4-31NUMBER, 4-30OVERPRINT-CODE, 4-32SPACE-REPLACE, 4-35WIDTH, 4-30

Fontsfunction header and function trailer, 3-40height and width, 3-40multiple in a report, 2-2overprint codes, 3-40space replacement, 3-40

Format page, 3-26, 3-32

FORMAT PAGE parameterPRINTER command, 4-16

Function codes, 3-16control information, 3-10text, 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 parameterDEFINE statement, 5-2

HEIGHT parameter, FONT command, 4-31

Height, font, 3-5

Index–3

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-1options module, 4-2

L

Line Compatibility Mode printers, 7-7

Line complexes, 3-45

Line elementcalculating length, 3-48

LINE elementprocessing, 3-47

Line feed operations, 3-29

Line mode, 3-27

Line mode printers, 3-14overprint and function codes, 3-16

Line printer, 7-7

LINE statementCOL, 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 fieldfont selection, 3-56printing, 3-52support of merge overprint, 3-58

MODEL parameter, PRINTER command, 4-13

Multiple print lines, 3-7

N

NAME parameterFONT command, 4-31PRINTER command, 4-13SYSPRINT Command, 4-10

NUMBER parameter, FONT command, 4-30

O

Options moduleinstallation, 4-2

OS/390 printer, 7-6

Overprintcodes, 3-9, 3-15function codes, 3-16gap, 3-58techniques, 3-17

OVERPRINT-CODESFONT command, 4-32PRINTER command, 4-17

P

Page printers, 3-12, 3-25function codes, 3-12print record diagram, 3-14set horizontal position, 3-12set vertical position, 3-12


PAGESIZE parameter, REPORT statement, 5-6

Paper control codescarriage control, 3-9, 3-24systems, 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-61overprint gap, 3-58

Print items, 3-10defined, 3-1

Print lines, 3-8

PRINT operand, PRINTER command, 4-17

Print overprint, 3-19, 3-61no overlaying, 3-21

Print record, defined, 3-2

Print records, 3-8, 3-34carriage control, 3-34function codes, 3-34maximum length, 3-34print items, 3-34

Printer characteristics, 3-10diagram, 3-11units of measure, 3-3

PRINTER command, 4-11CONCATENATE, 4-27DBCS-CODE, 4-23DEFAULT-FONT, 4-22DEFAULT-FORM, 4-21DEFAULT-SIZE, 4-20DEVICE, 4-24DISK, 4-24END PAGE, 4-16FCB, 4-19FILE-HEADER, 4-28FILE-TRAILER, 4-29FORMAT, 4-16MAX-RECORD, 4-26

MERGE, 4-17MODEL, 4-13OVERPRINT-CODES, 4-17POINT-SKIP, 4-19PRINT, 4-17PRINTER, 4-25RECORD, 4-25RECORD-END, 4-27RECORD-PAD, 4-28REPEAT-CHAR, 4-28shift-in, 4-19shift-out, 4-19START-PAGE, 4-16STRUCTURED-FIELDS, 4-15TAPE, 4-25TERMINAL, 4-18

PRINTER CommandNAME, 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

PrintersAll Points Addressable, 7-1line, 7-7supported, 4-1XEROX, 7-9

Publications, CA-Easytrieve/Plus, 1-2

R

Record formatline mode, 3-33page printers, 3-31

RECORD, PRINTER command, 4-25

RECORD-END, PRINTER command, 4-27

RECORD-PAD, PRINTER command, 4-28

Recordsblocked, 3-35concatenated, 3-36unblocked, 3-36

Index–5

REPEAT-CHAR, PRINTER command, 4-28

Report definition statements, 5-8

Report layout processing, 3-47

Report processing, 5-4

REPORT statement, file directing parametersPRINTER, 5-6

REPORT statement, format SIZE determinationparameters, 5-5

REPORT statement, spacing control parametersLINESIZE, 5-7PAGESIZE, 5-6SKIP, 5-7SPACE, 5-7TITLESKIP, 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-25records, 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-9SYSNO, 4-10

SYSPRINT CommandNAME, 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 measuredefined, 3-2

Units of measuretable, 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


X

XEROX Printers, 7-9

XRPT commands, 4-5

Documents

For OS/390, VM, VSE - jmit.com · Point Skip Vertical Spacing ... Each record represents a logical print line that CA-Easytrieve/Plus builds ... CA-Easytrieve/Plus Extended Reporting