Subcommands

COPIES Subcommand
COPIES n
Specifies how many copies of each page are to be printed.
n
Defines the number of copies (the maximum number is 255). When BACK is specified within a SUBGROUP command, the system counts the front pages printed (the actual number of sheets) not copies made (front and back). The default is 1.
FLASH Subcommand
 FLASH {NO | YES}
Specifies whether to use forms flash.
    Note:
  1. The FLASH subcommand is used only on IBM 3800 printers.
  2. When forms flash is used, its name must be specified in the job control language for the print job. The operator must place the correct negative into the 3800 when the job is ready to print.
NO
Specifies that forms flash does not occur.
YES
Specifies that forms flash occurs.
BACK or FRONT or BOTH Subcommand
{BOTH | BACK | FRONT}
These optional subcommands specify whether the subgroup is for both sides of a sheet or for only the front or the back side.
    Note:
  1. Subgroups must specify FRONT and BACK if an overlay, suppression, or forms flash appears on one side but not on the other.
  2. The FRONT and BACK subgroups must have the same number of copies.

    If the number of copies differs, the COPIES parameter of the BACK subgroup is ignored, and a warning message is issued.

  3. The FRONT and BACK subcommands must occur in pairs.
  4. If the FRONT and BACK subcommands are specified with DUPLEX NO (in the FORMDEF or COPYGROUP commands), PPFA issues an error message and does not create the form definition.
BACK
Specifies that this SUBGROUP command is for the back sides of the sheets.

A subgroup with a BACK subcommand must have a FRONT subcommand in the preceding subgroup.

FRONT
Specifies that this subgroup is for the front sides of the sheets.

If a DUPLEX subcommand in a FORMDEF or COPYGROUP command is specified with a parameter other than NO and the FRONT subcommand is specified in a SUBGROUP command, the next SUBGROUP command must have a BACK subcommand.

BOTH
Specifies that this subgroup is used for both sides of the sheet.

This is the default when DUPLEX is specified in the copy group.

If BOTH is specified with DUPLEX NO (in a FORMDEF or COPYGROUP command), PPFA issues a warning message and ignores the BOTH subcommand.

BIN Subcommand
[[BIN 1] | [BIN {n | MANUAL | ENVELOPE} [MEDIANAME qstring] [COMPID m]]
Specifies the paper source. This subcommand should be used only for printers that have more than one paper source.
Note: If you specify the BIN subcommand, you must also specify at least one of the legal parameters.
n
An integer between 1 and 255 that is the Media Source Id (also known as the bin number).
1
Selects the primary paper source.
2–255
Selects another paper source. If the specified bin does not exist on your printer, the default paper source for that printer is used. For more information about paper sources on your printer, refer to your printer publications. Using a value of 100 is the same as specifying MANUAL.
MANUAL
Selects manual feed as a paper source on those printers that support manual feed. For more information, refer to your printer publications.
ENVELOPE
Selects an envelope paper source on those printers that support this function. For more information, refer to your printer documentation.
    Note:
  1. Bin selection is overridden by the printer if the form defined to each bin is the same form number. Only the primary bin is selected.
  2. The primary source usually contains either letter-size (U.S.) or A4 (I.S.O.) paper. Other paper sources are used for less common paper sizes (such as legal-size) and for special paper (such as colored stock or pre-printed letterhead on heavy bond).
  3. If duplexing is requested and you select from the front side from one bin and the back side from another bin, a warning message is issued and the printer takes the paper from the bin specified on the front side.
MEDIANAME
Selects a media source by specifying an agreed-upon name for the bin. For a current list of the valid media names, see PPFA Media Names.
qstring
Up to 12 characters within single quotes specifying the media source name. On some printers, this name is pre-set into the printer; on others, it also can be entered into the printer by the user. Refer to your printer documentation for further information.
COMPIDm
Selects a bin based on the component ID.
Note: For a current list of component ids, see PPFA Media Names. Component ids from 12,288 to 268,435,455 are reserved for the user.
OUTBIN Subcommand
OUTBIN n
Specifies the destination bin number for any pages directed by this form definition. Copygroups and subgroups in this form definition that do not specify an output bin number inherit this bin number.
OVERLAY Subcommand
OVERLAY name…
Specifies the electronic overlays that are to be used with this subgroup.
name
Specifies either the local or user-access name. A maximum of eight names can be specified within a subgroup.
PFO
Specifies that this overlay is invoked as a Medium Printed Form Overlay. Only one PFO is allowed in a subgroup. A subgroup PFO can not be specified along with an N_UP PFO,
    Note:
  1. If the local name is used, it must be defined in an OVERLAY command before it can be referenced.
  2. PPFA does not check for duplicate user-access names.
SUPPRESSION Subcommand
SUPPRESSION name…
Specifies that the named fields are suppressed. These must be text-only fields.
name
Specifies a alphanumeric name of 1 to 8 characters (local name) of the text field to be suppressed. A maximum of eight names can be specified within a subgroup.

The suppression field named here must be defined in a SUPPRESSION command following the FORMDEF command before it can be referenced. See SUPPRESSION Command.

Parent topic: SUBGROUP Command