CA 2E Quick Tour › Defining Functions › Function Options

Function Options

You can modify certain aspects of the behavior of a function. From the Edit Functions panel, enter Z against the Edit Horse function, as shown in the following example:

EDIT FUNCTIONS                           My model                            

 File name. . . : Horse                                  **   1ST LEVEL  **  

 ? Function                Function type            Access path             

   Change Horse            Change object            Update index            

   Create Horse            Create object            Update index            

   Delete Horse            Delete object            Update index            

Z  Edit Horse              Edit file                Retrieval index         

   Select Horse            Select record            Retrieval index         

   Select Mares            Select record            Mares                      

   Select Stallions        Select record            Stallions                  

                                                                        More...

 SEL: Z=Details   P=Parms   F=Action diagram   S=Device   D=Delete   O=Open    

      T=Structure   A=Access path   G/J=Generate function   H=Generate HTML ...

 F3=Exit   F5=Reload   F7=File details   F9=Add functions   F23=More options   

 F11=Next View   F17=Services   F21=Copy *Template function 

 Function ‘Edit Horse’ has been saved.

Press Enter to display the Edit Function Details panel as shown in the following example:

EDIT FUNCTION DETAILS                         My model                          

 Function name . . : Edit Horse                  Type : Edit file               

 Received by file. : Horse                       Acpth: Retrieval index         

 Workstation . . . : NPT                                                      

 Source library. . : MYGEN                                                 

 Object   Source      Target                                                   

 ? Type   Name        HLL    Text                                              

    PGM   MYAEEFR     RPG    Edit Horse                     Edit file           

    DSP   MYAEEFRD    DDS    Edit Horse                     Edit file           

    HLP   MYAEEFRH    UIM    Edit Horse                     Edit file           

 SEL: E-STRSEU, O-Compiler Overrides, T-ILE Compilation Type (*PGM/*MODULE)   

 F3=Exit             F5=Action diagram    F7=Options       F8=Change name     

 F9=Device design    F17=HTML skeleton    F20=Narrative  

Press F7 to view the Edit Function Options panel. The actual function options available and their defaults depend on the function type.

In this example the following options can be modified:

• Create record —this option specifies whether you can create database records. The default is Y, which means you can add database records. If you change this value to N, the function code will not include logic to add database records.
• Change record — this option specifies whether you can change database records. The default is Y, which means you can add database records. If you change this value to N, the function code will not include logic to add database records.
• Delete record—this option specifies whether you can delete database records. The default is Y, which means you can delete database records. If you change this value to N, the function code will not include logic to delete database records.
• Dynamic program mode—this option specifies whether the program will dynamically change the program mode between Add and Change modes, depending upon whether data exists or not. If Dynamic program mode is set to Yes, then at runtime if there are records to be displayed the program mode will be Change and records will be shown. If no records exist, then program mode will be Add and blank lines for adding records will be shown. If Dynamic program mode is set to No, then at runtime the program mode will be Add and the user will have to use F9=Change to see any existing records.
• Subfile selection—this option specifies whether there will be subfile select options available within the program or not. If this value is Yes, then the screen will have a column for subfile selection options and allow for subfile option text. If Subfile selection is set to No, then the column for subfile selection options and the subfile option text will not display on the screen.

  Note: If Delete record is allowed, then Subfile selection must be set to Yes.

• Confirm prompt—the Confirm prompt option specifies whether the Edit Horse function prompts for confirmation before updating the database files. The default is Y.

  If the Confirm prompt option is Y, a related option, Initially Yes, specifies whether the default for the confirm prompt will be Y or N.

Note: To see full details on other possible function options, see the chapter "Modifying Function Options" in Building Applications.