This form is the one that is shown whenever you choose one of the reports or charts under the "Reports/Charts" item in the "Option Menu" of FHSWMAIN. It serves as an interface to the program that is printing the report or chart. The "Header" of this form contains a line describing the report program that will be producing the report or chart that has been selected. There will be some minor differences in the labels on the form for different programs...for instance those reports that require a relationship work file be created will have a command button labeled "WorkFile", while those that rely upon a selection list will have a button labeled "Select"...but the basic operation will be the same for all.

The operation of FHSWIN is somewhat similar to previous versions in that producing a report requires three steps:

Identify the records that are to be included in the report (by creating a "work" file or by selecting records during a search process)
Enter the desired report/chart option settings
"Print" the report to Screen, Printer or File. If you "Print" the report to a file, the "View" button calls form FHSWView to display the contents of that file on the screen.

The difference in FHSWIN is that these operations are controlled using mouse selected "buttons" and "selection lists" instead of special keyboard function keys. The only "special function" keys are the Enter, ESCape and Tab keys. This form provides guidance in performing the preliminary steps for printing a report before passing control to the program that will do the creation of the report.

The first line of the form (below the title line) has the four-character Report CODE and descriptive title, as they appear in the report definition file (FHSRPTS.RDF). If the program that produces the report or chart is capable of producing other reports using the same type workfile, you can click on the report code and a drop down list will show the codes for the other reports. (For instance, if you chose the Ancestor Report from the Main Menu, which has report code "ARPT", the drop down list will also show codes for "ASUM", the Ancestor Summary report, and "ADUP, the Ancestor Duplicates report.) If you wish to print one of the alternate reports, you can choose its code from the list instead of returning to the Main Menu for selecting that report. The report options shown in the lower right corner of the form will change to those for the selected report.

(Note: the Ancestor, Descendant and Relative reports are all printed from the same program but they will not appear together in one of these drop-down report lists because they use different modes for the relationship "Work File".)

The second line of the form shows the code and descriptive label for the current "Printer Setup", as found in the Printer Definition File (FHSPRINT.PDF). The "setup" would more appropriately be called a "Page Setup", because only the "Page Parameters" (form length and width, inside and outside margins, etc.) and chart symbol table are used. Clicking on the Name for the setup will open a drop down list of code names for other setups that have been entered into the .PDF file using form FHSWPRNT. The "Change" button on the right side of the line can be used to bring up form FHSWPRNT to allow making changes to the Printer or Page setups.

The third line shows the current destination for the report. You can click on the destination field to open a drop down list of optional destinations which include: "Screen", "Printer" and "File". If you choose "File", the field next to the destination field will show the current file name for report output. You can overtype the file name or use the "Browse" button to the right of the file name to call upon form FHSWFILE to select from existing report files. After "Printing" the report to a File, clicking the "View" button to the right of the "Browse" button will call form FHSWVIEW to show the contents of the current report file.

(Note: if you select "Screen" for the destination, the report will still be written to a file, named $PRTSCRN.RPT, which will be automatically displayed on the screen using form FHSWVIEW when the "printing" is complete. )

The option settings for the current report are shown in the lower right portion of the form. These appear just as they do in the Sept 97 update of FHS, with option labels taken from the .TDF file and option settings from the .RDF file. On the lower left portion of the form are four action buttons. The top button, labeled "Options", is used to request browsing and updating the report options. When you click this button, the cursor moves to the first of the options and the label on the button becomes "Save Options". The label on the last button changes to "End". You can end the viewing/changing of the option settings by clicking "Save Options", which will save the changes in the .RDF file, or by clicking "End", which will only hold the changes in the computer's temporary memory (RAM). (I have had problems trying to SAVE the changed options to the .RDF file so that button is greyed out, for now.)

The button below the "Options" button is used to identify the name records that will appear in the report. In some cases this will be labeled "Work File" and will cause the "FHSWRELW" form to be displayed, in others it will be labeled "Select" and will cause the "FHSWSLCT" form to be displayed. For Horizontal Box charts, it will be labeled "Node File" and will cause the "FHSWNDWK" form to be displayed.

Clicking the third button, labeled "Print", will pass control to the program that will print the report or chart. These programs may still request additional information from you using the same messages that were used in the Sept 97 update. Many messages ask for a "single key" response and will use the same SNGLKEY system table as the Sept 97 update for interpreting the responses. Simply clicking on the message box will have the same effect as responding by pressing the Enter key...that is the default response as indicated in the .MDF file. You can terminate the program by clicking the upper right corner of the message box or by pressing the ESCape key in response to a message. At this time, the printing cannot be interrupted after it has started.

Clicking on the "Return" or "Cancel" buttons removes form FHSWRPGM from memory and returns control to form FHSWMAIN.

FHSWRPGM - Form for Report Programs