OVERLAY Command
OVERLAY x-name [NOPRELOAD |
PRELOAD [NOPRERIP |
PRERIP [RIPROTATE {0 | 90 | 180 | 270}…]]]] ;
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 may be used with the OVERLAY VARIABLE keyword on PRINTLINE, LAYOUT or XLAYOUT. A maximum of 254 OVERLAY commands can be specified for each page format. Each of the 254 names must be unique
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 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 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 (Traditional).
- 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 quotes.
- unquoted-name
- An unquoted overlay name can be up to 6 characters. It is folded to upper case, has
a
O1
prefix added to it, and is translated to EBCDIC codepage 500 if necessary. - 'quoted-name'
- A quoted overlay name can be up to 8 characters. No translation or case folding is done.