AddOvFlwSym

Use this procedure/function to create an overflow symbol. This procedure provides DAL with an equivalent to the Documaker Server SetOvFlwSym rule that is placed in the AFGJOB.JDT file.

Syntax

AddOvFlwSym (Form, Symbol, MaxRecords)

Parameter

Description

Form

Enter the name of the form that contains the fields on which overflow processing will occur.

Symbol

Enter the character you want to use as the overflow symbol.

MaxRecords

Enter the maximum number of overflow records to be processed for the section per page of output.

The system optionally returns one (1) on success or zero (0) on failure.

This procedure creates an overflow symbol associated with the section you specified.

Example

Here are some examples:

Assume that the section, CP0101NL, has three overflow lines and the extract file is a standard Documaker Server extract file.

#add_rc = AddOvFlwSym ("CP0101NL", "Loc_Cnt", 3)

In this example, an overflow variable called Loc_Cnt would be associated with the section, CP0101NL and the number of overflow lines would be set to three (3). The DAL integer variable, #add_rc, would be set to a one (1) on success or zero (0) on failure.

You define the search mask for the field or the XDB name associated with the field, as follows:

@GetRecUsed, CP0101NL, Loc_Cnt/10,HeaderRec 50,20

Here is another example:

Assume the extract file is in XML format and includes an element/node, Location, that can repeats or occurs multiple times.

AddOvFlwSym ("Loc_Cnt", "XML")

In this example, an overflow variable called Loc_Cnt would be defined. You would use this variable in the XPath predicate for repeating elements/nodes. You would define the XPath search mask for the field or the XDB name associated with the field, as follows:

!/DOCC/InsuranceSvcRq/PolicyPrintRq/ClPropLineBusiness[**Loc_Cnt**]/Location

See also