Previous Topic: Step 6:  Further Define the Application FunctionsNext Topic: Menu functions


Dialog functions

The functions, ADDDEP, MODDEP, and DELDEP, are all dialog functions. You named these dialog functions on the Response/Function List screen earlier in this chapter. At that time, ADSA automatically added skeleton definitions for the associated ADDDEP, MODDEP, and DELDEP functions. When you further define a dialog function, you enhance these skeleton function definitions.

Pressing [PF5] from the Response Definition screen for the response ADD brings you to the dialog function definition for dialog ADDDEP in the Department application.

Sample screen

                           Function Definition (Dialog)  Application name:  XXXAPPL    Version:    1  Function name:     ADDDEP                               Drop function (/) _  Description . . .  UNDEFINED  Associated dialog . . . . . XXXDADD      User exit dialog . . . . . ________  Default response  . . . . . ________  Valid                                     Valid  response(/)  Response Key   Function      response(/)  Response Key   Function      _        ADD      PF04  ADDDEP            _        ________ _____ ________      _        MOD      PF05  MODDEP            _        ________ _____ ________      _        DEL      PF06  DELDEP            _        ________ _____ ________      /        BACK     CLEAR POP               _        ________ _____ ________      /        EXIT     PF03  QUIT              _        ________ _____ ________      _        ________ _____ ________          _        ________ _____ ________  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

You use the Function Definition (Dialog) screen to specify basic information for the dialog function, including a description, and valid responses for that function.

Function description

When you display the Function Definition screen, the Description field will contain a value of UNDEFINED because you have not yet provided a description. A description must be provided before the application can be compiled.

Valid responses

Valid responses are the responses (for example, BACK or EXIT) that a user can access directly from a function. You specify a valid response by entering a nonblank character opposite the response. When the screen is refreshed, a slash (/) is displayed.

A response that has been defined as global on the Response Definition screen will already be selected as a valid response for this function. You can deselect a response by spacing over the slash.

To make it easier for you to define dialog functions, dialogs that you name on the Function Definition screen do not yet have to be defined in the data dictionary. You will define dialogs for Department application dialog functions later in this manual, in Chapter 10, "Defining Dialogs Using ADSC".

Defining the ADDDEP function

You specify basic information for the ADDDEP function as shown:

                            Function Definition (Dialog)    Application name:  XXXAPPL    Version:    1    Function name:     ADDDEP                               Drop function (/) _    Description . . .  add department     Associated dialog . . . . . XXXDADD      User exit dialog . . . . . ________    Default response  . . . . . ________    Valid                                     Valid    response(/)  Response Key   Function      response(/)  Response Key   Function        _        ADD      PF04  ADDDEP            _        ________ _____ ________        _        MOD      PF05  MODDEP            _        ________ _____ ________        _        DEL      PF06  DELDEP            _        ________ _____ ________        /        BACK     CLEAR POP               _        ________ _____ ________        /        EXIT     PF03  QUIT              _        ________ _____ ________        _        ________ _____ ________          _        ________ _____ ________    Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

When you press [Enter], ADSA redisplays the Function Definition screen with an appropriate message. A confirming message is returned if there are no errors. In this case, you have successfully modified and enhanced the skeleton dialog function.

An error message is returned if ADSA detects any errors. In this case, use the message to determine the problem. You can type over any errors, and then press [Enter] again.

Press [PF5] to see the next Response Definition screen.

Note: If you press [PF5] rather than [Enter] after providing information and there are no errors, the appropriate Response Definition screen (or Function Definition screen, if there are no more responses to be defined) is displayed immediately.

Defining the MOD response

You can now define the MOD response.

                              Response Definition  Application name:   XXXAPPL    Version:    1  Response name:      MOD                                 Drop response (/) _  Function invoked:   MODDEP  Description . . . . modify department          Security class:   0  Response type. . . . . . . 2   1. Global      2. Local  Response execution . . . . 2   1. Immediate   2. Deferred  Assigned key . . . . . . . PF05  Control command. . . . . .  1   1. Transfer               2. Invoke                                  3. Link                   4. Return                                  5. Return continue        6. Return clear                                  7. Return continue clear  8. Transfer nofinish                                  9. Invoke nosave         10. Link nosave  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next

Defining the MODDEP function

Press [PF5] to see the Function Definition screen for the function that response MOD invokes, MODDEP.

You now can define the MODDEP dialog function by using the Function Definition screen:

                          Function Definition (Dialog)  Application name:  XXXAPPL    Version:    1  Function name:     MODDEP                               Drop function (/) _  Description . . .  modify department   Associated dialog . . . . . XXXDUPD      User exit dialog . . . . . ________  Default response  . . . . . ________  Valid                                     Valid  response(/)  Response Key   Function      response(/)  Response Key   Function      _        ADD      PF04  ADDDEP            _        ________ _____ ________      _        MOD      PF05  MODDEP            _        ________ _____ ________      _        DEL      PF06  DELDEP            _        ________ _____ ________      /        BACK     CLEAR POP               _        ________ _____ ________      /        EXIT     PF09  QUIT              _        ________ _____ ________      _        ________ _____ ________          _        ________ _____ ________  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

When you are finished defining MODDEP, press [PF5] to go directly to the next selected response.

Use the Response Definition and Function Definition screens to define the DEL response and the DELEMP function.

Defining the DEL response

                              Response Definition  Application name:   XXXAPPL    Version:    1  Response name:      DEL                                 Drop response (/) _  Function invoked:   DELDEP  Description . . . . delete department   Response type. . . . . . . 2   1. Global      2. Local  Response execution . . . . 2   1. Immediate   2. Deferred  Assigned key . . . . . . . PF06  Control command. . . . . .  1   1. Transfer               2. Invoke                                  3. Link                   4. Return                                  5. Return continue        6. Return clear                                  7. Return continue clear  8. Transfer nofinish                                  9. Invoke nosave         10. Link nosave  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next

Defining the DELDEP function

                          Function Definition (Dialog)  Application name:  XXXAPPL    Version:    1  Function name:     DELDEP                               Drop function (/) _  Description . . .  delete department   Associated dialog . . . . . XXXDUPD      User exit dialog . . . . . ________  Default response  . . . . . ________  Valid                                     Valid  response(/)  Response Key   Function      response(/)  Response Key   Function      _        ADD      PF04  ADDDEP            _        ________ _____ ________      _        MOD      PF05  MODDEP            _        ________ _____ ________      _        DEL      PF06  DELDEP            _        ________ _____ ________      /        BACK     CLEAR POP               _        ________ _____ ________      /        EXIT     PF09  QUIT              _        ________ _____ ________      _        ________ _____ ________          _        ________ _____ ________  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd

Once you have defined the responses and functions above, press PF5 to bring you to another Function Definition screen. There is one function as yet undefined: DEPTMENU. DEPTMENU is a menu function.