Code this command once for each extended reporting printer that
CA-Easytrieve/Plus supports. This command defines the characteristics of the printer. By default, CA-Easytrieve/Plus supports no extended reporting printers, so you must specify one PRINTER entry to activate the extended reporting options module.
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 ....])]
Keywords
NAME
NAME is a required keyword on the PRINTER command. It defines the extended reporting printer name that is associated with the printer characteristics defined by:
■ The other keywords on this PRINTER command.
■ The fonts defined immediately after this PRINTER command.
(xrpt-name)
Xrpt-name is the 1-to 8-character extended reporting printer name. This name is user selectable but it must conform to the requirements of a CA-Easytrieve/Plus name. This means that it cannot contain any of the CA-Easytrieve/Plus
delimiters including commas, apostrophes, left and right parenthesis, colons, and spaces.
Code xrpt-name on the CA-Easytrieve/Plus FILE statement when using the file for extended reporting output. The xrpt-name associates the printer
characteristics and fonts defined for this extended reporting printer with any printed output directed to that CA-Easytrieve/Plus file. See the
CA-Easytrieve/Plus FILE statement for more details. MODEL
MODEL is the keyword that generates the characteristics for an extended reporting printer by using one of a set of model definitions. MODEL,
STRUCTURED-FIELDS, OVERPRINT-CODES, and TERMINAL are mutually exclusive. For information on the extended reporting models, refer to Chapter 6. Where an installation has a printer whose characteristics are covered by one of the models, the use of the MODEL keyword means that the definition of the printer's characteristics, through the use of the other PRINTER command
keywords, is not necessary. On the other hand, the use of a model definition does not prohibit the use of the other keywords to modify the model's parameters. This means, if you code other keywords in addition to the MODEL keyword, then the additional options act as overrides for the characteristics established by the model.
The use of the MODEL keyword also results in a set of fonts being associated with the defined extended reporting printer. You can modify or expand these fonts by using the FONT command after this PRINTER command.
model-name
Model-name is the name of a model-extended reporting printer whose
characteristics are known by the Extended Reporting Facility. The valid entries for model-name are:
Model-Names Description
IBM3800A Defines the characteristics that support the IBM 3800 Model I, II, III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers in compatibility mode. This model does not include support of DBCS data through the Extended Graphic Character Set.
IBM3800B Defines the characteristics that support the IBM 3800 Model II, VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers (DBCS support) in compatibility mode. This model includes support of DBCS data through the Extended Graphic Character Set. IBM3800C Defines the “All Points Addressable” characteristics that
support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The “All Points
Addressable” coordinates are generated as absolute
coordinates on a page. This model does not include support of DBCS data through the Extended Graphic Character Set. IBM3800D Defines the “All Points Addressable” characteristics that
support the IBM 3800 Model III, VI, VIII, IBM 3812, IBM 3820, IBM 3827, and IBM 3835 printers. The “All Points
Addressable” coordinates are generated as relative
coordinates on a page. This model does not include support of DBCS data through the Extended Graphic Character Set. IBM3800E Defines the “All Points Addressable” characteristics that
support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The “All Points Addressable” coordinates are generated as absolute coordinates on a page. This model includes support of DBCS data through the Extended Graphic Character Set.
IBM3800F Defines the “All Points Addressable” characteristics that support the IBM 3800 Model VI, VIII, IBM 3820, IBM 3827, and IBM 3835 printers. The “All Points Addressable” coordinates are generated as relative coordinates on a page. This model includes support of DBCS data through the Extended Graphic Character Set.
SHOWA7 Defines support for the SHOWA Informational Systems SP-7 printer.
Model-Names Description
M8250 Defines the characteristics of the MELCOM 8250 printer. M8290 Defines the characteristics of the MELCOM 8290 printing
system.
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 characteristics and fonts automatically defined by the above set of models.
[STRUCTURED-FIELDS]
This keyword indicates if the extended reporting printer being defined supports Structured Fields. Printers that support Structured Fields permit Page or “All Points Addressable” printing. The STRUCTURED-FIELDS, MODEL, OVERPRINT-CODES and TERMINAL keywords are mutually exclusive. When using this keyword, you must define two values. The first hexadecimal string defines the data to be used as the printer control code for Set Vertical Position. The second value defines the hexadecimal string for the printer's Set Horizontal Position code.
value-1
This hexadecimal value defines the control data that CA-Easytrieve/Plus uses to establish the Y-direction coordinate on the current page.
Define value-1 using the characters A - F and the numbers 0 - 9. Additionally, you must include the special control code indicator for the insertion of either the Set Absolute Y-direction address (character 2 = V) or the Set Relative Y-direction address (character 2 = W). For information on the three-byte code, refer to “XRPT Commands Overview,” earlier in this chapter.
value-2
This hexadecimal value defines the control data that CA-Easytrieve/Plus uses to establish the X-direction coordinate on the current page.
Define value-2 using the characters A - F and the numbers 0 - 9. Additionally, you must include the special control code indicator for the insertion of either the Set Absolute X-direction address (character 2 = H) or the Set Relative X-direction
START-PAGE
CA-Easytrieve/Plus requires this keyword if the printer being defined is a Page Printer (STRUCTURED-FIELDS keyword is specified). If the printer is not a Page Printer, it is invalid to specify this keyword and if specified, an error message is output.
This keyword requires at least one value. Each value defines a hexadecimal string that consists of the characters A - F and the numbers 0 - 9. In addition, you must incorporate the appropriate three-byte code into the definition of the value if any of the control codes require the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character 2 = R). For information on the three-byte code, refer to “XRPT Commands
Overview,” earlier in this chapter. [FORMAT PAGE]
This keyword is optional if the printer being defined is a Page Printer
(STRUCTURED-FIELDS keyword is specified). If the printer is not a Page Printer, it is invalid to specify this keyword and if specified an error message is output. This keyword requires at least one value. Each value must be a hexadecimal value that defines control data that CA-Easytrieve/Plus inserts at the front of each physical Format Page record output to this printer's data set.
CA-Easytrieve/Plus does not include this code in any File Header, File Trailer, Start of Page, or End of Page records.
Define each value using the characters A-F and the numbers 0-9. Additionally, if the control code requires the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character Z = R), you must include the appropriate three-byte code in the definition of the value. For information on the three-byte code, refer to “XRPT Commands Overview,” earlier in this chapter.
[END-PAGE]
This keyword is optional if the printer being defined is a Page Printer
(STRUCTURED-FIELDS keyword is specified). If the Printer is not a Page printer, it is invalid to specify this keyword.
This keyword, requires at least one value. Each value defines a hexadecimal string that consists of the characters A - F and the numbers 0 - 9. In addition, you must incorporate the appropriate three-byte code into the definition of the value if any of the control codes require the insertion of either a Record Length special control code (character 2 = L) or a Record Count special control code (character 2 = R). For information on the three-byte code, refer to “XRPT Commands
[OVERPRINT-CODES]
This keyword indicates if the extended reporting printer supports Overprint Codes. The OVERPRINT-CODES, MODEL, STRUCTURED-FIELDS, and TERMINAL keywords are all mutually exclusive.
If the printer requires control information immediately after the Paper Control code but before any Function codes or print text, then you must code this keyword.
If you do not code this keyword, CA-Easytrieve/Plus does not support Overprint codes for this extended reporting printer.
This keyword has two required operands: { MERGE}
{ } { PRINT}
This required operand defines the technique that the printer uses to combine multiple print records into a single print line.
Code the MERGE operand when the printer supports Overprint Codes and uses the Merge Overprint technique to combine multiple print records into the one print line.
Code the PRINT operand when the printer being defined supports Overprint Codes and uses the Print Overprint technique to combine multiple print records into the one print line.
The order in which CA-Easytrieve/Plus outputs overprint print records is controlled by the font number of the font defining the Overprint Code value. The first overprint record is the record whose Overprint Code is defined on a font with the lowest font number. The last overprint print record is the record whose Overprint Code is defined on a font with the highest font number.
If your extended reporting printer requires overprint records in a specific order, you must take special care in assigning font numbers to the font for this printer. You must define the font numbers such that CA-Easytrieve/Plus can output the print records in the correct order. For more details regarding font numbers, see the NUMBER and OVERPRINT-CODE keywords of the FONT command later in this chapter.
value-3
This required operand identifies the maximum number of print records that can be generated for the one print line. Value-3 must be a number between 1 and 256.
{TERMINAL}
This keyword indicates that the output for this extended reporting printer is to be viewed on a terminal that supports Double Byte (KANJI) data.
CA-Easytrieve/Plus formats the print records such that you can view the output on a terminal such as the IBM 5550. The important distinction between this type of extended reporting printer and an extended reporting printer that supports function codes is that the function codes for a TERMINAL extended reporting printer occupy character positions on the screen. Normally, function codes in a print record are instructions to the printer and do not occupy any space on the final print line. They are in fact absorbed by the printer. The display devices supported by the TERMINAL keyword do not delete the function codes - they occupy space on the display line equivalent to the size of one EBCDIC character. The two required values for this keyword define the appropriate codes to identify DBCS (Double Byte) data from EBCDIC data on a display line. The first value (Shift-out code) defines the control data to appear before DBCS data (Shift out of EBCDIC). The second value (Shift-in code) defines the control data to appear after DBCS data (Shift into EBCDIC). Each of these codes is assumed to occupy the space of one EBCDIC character regardless of the control codes length. The size of EBCDIC characters and DBCS characters is assumed fixed for this extended reporting printer type. The size of one DBCS character is assumed by CA-Easytrieve/Plus to be twice the size of one EBCDIC character. Therefore, CA-Easytrieve/Plus automatically generates three fonts for this extended reporting printer.
■ Font Number 1 is for EBCDIC data and its size is assumed to be 1.00. This is
the default EBCDIC font.
■ Font Number 2 is the DBCS data and its size is assumed to be 2.00. This is the
default DBCS font.
■ Font Number 3 is for MIXED data and it is defined as a combination of fonts
1 and 2. This is the default MIXED font.
Because the fonts are fixed by CA-Easytrieve/Plus, you cannot define additional fonts by the FONT command after this PRINTER command.
The TERMINAL keyword is mutually exclusive with the OVERPRINT-CODES, MODEL, and STRUCTURED-FIELDS keywords.
Only ANSI or Machine carriage control systems with an FCB are supported for this printer type so you cannot code the POINT-SKIP keyword. Also, you cannot specify the DEFAULT-FORM, DEFAULT-SIZE, DEFAULT-FONT,
CONCATENATE, or REPEAT-CHAR keywords.
shift-out
This required value defines a hexadecimal value that CA-Easytrieve/Plus inserts prior to any DBCS data in a print record directed to this extended reporting printer. Define this value using the characters A-F and the number 0-9. shift-in
This required value defines a hexadecimal value that CA-Easytrieve/Plus inserts after any DBCS data in a print record directed to this extended reporting printer. Define this value using the characters A-F and the number 0-9.
[FCB]
FCB is an optional keyword that indicates if the printer being defined supports a Forms Control Block (FCB). This keyword is only valid for Line Mode printers. If the printer supports an FCB, specify the letter Y (the default). Knowing that the printer supports an FCB means that CA-Easytrieve/Plus uses ANSI Forms Control codes, leaving the line spacing to the definitions in the FCB.
If the printer supports an FCB, but the printer requires Machine carriage control codes, specify the letter M. CA-Easytrieve/Plus performs the same processing as that defined for ANSI codes above except that the carriage control values are Machine code equivalent of the ANSI codes.
If the printer does not support an FCB, specify the letter N. If you do not code the POINT-SKIP keyword, CA-Easytrieve/Plus assumes the carriage control system to be ANSI without an FCB. If you code the POINT-SKIP keyword, the only valid value for the FCB keyword is N.
[POINT-SKIP]
For Line Mode printers that do not support FCB or ANSI Paper Control codes, or that do not support Machine Control codes, you must use the POINT-SKIP keyword to define the appropriate skip codes. This keyword is only valid if the operand for the FCB keyword is specified as N (no FCB support). If the operand for the FCB keyword is not N or the printer is a Page printer, this operand is invalid.
When you define the POINT-SKIP keyword, you must also include the CONCATENATE keyword with a value of Y.
The POINT-SKIP requires you to define two hexadecimal values: value-4
value-5
This hexadecimal value defines the code that CA-Easytrieve/Plus uses to invoke a point skip operation. The code is the Paper Control code for print records that must start a new line. The point skip operation requires the insertion of a number of H-units into the control code to indicate the number of H-units to skip before positioning the next print line. Specify value-5 using the three-character code for the point skip special control code (character 2 = S). For information on the three-byte code, refer to the XRPT Commands Overview topic earlier in this chapter.
[DEFAULT-SIZE]
The DEFAULT-SIZE keyword defines the width and optionally the height that CA-Easytrieve/Plus uses to convert the values assigned to various report and printing attributes. These attributes include LINESIZE, PAGESIZE, and so on. These attributes are currently character-based settings. To convert them into the same Unit of Measure used to define the heights and widths of fonts for this printer, CA-Easytrieve/Plus must multiply their character based settings by a base width and height that are expressed in terms of the appropriate W-units and H-units. Use this keyword to assign the base width and height.
You need only code this keyword if the base width and height of the printer is to be different from the width and height assigned to the default EBCDIC font. If you do not code the keyword, then CA-Easytrieve/Plus uses the width and height of the default EBCDIC font.
font-1
CA-Easytrieve/Plus always requires this value when you code the
DEFAULT-SIZE keyword. Font-1 identifies the font whose width is to be the default W-unit for this extended reporting printer. Font-1 is the font number assigned to the font whose width is to be the default width. The data format of the identified font must be EBCDIC or DBCS. The font identified by font-1 cannot define a Line Complex. CA-Easytrieve/Plus processes the W-unit of the
identified font as the default print width of the printer. CA-Easytrieve/Plus then uses this value to convert character based values, such as LINESIZE into the appropriate W-unit of the printer.
font-2
You need only code this value for printers that do not support an FCB (Forms Control Block).
Font-2 identifies the number of either an EBCDIC or DBCS font whose height (expressed in H-units) is the default height of each line that CA-Easytrieve/Plus prints (that is the Base Height for this printer). Font-2 cannot define a Line Complex. CA-Easytrieve/Plus multiplies this value by the value of PAGESIZE to
[DEFAULT-FORM]
The DEFAULT-FORM keyword defines the width and height that
CA-Easytrieve/Plus uses to validate specifications of LINESIZE, PAGESIZE, and so on, in a CA-Easytrieve/Plus program. These values ensure that the print lines that CA-Easytrieve/Plus generates do not exceed the printer's page boundaries. If you do not code this keyword, CA-Easytrieve/Plus does not perform checking of the print lines. This keyword is required when defining a Page Printer.
W-units-2 and H-units-2 can only be specified for the DEFAULT-FORM keyword