Previous Topic: Dialog functionsNext Topic: Step 7:  Define a Task Code


Menu functions

The last function listed in the table above is DEPTMENU, a menu function. You specified that it was a menu function on the Response/Function List screen in Step 3. To further define DEPTMENU, you must access the Function Definition screen by pressing [PF5] from the Response Definition screen.

Sample screen

                           Function Definition (Menu)           Page  1 of  2   Application name:  XXXAPPL    Version:    1   Function name:     DEPTMENU                             Drop function (/) _   Description . . .  UNDEFINED   Associated dialog . . . . .  ________   Default response  . . . . .  ________     User exit dialog . . . .  ________   Use signon menu (/). . . . . . . . . . _   Menu defined by:                   2  1. User      2. System   Description length . . . . . . . . . . 1  1. Long (28) 2. Short (12)   Responses per page . . . . . . . . . . 15   Number of heading lines (0-3). . . . . 0   Heading line text  _______________________________________________________________________________  _______________________________________________________________________________  _______________________________________________________________________________  ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....   Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F8=Fwd

You use the Function Definition (Menu) screen to specify basic information about a menu function. Each Function Definition (Menu) screen is made up of two pages. You can access the second page of the screen by pressing [PF8].

Menu screens

Menu screens are supplied by CA ADS; you do not have to write any statements to handle the display or operation of a menu. To tailor the appearance of a menu display, you can define a header to be displayed at the top of the menu screen. This header can include a title, instructions, or any other appropriate text.

You specify basic information for function DEPTMENU as shown:

Defining the DEPTMENU function

                          Function Definition (Menu)           Page  1 of  2  Application name:  XXXAPPL    Version:    1  Function name:     DEPTMENU                             Drop function (/) _  Description . . .  department menu   Associated dialog . . . . .  ________  Default response  . . . . .  ________     User exit dialog . . . .  ________  Use signon menu (/). . . . . . . . . . _  Menu defined by:                   2  1. User      2. System  Description length . . . . . . . . . . 1  1. Long (28) 2. Short (12)  Responses per page . . . . . . . . . . 15  Number of heading lines (0-3). . . . . 2   Heading line text   _________________________department information application____________________   ____________________________________main menu__________________________________   _______________________________________________________________________________ ....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F8=Fwd

After you press [Enter], ADSA redisplays the Function Definition screen with a confirming message. 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.

Second page of Function Definition (Menu)

You use the second page of the Function Definition (Menu) screen to specify the responses (such as ADD) that a user can access directly from the function. You also specify the sequence that the response will be displayed on the menu. You access the second page by pressing [PF8]. Second and subsequent pages are response sequence screens.

Access the second page and make the ADD, MOD, DEL, and EXIT responses valid from the DEPTMENU function as shown:

                           Function Definition (Menu)          Page  2 of  2  Application name:  XXXAPPL    Version:    1  Function name:     DEPTMENU  Valid   Seq.   Response  Key  Function  Valid   Seq.   Response  Key  Function  resp.    #                              Resp.    #    _    ______  BACK     CLEAR POP         _    ______  ________ _____ ________    /    400___  EXIT     PF09  QUIT        _    ______  ________ _____ ________    /    100___  ADD      PF04  ADDDEP      _    ______  ________ _____ ________    /    200___  MOD      PF05  MODDEP      _    ______  ________ _____ ________    /    300___  DEL      PF06  DELDEP      _    ______  ________ _____ ________    _    ______  ________ _____ ________    _    ______  ________ _____ ________  Enter  F1=Help  F3=Exit  F4=Prev  F5=Next  F7=Bkwd  F8=Fwd  F9=Update Seq

Specifying menu sequence

You can use this screen to specify the sequence in which valid responses are displayed on the menu screen.

You do this by entering sequence numbers for each valid response.

If you want to change the sequence numbers, you can change those numbers:

100    ADD
200    DEL
300    EXIT          To display MOD between ADD
150    MOD      ◄--- and DEL, you would change
                     400 to some value between
                     100 (ADD) and 200 (DEL).
                     For example: 101 or 150.

Response sequence numbers displayed on the Function Definition screen are not displayed to users.

Inhibiting response display

You can also use this screen to inhibit the display of valid responses on the menu screen.

You do this by replacing the sequence number for the response with 0 (zero):

100    EMPINFO
200    DEPTINFO      To inhibit display of the
000    SALARIES ◄--- SALARIES response, you
400    EXIT          would replace 300 with
                     0 (zero).

Invisible responses can still be accessed by any user who knows the response name or control key. To actively restrict responses, see information on security in the CA ADS Reference Guide.

For more information on other uses of the Function Definition (Menu) screen, see CA ADS Reference Guide.

The DEPTMENU function is now fully defined.

After you finish defining functions and responses for the Department application, press [PF5] to return to the Response/Function List screen. Processed selections on the Response/Function List screen will be de-selected; unprocessed selections will still be selected and are accessed when you press [PF5].

It is helpful to re-access the Response/Function List screen to remind yourself where you are in the definition process.

Press [PF5] again to go to the Global Records screen.

Press [PF5] again to go on to the Task Codes screen where you define a task code for the application. (Alternatively, you can press [PF3] from the Response/Function List screen to return to the Main Menu and choose option 4.)