You are here: Job and Form Set Rules Reference > JDT Rules Reference > BuildMasterFormList

BuildMasterFormList

Use this job level rule to load the FORM.DAT file into an internal linked list used by the GenData program.

You must include this rule in the AFGJOB.JDT file because the RunSetRcpTbl rule is dependent on the list this rule creates.

Syntax

;BuildMasterFormList;;KeyCount;FORM.DAT

Parameter

Description

KeyCount

This is a required integer that must be set to 4.

FORM.DAT

List the FORM.DAT files you want the system to load. This lets you load multiple FORM.DAT files and have them appear in memory as if they came from one large FORM.DAT file.

If you do not specify the FORM.DAT file name, the system looks for the master resource library settings to find the correct file to load.

Example

;BuildMasterFormList;1;4;

The KeyCount parameter determines the number of items in the FORM.DAT line considered part of the form set key. The system organizes the form set list based on the number of items specified by the KeyCount parameter, minus one.

For example, the RPEX1 FORM.DAT file contains as its first two lines:

;SAMPCO;LB1;DEC PAGE;;R;;qsname|...

;SAMPCO;LB1;LETTER;;RD;;qsname|D...

This rule compares the lines to determine if an item is already in the list after finding the 4th (KeyCount) semicolon in each line and comparing up to the lesser position. These lines would be compared up to the following point:

;SAMPCO;LB1;DEC PAG;

;SAMPCO;LB1;LETTER;

     
Note The KeyCount parameter should be one more than the number of keys in the FORM.DAT file to allow for the leading semicolon. Do not change the KeyCount parameter unless the library uses a different number of keys.

See also