COPYMOD Statement

A copy modification module consists of header information, followed by one or more modification segments. The header information contains the module's name and length. Each modification segment contains the text to be printed, identifies the copy (or copies) the text applies to, and specifies the position of the text on each page of the copy.

A COPYMOD statement specifies the contents of one of the modification segments of a copy modification module. More than one COPYMOD statement can be coded in an operation group; all COPYMOD statements so coded apply to the same copy modification module.

IEBIMAGE analyzes the modification segments specified for a copy modification module to anticipate line overrun conditions that may occur when the module is used in the printer. A line overrun condition occurs when the modification of a line is not completed in time to print that line. The time available for copy modification varies with the vertical line spacing (lines per inch) at which the printer is being operated.

When IEBIMAGE builds a copy modification module from your specifications, the program calculates an estimate of the time the modification will require during the planned printing. If the modification can be done in the time available for printing a line at 12 LPI (lines per inch), it can also be done at 6 or 8 LPI (for the Model 1), or 6, 8, or 10 LPI (for the Model 3). (Note that 6, 8, 10 and 12 LPI are the only print densities available on the 3800 Model 3 printer.) However, if the copy modification module being built is too complex to be done in the time available for printing a line at 6 LPI, it certainly cannot be done at 8, 10 (for the Model 3 only), or 12 LPI. (Note that at 10 and 12 LPI there is much less time available for printing a line than at 6 LPI.)

When IEBIMAGE determines that a copy modification module is likely to cause an overrun if it is used when printing at a specified number of lines per inch, the program produces a warning message to that effect. If the warning applies to 6 LPI, the overrun condition is also applicable to 8, 10 (for the Model 3 only), and 12 LPI. If the warning applies to 8 LPI, the condition is also applicable for 10 (for the Model 3 only) and 12 LPI. If the warning applies to 10 LPI, the condition also applies to 12 LPI.

If you are planning to use a particular copy modification module only while printing at 6 LPI, you can request suppression of the unwanted warning messages for 8, 10 (for the Model 3 only), and 12 LPI by specifying the OPTION statement with 6 as the value of the OVERRUN parameter. If you are planning to print only at 8 LPI, you can use the OPTION statement with OVERRUN=8 to request suppression of the unwanted warning messages for 10 (for the Model 3 only) and 12 LPI. The copy modification text can be printed using the same character size or style, or one different from the size or style used to print the data in the output data set.

Related reading:

For more information on coding OVERRUN, see Using OVERRUN.
For information about using your copy modification module, see IBM 3800 Printing Subsystem Programmer's Guide.

The COPYMOD statement must always be followed by a NAME statement or another COPYMOD statement and can be preceded by an INCLUDE statement. When more than one COPYMOD statement is coded, IEBIMAGE sorts the statements into order by line number within copy number. A COPYMOD statement with no operands specified, followed by a NAME statement that identifies a copy modification module, is used to format and print the module. The syntax of the printed module is shown under COPYMOD Module Listing.

The syntax of the COPYMOD statement, when used to create a copy modification module's segment, is:

Label	Statement	Parameters
[label]	COPYMOD	COPIES=(starting-copy[,copies])
		,LINES=(starting-line[,lines])
		,POS=position
		,TEXT=(([d]t,'text') [,([d]t,'text') ][,...])

where:

COPIES=(starting-copy[,copies])

specifies the starting copy number and the total number of copies to be modified.

starting-copy: specifies the starting copy number and is expressed as a decimal integer from 1 to 255. The starting-copy value is required.
copies: specifies the number of copies that are to contain the modifying text and is expressed as a decimal integer from 1 to 255. When copies is not specified, the default is 1 copy.

The sum of starting-copy and copies cannot exceed 256 (255 for JES3).

LINES=(starting-line[,lines])

specifies the starting line number and the total number of lines to be modified.

starting-line: specifies the starting line number, and is expressed as a decimal integer from 1 to 132. The starting-line value is required.
lines: specifies the number of lines that are to contain the modification segment's text, and is expressed as a decimal integer from 1 to 132. When lines is not specified, the default is 1 line.

The sum of starting-line and lines cannot exceed 133. If the sum exceeds the number of lines specified for the form size (in the FCB statement), the modifying text is not printed on lines past the end of the form.

POS=position

specifies the starting print position (the number of character positions from the left margin) of the modifying text.

position: specifies the starting print position and is expressed as an integer from 1 to 204. See the restriction noted for the TEXT parameter below.

The maximum number of characters that can fit in a print line depends on the pitch of each character and the width of the form.

For the maximum number of characters that can fit in a print line for each form width, see IBM 3800 Printing Subsystem Programmer's Guide.

TEXT=(([d]t,'text') [,([d]t,'text') ][,...])

specifies the modifying text. The text is positioned on the form based on the LINES and POS parameters and replaces the output data set's text in those positions.

d: specifies a duplication factor (that is, the number of times the text is to be repeated). The d is expressed as a decimal integer from 1 to 204. If d is not specified, the default is 1.
t: specifies the form in which the text is entered: C for character, or X for hexadecimal. The t is required.
text: specifies the text and is enclosed in single quotation marks.
If the text type is C, you can specify any valid character. Blanks are valid characters. A single quotation mark is coded as two single quotation marks. You are not allowed to specify a character that results in a X'FF'. If the text type is X, the text is coded in increments of two characters that specify values between X'00' and X'FE'. You are not allowed to specify X'FF'.

The sum of the starting print position (see the POS parameter) and the total number of text characters cannot exceed 205. If the width of the form is less than the amount of space required for the text (based on character pitch, starting position, and number of characters), characters are not printed past the right margin of the form.

If a text character specifies a character whose translation table entry contains X'FF', the printer sets the Data Check error indicator when the copy modification module is loaded. This error indicator can be blocked.