## Pop-Up Window
After seeing or updating the first (or any other) selected matching item, you may press PF24. The Short-List will (cont.)
appear in a small "pop-up" window. You can scroll forward and backward through the list in the window using the PF8 and (cont.)
PF7 (F8 and F7 on PC) keys (as you do in the NXT functions). You can cursor-select any item from the Short-List and (cont.)
press PF24 (Alt-F4 on PC) to be transferred immediately to a full-screen display for the selected item. This works (cont.)
whether you are updating (CHG function) or just looking at (SEE or NXT function) the items.
For example:
CUSFND 1      
screen to enter search argument is displayed
enter search arg(s)      
list of up-to 16 customers displayed
cursor-select a customer      
full-screen display for selected customer is shown
press PF24      
pop-up Short List is displayed
cursor select another
  customer from Short List      
full-screen display for selected customer is shown
etc.
# Mouse Support-PC and LAN
MAGEC for Micro Focus Cobol includes mouse support under MS-DOS, Windows, OS/2, and Unix operating environments. If (cont.)
your MAGEC-generatedapplication is being executed in GUI (Graphical User Interface) mode, a mouse is an integral part (cont.)
of the application's user interface. If your application is being executed in text mode, the mouse is a nice-to-have (cont.)
accessory which takes advantage of the high degree of standardization of MAGEC applications to provide very handy (cont.)
features with no additional programming required of your developers. This topic discusses the mouse in text mode (cont.)
execution.
In text mode, only the mouse cursor position and the left mouse button can be sensed. The right button (and center (cont.)
button, if installed) are ignored. All mouse sensing is handled in MAGEC's Control Program and no code need be added to (cont.)
your applications to operate with a mouse. Any application can be used either with, or without, a (cont.)
mouse.
## PF Keys using Mouse
The first mouse service we will discuss here is the simulation of Program Function keys (PF-keys, or F- keys) using the (cont.)
mouse in text mode (as opposed to GUI mode). It is customary, and consistent with MAGEC's standards, to display PF key (cont.)
instructions on the screen telling the operator which PF keys provide which functions for every screen. The structure (cont.)
of these instrucdtions may vary, but should follow one of several formats which sill be discussed below. If the (cont.)
operator points the mouse cursor onto a screen message indicating the meaning for a PF key, MAGEC will automatically (cont.)
simulate that that key was pressed whcn the left mouse button is clicked. In order for MAGEC to recognize PF key (cont.)
instructions from miscellaneous text displayed, certain rules of form should be followed,. Below is a list of samples (cont.)
which will be recognized by MAGEC's mouse handler:
PF*nn*=blah-blah
F*nn*=blah-blah
*nn*=blah-blah
*nn*=blah-blah/*mm*=this-n-that/*pp*=something-else
The key numbers may be one- or two-digit numbers. They may be preceded by "F", "PF", or by nothing (a space or a separator character). The recognized separators are: "/" "," ";" "(" or space.
The PF key instructions may be anywhere on the screen, including in SERRMSG (last three lines of screen), and SCOMPL (cont.)
(right half of the top line of the screen), but must be in a protected field on the screen. No PF key instructions will (cont.)
be recognized in a screen field which is unprotected (enterable by the application user). The mouse may be pointed to (cont.)
any character position within the message for the desired key, MAGEC will scan leftward until reaching a space or a (cont.)
separator, then will test for a valid key number. If the message contains embedded spaces and if the user points to the (cont.)
right of a space character, MAGEC will not recognize the key number as being part of the selected message and will (cont.)
ingnore it, assuming that the operator merely wished to position the text cursor where the mouse cursor was pointing (cont.)
when the left button was clicked.
## Pop-Up Error Help
It is another MAGEC standard that error messages be presented in the SERRMSG field (last three lines of the screen). (cont.)
Without a mouse, the operator can press PF1 any time such error messages are shown and will receive an expanded (cont.)
explanation for each error message on the screen. With a mouse, the operator can also point the mouse cursor to any (cont.)
such error message, click the left mouse button, and receive a pop-up window with an expanded explanation for the (cont.)
chosen error message. The pop-up window contains a push button saying "OK". pointig to the push button and clicking the (cont.)
left mouse button will remove the pop-up window. Pressing the CLEAR (Escape) key will also remove the pop-up window, (cont.)
any other keystroke will be ingored. While the pop-up window is being displayed, the error number at the front of the (cont.)
error message chosen will blink to indicate which error message the expanded explanation applies to. The operator can (cont.)
select another error message to get an explanation of it, if desired, after removing the pop-up window for the prior (cont.)
error message.
## Positioning Text Cursor with Mouse
The final function of the mouse in text mode is to re-position the text cursor. If the operator moves the mouse cursor (cont.)
to any screen position (not recognized as either a PF key message or an error message number) MAGEC will re-position (cont.)
the text cursor there when the left mouse button is clicked. Notice that nothing happens until the left mouse button is (cont.)
clicked. Just moving the mouse merely moves the mouse cursor around the screen display, but has no effect on where the (cont.)
operator is typing. The text cursor always controls where the operator's typed data is being entered into the (cont.)
screen.
## Cursor Appearance
The mouse cursor can easily be distinguished from the text cursor by its appearance. Its appearance changes depending (cont.)
on the environment you are operating in. The text cursor is always the blinking underscore (cont.)
character.
You can execute MAGEC under OS/2 (product of IBM) in either full-screen, or window mode. In OS/2 full-screen display (cont.)
mode, the mouse cursor appears as a rectangular block which has the inverse color scheme of the surrounding screen. In (cont.)
OS/2 window mode, the mouse cursor is a black diagonal arrow pointing toward the upper left. This is the standard OS/2 (cont.)
mouse cursor shape.
In MS/DOS (product of Microsoft), the mouse cursor is the inverse-colored rectangular block.
In Windows (product of Microsoft), the mouse cursor is the outlined white Windows cursor arrow pointing (more-or-less) toward the upper left.
If the mouse cursor is the rectangular block, moving the mouse moves the mouse cursor in increments of one schreen (cont.)
character at a time. If the mouse cursor appears as an arrow, moving the mouse moves the mouse cursor in increments of (cont.)
one pixel at a time. All other functionality is identical, as the pixel coordinates are converted into screen character (cont.)
coordinates automatically before being processed.
# Appendix A -- PC Template
On the following page is the MAGEC PC Template, which equates 3270 keys to their PC equivalents.
Listed below are the general use keys that MAGEC uses:
CLEAR
             
Clear screen, display logo (or as altered by Special Keys Session Option)
PA1
             
Display menu screen (or as altered by Special Keys Session Option)
PF15
             
Exit MAGEC
PF9
             
Swap Windows
PF1
             
General HELP key
PF2
             
Field-level HELP key
PF16
             
Copy-to-buffer key
PF17
             
Paste-from-buffer key
In addition to the keys mentioned above, there may be keys assigned to functions in your session options, or programmed (cont.)
into your applications. Refer to the section in this manual titled Session Options for more detailed (cont.)
information.
Most MAGEC screens will display instructions regarding the usage of function keys at the bottom of the screen. Some (cont.)
instructions may be displayed at the top right corner of the screen, especially in cases where the bottom lines of the (cont.)
screen are already occupied.
## PC Keyboards
Various types of PC's and PS/2's have different keyboards which behave slightly differently from one another. The key (cont.)
equivalents, as shown on the template which follows, will work on all known variations of PC keyboards. In addition, (cont.)
there are some other keys which are supported if you have one of the "extended" keyboards. They are:
F11
             
equal to PF11
F12
             
equal to PF12
Bkspc
             
equal to Backspace
Ctrl-up-arrow
             
fast up-arrow
Ctrl-down-arrow
             
fast down-arrow
PC-MAGEC 3270 Emulation Template
| **** | **F1** | **F2** | **F3** | **F4** | **F5** | **F6** | **F7** | **F8** | **F9** | **F10** | **Pg Dn** | **Pg Up** | **+** | **Esc** | **End** | **Tab** 
| **CTRL** | PA1 | PA2 | PA3 | | | | | | | | | | | | Erase EOF | 
| **ALT** | PF21 | PF22 | PF23 | PF24 | | | | | | | | | | | | 
| **SHIFT** | PF11 | PF12 | PF13 | PF14 | PF15 | PF16 | PF17 | PF18 | PF19 | PF20 | | | | | | Tab Left 
| **** | PF1 | PF2 | PF3 | PF4 | PF5 | PF6 | PF7 | PF8 | PF9 | PF10 | PF8 | PF7 | ENTER | CLEAR | RESET | Tab Right 
Use this template to convert mainframe 3270 keys to their PC equivalents when using PC-MAGEC. The following keys all have the same meanings in both environments:
HOME key
RETURN key (sometimes labeled ENTER) (move cursor to beginning of next line)
INSERT key (Ins)
DELETE key (Del)
the "arrows"
For compatibility with some other PC software, MAGEC will accept the "large plus" key (in the numeric key pad) as (cont.)
equivalent to the mainframe ENTER key (this does not apply to the "+" key which is above the alphabetic keys and which (cont.)
you must shift to use). The Ctrl-Return key combination is also equivalent to the 3270 ENTER key.
# Appendix B -- GUI Objects
MAGEC applications can be executed in a Graphical User Interface (GUI) mode if you are on a platform which supports (cont.)
graphics. If you are using MAGEC in GUI mode, certain standard menu items, icons, and pushbuttons will usually be built (cont.)
into your application. The following pages depict the most important of those. It is possible for the application (cont.)
developer to design graphical images and features, and to add them to the applications as customization. It is also (cont.)
possible for the developer to exclude some or all of the standard objects from any given application. The following (cont.)
pages discuss the standard, MAGEC-generated GUI objects.
## GUI Icons
Note:** The GUI version of MAGEC has been replaced by the LAMP-Stack Magec! Documentation remains here in case you happen to be still using it.
*
If you wish to press a PF key which is not otherwise represented by an icon, you can select the "KEYS" icon. A pop-up (cont.)
"keyboard" containing all of the PF keys will be presented. You can then select the desired pushbutton for the PF key (cont.)
you want to press.
The ENTER key is used to process updates, to select from lists, et cetera. You can select this icon - or press ENTER (RETURN).
The GUI Color Options Panel (GCOSEE function) can be invoked by selecting the "Colors" icon. From this panel you can (cont.)
control the foreground and background colors for text displays on the application screens.
High-level (Function-level) help can be retrieved via PF1. You can click this icon or press F1.
Field-level help can be retrieved via PF2. You can select this icon or press F2.
The PF3 key is the ESCAPE-BACK key throughout MAGEC. You can select this icon - or press F3.
From a "maintenance screen" (i.e. xxxCHG, or xxxSEE function) you can press PF4 to start listing items (xxxLOC function) beginning with the current key value. You can select this icon - or press F4.
From a "browse screen" (i.e. xxxLOC, xxxSCN, xxxFND functions) you can point to an item and use PF4 to transfer to the change (xxxCHG) screen for that item. You can select this icon - or press F4.
PF7 can be used to browse backward from any browse display, and from most inquiry (xxxSEE) displays. You can select this icon - or press F7.
PF8 can be used to browse forward from any browse display, and from most inquiry (xxxSEE) displays. You can select this icon - or press F8.
PF9 will swap MAGEC windws. You can have two MAGEC sessions active and swap between them. You can select this icon - or press F9.
PF11 can be used to invoke a menu-driven search for online documentation. You can select this icon - or press Shift-F1.
PF13 can be used to generate a printed report or screen image from any MAGEC application. You can select this icon - or press Shift-F3.
PF15 is used to exit MAGEC and return to the operating environment (i.e. Windows, etc.) You can select this icon - or press Shift-F5.
The PF16 key can be used to copy (cut) data from a screen into a copy/paste buffer. You can select this icon - or press Shift-F6.
The PF17 key can be used to paste data from the copy/paste buffer to the screen. You can select this icon - or press Shift-F7.
From any browse or query screen, the ENTER key can be used (after pointing the cursor to a listed item) to transfer to (cont.)
the inquiry screen (xxxSEE function) for that cursor-selected item. You can select this icon - or press ENTER (cont.)
(RETURN).
## GUI Menus
## GUI Color Preferences
MAGEC application users who are executing in a GUI environment can set their personal color preferences for screen data display. To set preferences you can use the command:
GCOSEE
There is no key value needed for the GCOSEE function since MAGEC will automatically use your Employee number (from your (cont.)
SYSLOG ON) as the key value, i.e. GCOSEE 000000018. GCOSEE can be done in a text environment , or in a GUI environemnt; (cont.)
but, you will not be able to veiw the results of your changes unless your are in a GUI environment.
You can only set preferences for the Employee number you are logged on as at the time. If you have more than one "logon (cont.)
ID", you must set the preferences for each individually. You preferences are saved in the repository (on the GCO file) (cont.)
using your Employee number as the record key.
If you have never yet set any preferences, MAGEC uses default settings which should work acceptably well for any but (cont.)
the most severely colorblind users. Once you set any preferences a record is created for you containing your settings, (cont.)
with default values for those combinations you have not specified.
In order to effectively control your screen colors you must first have a little understanding of how the system works.
A MAGEC-generated application can be executed in either text mode or GUI mode interchangeably without modifying or (cont.)
"re-compiling" the program; therefore the programs operate using only the basic text-level color controls. Your GUI (cont.)
color preferences translate those text-level color controls into GUI color combinations. Every GUI panel has a (cont.)

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