To close the Maintain procedure on which you are currently working, and create a new Maintain procedure, select New:

1. If you have not saved your work on the current procedure, the Painter asks if you wish to do so before closing it.
2. You are prompted for a file name for the new procedure's FOCEXEC/MAINTAIN and WINFORMS files. Enter the name and click OK.

   If the FOCEXEC/MAINTAIN file or WINFORMS file already exists, you have a choice of retaining it (if it's a FOCEXEC/MAINTAIN), replacing it, or canceling the operation. If you choose to retain a FOCEXEC/MAINTAIN file, skip step 3.

3. The Painter displays the Select Master Files dialog box, as described in Select Master. Select the Master Files associated with this Maintain procedure.
4. The Painter displays the Winform Properties dialog box, as described in Properties. Specify the properties of the first Winform.
5. The Painter displays the Winform design screen: you can begin working on the new Maintain procedure.

To close the Maintain procedure on which you are currently working, and open another one, select Open. The Painter displays the following dialog box:

This is the same dialog box used by the Painter when you begin a session, as described in How to Access the Painter. You can do one of the following:

• Enter a procedure name. Type in the name of the Maintain procedure (adding the word FOCEXEC or MAINTAIN is optional) in the FOCEXEC Name entry field and click OK.

  If you enter the name of a procedure that does not exist (that is, if the procedure's FOCEXEC/MAINTAIN file and/or WINFORMS file does not exist), the Painter creates a new procedure. If only one file of the pair does not exist, the Painter gives you the option of retaining the existing file (if it's a FOCEXEC/MAINTAIN), replacing the existing file when the Painter creates the new procedure, or canceling the operation. The Painter then displays the Select Master Files dialog box (unless you chose to retain an existing FOCEXEC/MAINTAIN file), which is described in Select Master; and the Winform Properties dialog box described in Properties.

  You can also create a new procedure by clicking New. This is identical to selecting the File menu's New option.

• Select a procedure name. Select a procedure from the list of files. If you wish to reduce the length of the list, you can use search criteria. For example, if you want to see all files that start with the letter M, you could enter M*. When you click OK, the list changes.
• Exit. If you click Cancel you cancel the action and close the dialog box.

To save the work you have done in your current Winform file, select Save or press PF22.

To save the Winform file you are working with under a different name, select Save As. The Save As dialog box is displayed:

Enter the new name for the Winform file and press PF4 to save it. You may press PF3 to cancel the action.

To bring an existing Winform into your Winform file, select Import. The Import dialog box is displayed:

Type or specify a Maintain procedure name or move the cursor to the Maintain procedure you wish to import, then press PF4.

If the Maintain procedure name you specify has a different corresponding Master File, a dialog box similar to the following is displayed:

You may ignore the warning and proceed, or cancel the request.

The Painter now displays a list of the Winforms that you can import:

Select a Winform from the combo box and then click OK.

If the Winform you attempt to import references Maintain functions that do not currently exist in your procedure, a dialog box similar to the following is displayed. (Maintain functions—often simply called functions—are referred to in the Winform Painter as cases.)

In response to the warning you may either choose:

• Create Cases to generate the CASE and ENDCASE commands in your Maintain procedure, and to bring the triggers into your Winform. After selecting Create Cases you are returned to the Winform.
• Delete Triggers to delete the triggers that are not system actions. After selecting Delete Triggers you are returned to the Winform.
• Cancel to cancel the action. After selecting Cancel you are returned to the Winform.

Select Regen whenever a new error occurs after a new release of FOCUS is installed at your site. You should also select Regen whenever changes are made to your data source. The error may be occurring because of the new install of FOCUS. If the error still occurs after selecting Regen, consult your local Information Builders representative.

Selecting Select Master displays the Select Master Files dialog box, enabling you to select all of the data sources you wish to access in a Winform file. This is the same dialog box used by the Painter when you begin a session, as described in How to Access the Painter.

When the dialog box is first displayed, your cursor is positioned so you can type in the name of the file. You can either type in the name (and in this case the word MASTER is optional) or you can select from the list box which is just below the cursor. Once you have selected or entered a data source, you must press the Enter key to add the data source to the list. When you do this, the data source name is added to the box to the right of the list of available Master Files. You may select up to 16 data sources.

Your selections determine which fields are displayed in the Field and Grid dialog boxes.

If you accidentally add a data source you did not want to add, you can remove it from the list by moving the cursor to the data source name you want removed from the list of the selected data sources and pressing PF9. If you have made a lot of mistakes, you might want to press PF12 (or select the Reset button) which clears all changes made to the dialog box since it was displayed.

If this dialog box was displayed while beginning a Painter session for a new procedure, and the procedure will not access a data source, you do not need to select one. When this dialog box is displayed, press PF4 or the OK button.

When you have finished adding all of the data sources you want to access, click OK.

Selecting Preferences enables you to customize your Painter environment. For all Preference options, the options selected stay in effect from session to session until you change them.

The following menu is displayed when Preferences is chosen:

Preferences offers the following options:

• Terminal configures the Winform facility for the terminal or terminal emulator that you are using. If you are having problems displaying Winform elements such as check boxes, scroll bars, borders, or colors, you can set the Winform facility to a different terminal or emulator. (Selecting this option is equivalent to issuing the EX MSETUP command at the FOCUS command prompt.)
• Editor does not offer any options.
• Pictorial View enables you to generate comments at the end of each Maintain procedure.

Selecting Exit closes the Winform Painter and returns you to the FOCUS prompt. If you have made changes to the Winform file and have not saved them, you are prompted to save the changes.