(with a search argument of "VAC")
If you had done either of these "programmerless queries", you could then take advantage of the Short-List facility to (cont.)
select each of the VAC. . . functions from a pop-up window. The Short-List is invoked by pressing PF24 from the (cont.)
maintenance screen after having done a browse or query.
In this project we are having you use the less elegant, more basic, method of executing a browse, selecting an item for (cont.)
update, updating the item, and re-executing the browse to enable you to select the next item.
```
 FCDLOC VAC  END OF LIST  PF5=Restart/PF7=Backward
FUNCT.  LAP  DESC  T-MMP  LVL  HLD  P-MMP  LVL  HLD
VACADD  50 VAC MAINT  600  1  N  600  9  N
VACCHG  50 VAC MAINT  600  1  N  600  9  N
VACDEL  50 VAC MAINT  600  1  N  600  9  N
VACDUP  50 VAC MAINT  600  1  N  600  9  N
VACFND  50 VAC MAINT  600  1  N  600  9  N
VACLOC  50 VAC MAINT  600  1  N  600  9  N
VACNXT  50 VAC MAINT  600  1  N  600  9  N
VACSCN  50 VAC MAINT  600  1  N  600  9  N
VACSEE  50 VAC MAINT  600  1  N  600  9  N
VACTOT  50 VAC MAINT  600  1  N  600  9  N
VERZUN  50  PGM/MSK VERSION VERIFICATION  652  1  N  652  1  N
WHOMAY  49  Show Authorized Users for Func 665  1  N  665  1  N
WHOSON  49  List who is logged on  665  8  N  665  8  N
WINDOW  00  Swap Windows  652  0  N  652  0  N
  ++++ 14 Records Scanned, 14 Displayed so far - Page 1 ++++
KEY 1 = FUNCTION CODE 
 Press PF13 for Hardcopy
 You may Position the CURSOR on an item and Press ENTER to "SEE" it
(Browsing Forward)  or Press PF4 to "CHG" it**
```
Figure 05 — Function Code "Locate" Screen
**Do this:** Position the cursor to the line where VACADD is displayed, press PF4.
By positioning the cursor to a line and pressing PF4, you have selected that item for *change.*
The full-screen FCDCHG screen will appear with the definition for the selected function (VACADD) filled in.
This shows you the current values specified - they are the default values generated by the MMPCREAT process at the time the Vacation Application was initially generated.
**Desc **is a 30-character description which will appear on the automatically-generated menus, it should be one which will be helpful to an operator requesting a menu.
**Logical Application** is the 2-digit (01 through 50) LAP number. LAP 50 is for Development/Testing/ and Database (cont.)
Administration functions -- it is the default LAP which MAGEC uses when it automatically creates the FCD entries; you (cont.)
can change it to any valid LAP number.
Separate **TEST **and **PRODUCTION** profiles are supported for many of the parameters. This enables you to conduct (cont.)
production processing, development, and testing on one MAGEC system. You can separate programs, files, and security (cont.)
parameters to prevent end-users from accessing test data and to prevent developers and prototypers from accessing (cont.)
production files and programs.
**User Views** are the sixteen (16) MAGEC user views (TS01 through TS08 and PR01 through PR08). You specify (Y or N) whether this function may be executed from each of the user views.
**MMP Numbe**r is the 3-character identification for the program which is executed to handle this function.
**Auth Level** is the authorization level (0 through 9) which is required to access this function. You should interpret (cont.)
this as meaning the authorization level *within the specified logical application*. A level of 0 indicates "no (cont.)
authorization", a level of 9 indicates the highest possible authorization.
**Hold** is a Y or N indicator which specifies whether this function is temporarily suspended, Y indicates "on hold."
**This Function Invokes Auto Edit ****(Y or N)** is a Y or N indicator which specifies whether this is an updating (cont.)
function (i.e add, change, duplicate) which requires MAGEC to perform the automatic screen field edits to validate the (cont.)
data entered. Functions ending in ADD, CHG, or DUP will automatically be treated as updating functions, regardless of (cont.)
the setting of this indicator -- other functions will not be considered as updating functions* unless *the setting is (cont.)
Y.
```
** FCDCHG VACADD
  M A G E C
  FUNCTION CODE DEFINITION
 FUNCTION CODE= VACADD  DESC: VACATION/SICK/COMP DAYS
 LOGICAL APPLICATION NUMBER: 50  MAGEC Development/Testing/DBA
  TEST  PRODUCTION
  87654321  87654321
 USER VIEWS: YYYYYYYY  USER VIEWS:
 MMP NUMBER: 600  MMP NUMBER: 600
 AUTH LEVEL: 1  AUTH LEVEL: 9
  HOLD: N  HOLD: N
  THIS FUNCTION WILL INVOKE AUTO EDIT (Y OR N): Y
Press PF4 for browse (LOC) screen 
 Press PF13 for Hardcopy
Press PF16 to Copy field to buffer  Press PF17 to Paste data from buffer
Press PF2 for field-level HELP  Press PF24 for Pop-Up Short-List**
```
Figure 06 — Function Code Definition Screen
**Note:** There is a "global change" function, FCDGBL, which will enable you to alter a set of function code (cont.)
definitions in one transaction. You could use FCDGBL to change all the VAC... function codes instead of using FCDCHG on (cont.)
each one individually. In this exercise we are having you use the more tedious, but more instructive, individual (cont.)
method. In real-life you would probably often choose to use the global change facility instead to save time. FCDGBL is (cont.)
described in more detail in the Programmer's Reference Guide in the "Security" chapter.
**Do this:** Key in changes as shown. Press ENTER.
You are entering the description which will be used on the lower level menu. When MAGEC automatically generated the FCD (cont.)
records, it used a default description of VAC MAINT. You are overkeying it with one which will be more pleasing on the (cont.)
menu. You are also overkeying the default logical application number (50) with 01, specifying Y (yes) for all eight (cont.)
production user views, and changing the production authorization level to 1.
The description for the logical application which appears on the screen will change to reflect the change you have made to the logical application number after you have pressed ENTER.
Now, you must repeat these changes for each of the VAC... functions.
**Note:** A message at the bottom of the screen will remind you that you must do the **LOAD fucntion in order to make (cont.)
your changes take effect immediately. It is not necessary to do **LOAD after each individual update when you are going (cont.)
to do several updates; you should do **LOAD after you have completed all your updates. When MAGEC is first initialized, (cont.)
at the time your TP Monitor (CICS, Westi, etc.) is started up, it loads the security and data definition parameters (cont.)
from the disk-resident dictionary into main memory. This greatly improves efficiency for your applications, avoiding (cont.)
many run-time I/O's. If you alter the disk-resident dictionary parameters and wish the changes to become effective (cont.)
before the next time that your TP Monitor is brought down and back up, you must do the **LOAD function which tells (cont.)
MAGEC to re-load its main memory images of the dictionary data. Of course, the next time the TP Monitor is brought down (cont.)
and back up they will be re-loaded automatically.
```
** FCDCHG VACADD
M A G E C
FUNCTION CODE DEFINITION
FUNCTION CODE= VACADD DESC: Vacation data
LOGICAL APPLICATION NUMBER: 01 MAGEC Development/Testing/DBA
TEST PRODUCTION
87654321 87654321
USER VIEWS: YYYYYYYY USER VIEWS: yyyyyyyy
MMP NUMBER: 600 MMP NUMBER: 600
AUTH LEVEL: 1 AUTH LEVEL: 1
HOLD: N HOLD: N
THIS FUNCTION WILL INVOKE AUTO EDIT (Y OR N): Y
Press PF4 for browse (LOC) screen Press PF13 for Hardcopy
Press PF16 to Copy field to buffer Press PF17 to Paste data from buffer
Press PF2 for field-level HELP Press PF24 for Pop-Up Short-List**
```
Figure 07 — Function Code Defintion Screen
After changing the definitions for each of the VAC. . . functions you will return to the list of function codes (the Locate screen) so that you can select the next one to change it.
**Do this:** After you have successfully updated the record -- Press PF3.
Pressing the PF3 key (called the Escape Back key in SAA terminology) will return you to the FCDLOC screen *as you left (cont.)
it*, pressing PF4 instead of PF3 would return to the FCDLOC screen* with the item you just changed at the top* of the (cont.)
list.
**Do this:** Cursor-select the next VAC... function using PF4, make the changes to it. Press ENTER.
**Do this:** Repeat the steps on this page for all of the VAC... functions.
When you are finished updating the function code definitions for the Vacation application you will need to tell MAGEC to re-load its main memory images.
**Do this:** After updating all the VAC... functions -- Enter the **LOAD command (at top left of the screen) and press ENTER.
The **LOAD command will cause MAGEC to re-load its main memory images of the dictionary data. You will be notified of (cont.)
its successful completion with a message in the top-right of the screen telling you the number of function codes (cont.)
loaded.
```
** FCDLOC VAC  END OF LIST PF5=Restart/PF7=Backward
FUNCT.  LAP  DESC  T-MMP  LVL  HLD  P-MMP  LVL  HLD
VACADD  01  Vacation data  600  1  N  600  1  N
VACCHG  50  VAC MAINT  600  1  N  600  9  N
VACDEL  50  VAC MAINT  600  1  N  600  9  N
VACDUP  50  VAC MAINT  600  1  N  600  9  N
VACFND  50  VAC MAINT  600  1  N  600  9  N
VACLOC  50  VAC MAINT  600  1  N  600  9  N
VACNXT  50  VAC MAINT  600  1  N  600  9  N
VACSCN  50  VAC MAINT  600  1  N  600  9  N
VACSEE  50  VAC MAINT  600  1  N  600  9  N
VACTOT  50  VAC MAINT  600  1  N  600  9  N
VERZUN  50  PGM/MSK VERSION VERIFICATION  652  1  N  652  1  N
WHOMAY  49  Show Authorized Users for Func 665  1  N  665  1  N
WHOSON  49  List who is logged on  665  8  N  665  8  N
WINDOW  00  Swap Windows  652  0  N  652  0  N
  ++++ 14 Records Scanned, 14 Displayed so far - Page 1 ++++
KEY 1 = FUNCTION CODE 
 Press PF13 for Hardcopy
 You may Position the CURSOR on an item and Press ENTER to "SEE" it
(Browsing Forward)  or Press PF4 to "CHG" it**
```
Figure 08 — Function Code Browse Screen
# Low-Level Menus
## $$MENU Function
Now let's look at the low-level menu for LAP 01.
**Do this:** Key in the command $$MENU 01. Press ENTER.
You can see the low-level menu by keying in the $$MENU command or by starting from the high-level menu and (cont.)
cursor-selecting the desired LAP. Another way, as you will see, is to set a session option which equates the CLEAR or (cont.)
PA1 key to the $$MENU command.
The low-level menu is driven by the function code definitions from the dictionary. You can control the descriptions (cont.)
which appear on this menu by controlling the descriptions for the individual function codes in the FCD (cont.)
definition.
The most usual way for an operator to get to the low-level menu is from a higher menu. MAGEC automatically supports (cont.)
three levels of menus. The highest is the main menu (**MENU), showing Logical Applications. The intermediate level menu (cont.)
(++MENU) shows groups of functions (they are grouped by the first three characters of the function code). The $$MENU is (cont.)
the lowest level menu.
Another way of getting to the low-level menu is by simply typing in the command $$MENU nn (as we have done here). (nn = any valid logical application number.)
**Note:** There are several miscellaneous function codes which appear on every low-level menu, for any logical (cont.)
application, even though they are not actually part of that logical application. These are general purpose functions (cont.)
which are available for anyone at any time. For example, OPTION, WINDOW, and PRINTS (set session option, swap windows, (cont.)
and print screen, respectively).
** $$MENU 01  END OF DATA Reached
  User View TS01
  MENU FOR: M A G E C Employee Relations / Vacation
 Function  Key Entry  Action  Description
 OPTION  ____________________________________  SET SESSION OPTIONS
 PRINTS  ____________________________________  MAGEC SCREEN PRINT
 VACADD  ____________________________________  ADD  Vacation data
 VACCHG  ____________________________________  CHANGE  Vacation data
 VACDEL  ____________________________________  DELETE  Vacation data
 VACDUP  ____________________________________  COPY  Vacation data
 VACFND  ____________________________________  FIND  Vacation data
 VACLOC  ____________________________________  LOCATE  Vacation data
 VACNXT  ____________________________________  NEXT  Vacation data
 VACSCN  ____________________________________  SCAN  Vacation data
 VACSEE  ____________________________________  DISPLAY  Vacation data
 VACTOT  ____________________________________  Vacation total
 WINDOW  ____________________________________  Swap Window
  ** END OF MENU *
To SELECT a Function, Position the CURSOR down to the line on which it is shown,
Enter the KEY VALUE beside it if appropriate, Press ENTER
  -or-  Press PF2 for HELP Instructions for the selected Function**
Figure 09 — Menu Screen
# Session Options
Using the OPTION function an operator can customize the functionality of the CLEAR and PA1 keys and can also set a (cont.)
Stack Option which determines the action of the Attach/Detach function when the stack is exceeded.
## Special Keys Option
For convenience, an operator can set a Special Keys Option to equate the CLEAR and PA1 keys to various MAGEC functions.
The "E" option would result in the high-level menu (**MENU) being displayed when the CLEAR key is pressed and the (cont.)
low-level menu when the PA1 key is pressed. The PA1 key, in that case, would be used to return from any application (cont.)
screen to the low-level menu.
## Stack Option
The Stack Option controls the stack feature of Attach/Detach. For more detailed information regarding Attach/Detach, refer to the "Customization" Tutorial, Appendix R.
Setting the Stack Option to 'P' pushes the oldest entry off the stack and replaces it with the current screen.
The 'C' option clears the stack, then saves the current screen as the first entry in a new stack.

Next: <a href="https://magec.com/DOC/markdown/sectut03.md.txt">https://magec.com/DOC/markdown/sectut03.md.txt</a>