This form is the one that is shown whenever you choose one of the export/import, file validation or Tiny Tafel options under the "Utilities" item in the "Option Menu" of FHSWMAIN. It serves as an interface to the utility program. These programs are conversions of ones that are in the Sept 97 update, the main difference being that user requests are handled by "forms" instead of the screen formats of the earlier updates. The "Header" of this form contains a line describing the utility program that will be processing the option that has been selected.

The first line of the form (below the title line) has the four character CODE and descriptive title for the "report" definition (from FHSRPTS.RDF) that includes most of the utility option settings. For the export/import options there will be a second code (selectable by clicking on the code field and choosing from the drop down list) for producing a report showing the contents of a file to which information has been exported.

The second and third lines of the form have the same purpose as the corresponding lines of form FHSWRPGM.

The command buttons to the left of the Options viewing area are "Options", "Select", "Process" , "Counters" and "Return". The "Options", "Select" and "Return" buttons behave similarly to the same named command buttons of the FHSWRPGM form. The "Process" (or "Build/Show Table") button is used to call the utility program to perform the option indicated by the Report CODE. If the CODE is for one of the related reports, then the caption on the button will be "Print" and the "process" will be the printing of the report. If the CODE is for the utility option settings, then the "process" will be the execution of the function chosen from the Main Menu. In some cases, there is a report (an error report or a status report) associated with the execution of the utility function. If that is the case, then the report will be directed to the DESTination shown on the third line of the form. If the destination is a file, then the report can be reviewed after the process is complete by clicking the "View" button. If the destination is the screen, then the report will be automatically viewed after the process is complete.

Most utility programs will display a "status" frame where the option settings are normally shown. This status view will be updated as the utility function progresses and will be replaced with the view of option settings when the function is complete. The "Counters" button will be enabled after a utility function has been processed. Clicking the button allows you to review the final status display for the process. When reviewing the counters for one of the validation options (Pointer, Data, or Duplicate Data) a "Save" button is added to the form. Clicking the "Save" button will allow you to write the list of "error Id's" determined by the validation option to a Select work file. You can use the Select work file to print a "List" report of the records in the list of "error ID's".

Under the "Tiny Tafel" utility option, the form has a unique behavior. This results from that option's requiring a specific sequence of operations be performed. At the beginning of the "Tiny Tafel" option, the Command Buttons are: "Options", "Select", "Build Table", "Print" and "Return" but the "Build Table" and "Print" buttons are disabled. After using the "Select" button to choose a group of records to be processed, the "Build Table" button will be enabled. Pressing this button causes the program to create and display (using form FHSWTTFL) a "Surname Table" that is used in producing a "Tiny Tafel" file or report. After returning from the display/update of the Surname Table, the "Build Table" button changes to "Show Table" and the "Print" button is enabled. Pressing the "Show Table" button will redisplay the Surname Table for changing "interest levels". Pressing the "Print" button will cause the Tiny Tafel report or file to be created. If the "Select" button is used after a Surname Table has been created, the "Show Table" button will become "Build Table" and the "Print" button will be disabled. If the "Options" button is used after a Surname Table has been created, then the "Show Table" button will be changed to "Build Table". That allows the recreation of the Surname Table with a different setting for the Options but continues to allow Printing from the already created Surname Table. It may be that different option settings are desired for creating the Surname Table than for printing the Tiny Tafel report.

FHSWUPGM - Utility Program Form for FHSWIN