Overlay Names

To identify overlays by name, you must be aware of the three possible names for an overlay: a local name (SLSRPT) and two system names (M1001, O1M1001). The local name is used only within the PPFA command stream; its use is optional. An example of this is SLSRPT in the first OVERLAY command of the previous sample command stream.

The system name identifies an overlay in the library. It has two forms: the user-access name (M1001 in the sample set of commands) and the library-resource name. Of these, you use only the user-access name. PPFA automatically adds the O1 overlay prefix to the user-access name, which identifies the resource in the library. An overlay referenced through a form definition built with PPFA, therefore, must begin with the O1 prefix. An example of the result is O1M1001, the library-resource name.

You can make up your own local name for an overlay. However, the local name must be used in the OVERLAY subcommand in the subgroup if it is used in an OVERLAY command for the copy group. If it is not, the subgroup must specify the user-access name, as has been done for overlay M1002 in the example.

This example, specifying copies and electronic overlays, also specifies the number of copies of each subgroup. More than one copy of printed output can be requested by placing the COPIES subcommand and the number of copies of the subgroup desired in the SUBGROUP command. This example specifies that two copies of the first subgroup and three copies of the second subgroup are to be printed. The next figure shows the result of printing a job that includes overlays as specified in the sample command stream at the beginning of this example.