Figure 14 -- Task List Status After Auto-Paint # STEP 5 --  Demo & Test ## New Copy of MMP Depending on which TP monitor you are using you will have to use a different command to invoke the monitor's "new copy" (cont.) routine. On a **PC** it is not necessary to do anything, MAGEC will automatically pick up the new copy if the program (cont.) linked successfully. In **CICS **enter: | ``` **     DO THIS: CEMT SET PR(MMP600) NEW (from CICS terminal) or: **CEMT SET PR(MMP600) NEW (from within MAGEC)     ```** In** Westi** enter: | ``` **     DO THIS: FCOPY,MMP600     ```** These all accomplish (logically) the same thing. They notify your TP monitor that a new version of your program (MMP600) has been catalogued to the library. ## Testing Maintenance & Inquiry Functions Now, get back into MAGEC to begin testing. Use the TranID "TS01". We have pre-loaded some demonstration data onto the (cont.) files for you to save time. You can use your new application to add your own data or to inquire, browse, query, update, (cont.) add, or delete our demo data. When your new program was being generated, MAGEC automatically generated test-only security parameters and added them (cont.) to the dictionary for you. If your online (CICS or Westi) system has been "up" during that process, you will need to (cont.) tell MAGEC to refresh its in-memory images of the security parameters from the dictionary in order to permit immediate (cont.) testing of your new application. This is done via the **LOAD command. | ``` **     DO THIS: In the upper-left corner of your screen (the function code field) enter: **LOAD, and press ENTER     ```** | ``` **     DO THIS: Enter the command: VACSEE 01 on top line, press ENTER     ```** The demonstration employee number 000000001 will be displayed to you. You might wish to alter the function code to (cont.) VACCHG and update that record. You might also alter it to VACDEL to delete the record, and so on. If you just want to (cont.) look at the demo data for now, you might wish to just press PF8 to "bump" forward to the next employee. Next, test the (cont.) browse functions. | ``` ** VACSEE 01 Date: 08/12/1988  VACATION/SICK/COMP DAYS Time: 10:15:04   Emp# 000-00-0001   First Name Harry   Last Name Houdini   Hire Date 12/11/45   Earned Vacation  14.50   Vacation Taken  2.25   Sick Days Earned  124.50   Sick Days Taken  3.00   Comp Days Earned  2.00-   Comp Days Taken  .00  Comment (3 lines) Heavy into Escape literature.   Likes to be submerged while handcuffed and strait-jacketed in a coffin-like vault. 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 ```** Figure 15 -- Testing Maintenance & Inquiry Functions ## Testing Browses | ``` **     DO THIS: Enter the command: VACLOC 1 and press ENTER.     ```** See what the browse screen looks like. Notice the column headings (locate headings). Now try the cursor selection feature which is automatically provided with all MAGEC browses. Use the arrow keys to move (cont.) the cursor down to one of the lines where an employee is listed (anywhere on the line will do). Press ENTER. You will (cont.) immediately be transferred to the VACSEE screen for that employee. This feature lets you browse through the data (cont.) without having to know the exact key value (employee #) and locate any item by visual recognition of, say, the name. (cont.) That is why we call this a "locate" function. The VACSCN and VACFND functions also support cursor selection. Try them now to see how they work. | ``` **     DO THIS: Enter: VACSCN 1 on top line, press ENTER -- then key "harry" into the Selection Mask line (just below headings) under "First Name", press ENTER.     ```** Then, if you would like some help press HELP PF1. Every MAGEC function has built-in HELP-key support. MAGEC generates some basic online documentation for you when you (cont.) generated your MMP (via MMPCREAT) earlier. You can add an unlimited amount of your own to supplement or replace it (cont.) entirely. Now try the "Find" function. | ``` **     DO THIS: Enter: VACFND 1 on top line, press ENTER -- then key "harry|or|bob" into the Search Argument field, press ENTER.     ```** Again, you may press HELP if you like. Now, with a list of found employees shown on the VACFND screen, you can cursor-select one. | ``` **     DO THIS: Point the cursor to a line on which an employee is displayed, press ENTER.     ```** You will be shown the VACSEE screen for the selected employee. If you wish to browse in descending order through the file (rather than ascending order) using any NXT, LOC, SCN, or FND function, you can do so pressing PF7 | ``` **  VACLOC 01  END OF LIST - PF5 = Restart/PF7=Backward Emp #  First Name  Last Name  Hire Date Earned Vacation 000-00-0001 Harry  Houdini  12/11/45  14.50 000-00-0002 Uri  Geller  02/13/81  125.00- 000-00-0003 Merlin The Magician  01/21/80  5.25   ++++ 03 Records Scanned, 03 Displayed so far - Page 1 ++++ KEY 1 = Employee # (9-digits) 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 16 -- Testing Browse Functions # STEP 6 --  Documentation As you have already seen, every online function you generate with MAGEC has automatic HELP-key support and MAGEC even generates some basic online documentation for you. MAGEC has a complete Online Documentation system built in. You may use it to enter and maintain whatever additional (cont.) documentation you want to supplement or replace the standard instructions generated by MAGEC. You can even use the (cont.) Online Documentation system to maintain documentation for non-MAGEC systems since it can also produce hardcopy (cont.) manuals. You may wish to refer to the "Documentation" chapter of your *Programmer's Reference Guide* for more information about (cont.) the system. For this exercise we will bypass Step 6 (Documentation). In your real application development we strongly (cont.) recommend that you not bypass it, though. Documentation is an important part of any application (cont.) system. ## Multi-Level HELP The application you just created has several levels of online HELP built in. When the operator tries to enter invalid (cont.) data into the screen and receives an error message, (s)he can press the PF1 key (F1 on a PC) to receive an **error (cont.) analysis **HELP display. When the user mis-enters the key (Employee number) and receives an "invalid key" message, (s)he can press PF1 to receive the **key analysis **display. If the user hasn't made either of the above mistakes, but just wishes to get HELP for the function (s)he is trying to (cont.) do; (s)he can just press the PF1 key and the **function-level HELP** display will be presented. If the user wishes to see documentation for a given field on the screen, (s)he can point the cursor to that field and press PF2 and a **field-level HELP** display will be presented. All these features are generated automatically into every online application. Basic HELP text is also automatically created for you -- you can add your own text, as well. | ``` **     DO THIS: On the VACSEE screen, press the HELP key PF1.     ```** You will receive the Function-Level HELP screen. | ``` **     DO THIS: Press PF8 to browse forward   Press PF3 to return to your VACSEE screen.     ```** Next, let's see the field-level HELP facility. | ``` **     DO THIS: Point to the hire date field, press the Field-Level HELP key, PF2.     ```** | ``` ** VACSEE 01 Date: 08/12/1988  VACATION/SICK/COMP DAYS Time: 10:15:04   Emp# 000-00-0001   First Name Harry   Last Name Houdini   Hire Date  12/11/45   Earned Vacation  14.50   Vacation Taken  2.25   Sick Days Earned  124.50   Sick Days Taken  3.00   Comp Days Earned  2.00-   Comp Days Taken  .00  Comment (3 lines) Heavy into Escape literature.   Likes to be submerged while handcuffed and   strait-jacketed in a coffin-like vault. Press PF4 for browse (LOC) screen  Press PF13 for Hardcopy Press PF16 to Copy field to buffer  Press PF17 to Paste data from buffer ```** Figure 17 -- Testing HELP Keys # STEP 7 --  Put into Production ## Security When you generated your new MMP (via MMPCREAT) MAGEC automatically created safe, test-only security profiles for each (cont.) of the nine new online functions (VACADD, VACSEE, etc.). This allowed you to immediately test and demonstrate your new (cont.) application without having to manually define each function to the security system. These automatically generated (cont.) security parameters do not permit "production" use of the new application. When you have completed the testing and revising of your new application and are ready for it to "go into production", (cont.) you merely need to alter the security parameters to indicate that the new functions are now allowed for use in (cont.) "production". Actually, in some shops this task is handled by designated security officers. The parameters are entered (cont.) or modified online and are stored in the MAGEC Dictionary. You do not need to wait for any assemblies, table updates, (cont.) or interruptions to online processing. Changes can be made effective immediately. For more detailed information regarding the tasks of the security officers refer to the MAGEC "Security" chapter. # Next: https://magec.com/DOC/markdown/app03.md.txt