(not A)             (A but not B) XOR       Exclusive or connection             (either A or B but not both) Every FND function should have complete explanations for using all options included in the online documentation. If the (cont.) developer has produced the application using the recommended standard set of function codes, then MAGEC will have (cont.) automatically added a full explanation of the FND function to whatever other Custom Documentation might have been (cont.) provided. The FND functions can be used to do complex searches of the database as needs arise. In many cases these functions will (cont.) allow the operator to satisfy ad hoc requirements without calling on data processing personnel for assistance and (cont.) without waiting for custom programming to be done. Since the same information is displayed on the LOC, SCN, and FND (cont.) screens the value of these functions will be greatly enhanced if Data Processing and User personnel collaborate on (cont.) their design. Note:** When you do a selection from any of the browse or query screens (LOC, SCN, or FND) MAGEC saves the list of keys (cont.) of the items which were displayed to you (the items which matched your selection criteria if you were doing a SCN or (cont.) FND). This saved list is called the "Short List". Cursor-selecting an item takes you to a display or update screen for (cont.) that item; you can then select another item from the Short List by pressing PF24, requesting a pop-up window listing (cont.) the Short List, and cursor selecting from it. When you cursor select from the Short List you must press PF24; that (cont.) selects the item and returns to your full-screen display or update for the selected item. See the topic Short Lists, (cont.) later in this manual. ** CUSFND 1 END OF LIST - PF5=Restart/PF7=Backward  Search Arg: corp............................................................... Cus#  Name  City ...... (.....................) ...................... 001024  Jones Corporation  San Francisco 002305  Fleming Incorporated  Los Angeles 022167  Scorpion Enterprises  New York ++++ 37 Records Scanned, 03 Displayed so far - Page 1 ++++ KEY 1 = Customer # 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 06 --  Sample FND function # Changing Browse Direction ## The PF8 and PF7 Keys In all browse functions (LOC, SCN, and FND) the PF8 key causes your screen to page forward one screenful; the PF7 key (cont.) causes your screen to page backward one screenful. A display at the bottom left corner of your screen will tell you (cont.) whether you are going forward or backward. If you are doing a query (SCN or FND) you can cause the program to search forward or backward using these same keys. In inquiry functions (SEE and NXT) PF8 will read forward and display the next item and PF7 will read backward and display the prior item from the one which had been displayed. # Simulating PF/PA Keys ## **PFnn and **PAnn Function Codes There might be some instances when you wish to use a particular PF key or PA key but cannot because of any of several (cont.) reasons. Your terminal keyboard might not have that key (some older models do not have every possible key). Your (cont.) mainframe system might have designated that particular key for some special purpose, in which case the key is (cont.) "intercepted" before it can reach the MAGEC applications. Your keyboard might be faulty. Regardless why you cannot use the desired key, there is an alternate method for simulating any valid key. You move the (cont.) cursor to the SFUNCT screen field (the simplest way to do that is to press HOME), then you type in one of the special (cont.) function codes: **function codes      keys simulated** **PF01 thru **PF24      PF1 thru PF24 **PA01 thru **PA03      PA1 thru PA3 Then just press ENTER. You can even use cursor-selection in conjunction with this key simulation. Just type in the special function code, position the cursor where you want it, then press ENTER. # Broadcast Message ## MSGSEE Function Sometimes it is necessary for the Central Computer Site personnel, such as security officers, mainframe operators, (cont.) etc., to issue a message to all system users informing them of some event or situation affecting them. A good example (cont.) of this is: the computer is scheduled to be "down" from noon to 1:00 today. A Broadcast Message Facility is built into MAGEC and all applications developed using MAGEC. Any operator may see the current Message by using the function code MSGSEE. entered into SFUNCT. There is no key value required and if one is keyed into SKEY it will be ignored. The current (cont.) Broadcast Message will be displayed on the operator's screen with the function code altered to MSGSAW. Pressing ENTER with the MSGSAW function will indicate to MAGEC that you *have seen* the message. If MAGEC "thinks" that an operator has not seen the current message then there will be a Notification message displayed (cont.) on the last line of the screen saying: "THERE IS A MESSAGE FOR YOU - USE MSGSEE, OR PRESS PF1 TO SEE (cont.) IT". Whenever this Notification is shown on the last line of the screen the PF1 (or F1 on a PC) key, usually designated as (cont.) the HELP key, is automatically equated to the MSGSEE function. Pressing it at that time will simulate the operator's (cont.) having keyed MSGSEE into SFUNCT and will display the Broadcast Message with the MSGSAW function code set. Pressing (cont.) ENTER after reading the message indicates to MAGEC that this operator has seen the message, so the Notification (cont.) disappears and PF1 reverts to its normal HELP key function. # Getting Into MAGEC ## In a CICS Environment One of the most common environments in which MAGEC applications are used is called "CICS". CICS is a product of IBM. If (cont.) the operator does not know whether the environment is CICS or not he/she should contact the Data Processing department. (cont.) This section describes how to get into MAGEC in a CICS environment, for other environments see (cont.) below. MAGEC is sub-divided into sixteen (16) "user views". When an operator wishes to "get into" MAGEC he/she does so via one of these user views. The user views are named: **Test User-Views      Production User-Views** TS01                    PR01 TS02                    PR02 TS03                    PR03 TS04                    PR04 TS05                    PR05 TS06                    PR06 TS07                    PR07 TS08                    PR08 The MAGEC security system might specify that some operators are allowed to use some user views and not others, and that (cont.) some terminals are allowed into some user views and not others. Another security system which is built into CICS might (cont.) also impose some limits on operators and terminals with regard to accessing these user views. The MAGEC security system might also specify that some function codes are allowed in some user views and not others. User views are an important part of security control in MAGEC. An operator can always determine whether he/she is already in MAGEC by pressing the CLEAR key. If in MAGEC, the CLEAR (cont.) key will result in either the MAGEC "logo" screen, the MAGEC log on screen, or a MAGEC Menu screen depending on the (cont.) setting of the operator's Special Keys session option. In any case it will be obvious to the operator that he/she is or (cont.) is not already in MAGEC when the CLEAR key is pressed. If not already in MAGEC, the operator should "home" the cursor (cont.) (move it to top-left corner of screen) and key one of the four-character user-views and press ENTER. Once "into" MAGEC the operator will probably be required to log on (identify him/herself) before being allowed to do (cont.) any other function. Logging on is initiated by entering "SYSLOG" in SFUNCT and "ON" in SKEY. There are also automatic (cont.) logon facilities built into MAGEC which can log the operator on vased upon his/her having logged onto a higher-level (cont.) security system, such as RACF, TopSecret, or ACF2. After getting into MAGEC all procedures are identical regardless of which environment is installed (CICS or other). Refer to the section of this manual titled Logging On/Off for log on procedures. ## In a Westi Environment One of the common environments in which MAGEC applications are used is called "Westi". Westi is a product of (cont.) Westinghouse Corporation. If you do not know if your environment is Westi or not you should contact the Data Processing (cont.) department. This section describes how to get into MAGEC in a Westi environment, for other environments see (cont.) below. MAGEC is sub-divided into sixteen (16) "user views". When an operator wishes to "get into" MAGEC he/she does so via one of these user views. The user views are named: **Test User-Views      Production User-Views** TS01                    PR01 TS02                    PR02 TS03                    PR03 TS04                    PR04 TS05                    PR05 TS06                    PR06 TS07                    PR07 TS08                    PR08 The MAGEC security system might specify that some operators are allowed to use some user views and not others and that (cont.) some terminals are allowed into some user views and not others. Another security system which is part of Westi might (cont.) also impose some limits on operators and terminals with regard to accessing these user views. The MAGEC security system might also specify that some function codes are allowed in some user views and not others. User views are an important part of security control in MAGEC. An operator can always determine whether he/she is already in MAGEC by pressing the CLEAR key. If in MAGEC, the CLEAR (cont.) key will result in either the MAGEC "logo" screen, the MAGEC log on screen, or a MAGEC Menu screen depending on the (cont.) setting of the operator's session option. In any case it will be obvious to the operator that he/she is or is not (cont.) already in MAGEC when the CLEAR key is pressed. If not already in MAGEC then the operator should press the CLEAR key to (cont.) obtain the Westi Main Menu screen and key one of the four-character user views and press ENTER. Once "into" MAGEC the operator will probably be required to log on (identify him/herself) before being allowed to do (cont.) any other function. Logging on is initiated by entering "SYSLOG" in SFUNCTand "ON" in SKEY. After getting into MAGEC all procedures are identical regardless of which environment is installed (Westi or other). Refer to the section of this manual titled Logging On/Off for log on procedures. ## In a PC Environment MAGEC may also be run in a PC environment, either standalone, or as a PC workstation on a network. In text mode, the PC environment essentially emulates the CICS environment. In a Windows or OS/2 environment, simply mouse-seelct the appropriate icon from your Windows group or OS/2 folder--MAGEC will startup automatically. **Note:** Please refer to Appendix A of this manual for the MAGEC keyboard emulation template which will equate 3270 PF and PA keys to PC keys. MAGEC is sub-divided into sixteen (16) "user views". When an operator wishes to "get into" MAGEC he/she does so via one of these user views. The user views are named: **Test User-Views      Production User-Views** TS01                    PR01 TS02                    PR02 TS03                    PR03 TS04                    PR04 TS05                    PR05 TS06                    PR06  TS07                    PR07 TS08                    PR08 The MAGEC security system might specify that some operators are allowed to use some user views and not others, and that some terminals are allowed into some user views and not others. The MAGEC security system might also specify that some function codes are allowed in some user views and not others. User views are an important part of security control in MAGEC. An operator can always determine whether he/she is already in MAGEC by pressing the CLEAR (Esc, on a PC) key. If in (cont.) MAGEC, the CLEAR key will result in either the MAGEC "logo" screen, the MAGEC log on screen, or a MAGEC Menu screen (cont.) depending on the setting of the operator's session option. In any case it will be obvious to the operator that he/she (cont.) is or is not already in MAGEC when the CLEAR key is pressed. If not already in MAGEC, the operator should key one of (cont.) the four-character user-views at the DOS prompt and press ENTER. Once "into" MAGEC the operator will probably be required to log on (identify him/herself) before being allowed to do (cont.) any other function. Logging on is initiated by entering "SYSLOG" in SFUNCT and "ON" in SKEY. There is a facility built (cont.) into MAGEC which can automatically log the operator onto MAGEC based upon his/her having logged onto the network's (cont.) security system. This eliminates the need for the operator to see or use the SYSLOG ON screen. After getting into MAGEC all procedures are identical regardless of which environment is installed (PC or other). Refer to the section of this manual titled Logging On/Off for log on procedures. # Getting Out of MAGEC ## PF15 Key Regardless what environment is installed (CICS, IBM-PC, Westi, etc.) and regardless what function or screen is (cont.) presently being used by the operator, MAGEC may always be exited by pressing the PF15 (Shift-F5 on PC) key. If you are (cont.) at a mainframe terminal, a MAGEC option was specified by the data processing personnel as to what non-MAGEC application (cont.) is to be transferred to when PF15 is hit. In a GUI environment there is an EXIT button in your toolbar which will automatically press PF15. On the mainframe, pressing PF15 does not log the operator off - it simply exits MAGEC. **Note:** Via the global system parameters contained in Table #243 you can establish a routine which is to be invoked (cont.) immediately after exiting MAGEC via PF15. This routine may execute any other online transaction desired; therefore, it (cont.) is up to your Systems department to determine what is executed when you press PF15. # Logging On and Off In order to log on to MAGEC the operator must have been defined to the MAGEC security system by a security officer. (cont.) When the officer defines the operator, an employee number and an initial password will be assigned. Thereafter, that (cont.) operator can log on and off using the commands SYSLOG ON or SYSLOG OFF as appropriate. Logging off may be done from any MAGEC application screen at any time by simply keying the command and (cont.) pressing ENTER. When logging on, the command must be keyed into SFUNCT and SKEY and when ENTER is pressed the screen (cont.) returns to the operator in the format shown in figure 07. The operator must correctly enter his/her employee number (operator ID) and four-character password. If these are (cont.) correctly entered and no other situation exists to preclude MAGEC's accepting the log on, the message "Log On Firstname (cont.) Lastname" will appear below the password. Lastname and Firstname in the sample message are the operator's names. The (cont.) operator may now proceed to do any MAGEC application functions for which he/she has been authorized by the security (cont.) officers. If any portion of the entry is incorrect then the operator will have to retry logging on by rekeying the password and, (cont.) if it is wrong, the employee number. The password must be rekeyed on every attempt to log on even if it was correctly (cont.) keyed before, since MAGEC "wipes out" the passwords on the screen for security reasons. ## Changing the Password If you wish to change the password at any time it may be changed as you log on. To change the password, enter the (cont.) employee number and password, as usual, then skip the cursor down to the NEW PASSWORD screen field and key the new (cont.) password into it. In order to be sure that you have not accidentally miskeyed the new password it must be repeated (cont.) again below exactly as it was entered into the NEW PASSWORD field. **Note:** All three password entry fields on the screen are "dark" fields; they are invisible to the operator and (cont.) anyone overseeing the entry. All three are "wiped out" by MAGEC every time the operator presses ENTER (or any other (cont.) transmit key) for security reasons. If the operator has to retry the log on because of any error all three will have to (cont.) be re-keyed. Certain verifications are made to guard against changing the password to one which is easy to guess by unauthorized (cont.) persons. If the "guessing routine" built into MAGEC is able to guess the new password then you will receive the error (cont.) message "New Password is TOO EASY" and will have to choose a better password. It is possible for the security officers to suspend an operator for any reason, it is also possible for MAGEC to (cont.) automatically suspend an operator for a variety of reasons. Some examples are: exceeding the maximum number of failed (cont.) logon attempts, attempting to log on after the operator's termination date, etc. A message on the screen will tell the (cont.) Next: https://magec.com/DOC/markdown/user06.md.txt