You are here: Section Rules Reference > Section Rules Summary > IncOvSym

IncOvSym

Use this section level rule to increment an overflow variable. The overflow variable is a counter that tracks of the number of overflow values processed for a section. This overflow variable is incremented as records are processed and as the overflow increases.

This rule increments the overflow symbol you specify in the data field. Use the ResetOvSym rule to reset the variable for the next transaction that might overflow.

Syntax

IncOvSym (OverflowVAR,SectionName,X)

Use the X parameter to limit the IncOvSym rule to a single execution and also determine when the rule is executed. You control the execution of the rule by including the X parameter, as shown here:

Parameter

Description

OverflowVAR

Specify the overclow symbol.

SectionName

Specify the name of the section.

X

(Optional) Here you specify when the system should execute the IncOvSym rule by choosing one of these options:

F - Tells the system to execute the IncOvSym rule after the first page.

L - Tells the system to execute the IncOvSym rule after the last page.

1-9 - Tells the system to execute the IncOvSym rule after the corresponding page. For instance, enter 3 to tell the system to execute the rule after the third page.

Keep in mind you can enter only one option. If you enter more than one character, the system evaluates the first character and ignores the rest.

If the requesting section is not a multipage section, the system ignores this parameter. If you enter a character other than F, L, or 0-9, an error message appears. If you enter zero (0), nothing happens because there is never a page zero.

Note Be sure to thoroughly test your environment when you use this parameter. Different results are created depending on the number of pages in the FAP file, the type of overflow, when pagination occurs, and type of data fields on the different pages in the FAP file.

See also