OVERLAY Command

The OVERLAY command is used to identify an electronic overlay to be included in the print file. This function is similar to the SEGMENT command. A separate OVERLAY command is required for each overlay, including all overlay names that can be used with the OVERLAY VARIABLE keyword on PRINTLINE, LAYOUT, or XLAYOUT. A maximum of 254 OVERLAY commands (each of the 254 names must be unique) can be specified for each page format.

The OVERLAY commands are nested within the PAGEFORMAT command. For Traditional:

PAGEFORMAT
   [ TRCREF ]
   [SEGMENT ]
   [ OVERLAY ]
   …
   [ OVERLAY ]

For Record Format and XML:

PAGEFORMAT
   [SEGMENT ]
   [ OVERLAY ]
   …
   [ OVERLAY ]

An overlay can be requested in the following two ways:

Place the overlay by using the OVERLAY subcommand on the PRINTLINE command (Traditional), the LAYOUT command (Record Format), or the XLAYOUT command (XML).
Enter an Include Page Overlay (IPO) structured field in the line data. The name of the overlay on the IPO structured field must match exactly the overlay that is identified by this command. The IPO must specify a value of X'FFFFFF' for the X and Y offset parameters if the overlay is to be placed relative to the current line position.

To include page overlays without using the IPO structured field, see the PRINTLINE Command.

OVERLAY

Identifies the overlay that is positioned on the page.

x-name

The user access name (external name) for the overlay. x-name can be unquoted or enclosed in quotation marks.

unquoted-name: An unquoted overlay name can be up to 6 characters. It is folded to uppercase, has an O1 prefix added to it, and is translated to EBCDIC code page 500 if necessary.
'quoted-name': A quoted overlay name can be up to 8 characters. No translation or case folding is done.