Components of a Reporting Facility Program › Run Control

Run Control

Run Control commands can appear anywhere within the Reporting Facility program and have the following restrictions:

• When generating a report in Primary or Secondary modes, the USER command must be either the first command in the input stream or follow the first OPTION command in the input stream.

  Note: The USER command is not required when operating in the Write-Only or Library Maintenance modes.

• Compiler control commands (EJECT, SKIP1,2,3, and NOTE) can appear anywhere in the input stream except in Library Maintenance mode.
• The OPTION command can appear anywhere in the program, in any operating mode. It is recommended, however, that you place it at the beginning of the input stream.
• The CALL command can appear anywhere in the program, regardless of operating mode. In Library Maintenance mode, however, the CALL command is recognized only when it is part of a specific member to be cataloged.

Run Control commands enable you to analyze the external requirements of a particular program and establish the working environment as soon as possible during the program development cycle. This reduces the programming effort and produces mode efficient programs.

The following is the basic diagram of the Run Control commands within a program:

┌────────┐
│        │
│    1   │ Run Control
│        │
├────────┤
│        │
│   2A   │ Input File Definition
│        │
├────────┤
│        │
│   2B   │ GSA Definition
│        │
├────────┤
│        │
│    3   │ Data Manipulation/File Reading
│        │
├────────┤
│        │
│ 4A,4B  │ Report Definition/Output File Definition
│        │
└────────┘