operator that he/she is suspended when this occurs. The operator must contact a security officer in order to be (cont.) reinstated. The security officers may also require that an operator change his/her password at some minimum frequency by specifying (cont.) that each new password is only good for some number of days from the time it is set. If the number of days elapses and (cont.) the operator has not yet changed the password ``` **SYSLOG ON MAGEC User-View TS01, Term-ID PC01   M A G E C   SYSTEM LOG ON/OFF  EMPLOYEE NUMBER: _________ DATE: MM/DD/YY THURSDAY PASSWORD: ____   NOTE - To change your password: (1) enter OLD password above - DO NOT HIT ENTER, (2) enter NEW password below, (3) repeat it for verification,   (4) hit enter.   NEW PASSWORD:   REPEAT TO VERIFY: ** ``` Figure 07 --  Log On / Log Off Screen then he/she will be required to do so in order to log on. A message will appear saying "Time to Change Your Password". (cont.) Operators may be restricted to logging on only via certain user views or only at certain locations or certain days of (cont.) the week or times of the day or holidays. If an operator attempts to log on where or when not authorized, the log on (cont.) will be rejected with an error message. If the operator repeatedly attempts to log on and is repeatedly rejected, (cont.) he/she may be automatically suspended by MAGEC, requiring a security officer's help in order to be (cont.) reinstated. ## Time-Out In order to protect operators who sometimes forget to log off of the system before leaving for lunch or for the night, (cont.) the security officers can specify a time-out parameter for each operator and for each terminal. This specifies the (cont.) number of minutes that may elapse since the last entry at the terminal before MAGEC assumes that the operator has left (cont.) the area and automatically logs him/her off. The next time an entry is attempted, the log on screen will be presented (cont.) with the message shown below the password field saying: TIME OUT. The operator may re-enter the employee number and (cont.) password to log back on to the system. # Windows ## Swapping Windows The window swapping feature of MAGEC works for any function. You can press PF9 (F9 on a PC) or key the function code **SWAP any time to swap windows. The transaction on the screen at that time will be moved into the "hold window" and the (cont.) transaction from the hold window will be moved to the screen. Pressing PF9 again will swap them back (cont.) again. In a GUI environment there is a SWAP button which is equivalent to pressing PF9. If you are in the middle of some complex transaction and suddenly realize that you need to look up something on another (cont.) file or table using some other functions, pressing PF9 will "save" the current transaction allowing you to do any (cont.) number of other transactions and then, later, return to exactly where you left off. # Copy & Paste ## PF16 and PF17 Keys There is often the need to copy data from one screen display to another. For example, suppose the operator was adding a (cont.) record for a new customer which happened to be a department of a company in which other departments were already (cont.) customers. It would be handy to have the ability to copy the address from a screen display of the existing customer (cont.) into the address field for the new one to be added. That can be done using MAGEC's Copy & Paste (cont.) facility. There is a "holding area" (sometimes called a "cut/copy buffer", or "clipboard") which will hold up to 2,400 characters (cont.) of data. There are designated PF keys to enable the operator to copy screen data into the buffer or to copy data from (cont.) the buffer to the screen. They are: PF16 -- copy data to buffer PF17 -- paste data from buffer onto screen In a GUI environment (replaced by LAMP Stack MAGEC) there are COPY and PASTE buttons on your toolbar which are equiivalent to the PF16 and PF17 keys. The operator could, therefore, display the old customer's data and position the cursor to the address and press PF16 (cont.) (Shift-F6, on a PC). Then, while adding the new customer's data, position the cursor to the screen area where the (cont.) address is to be filled-in and press PF17 (Shift-F7, on a PC). The address data would be pasted onto the new screen, (cont.) saving many keystrokes and possible errors. When data is copied into the buffer (using the PF16 key) it remains in the buffer until the operator copies something (cont.) else into the buffer (thereby replacing it). That means that the operator could do any number of other transactions (cont.) before pasting that data into another screen. It also means that the data can be pasted more than once. Once data is (cont.) copied to the buffer the operator is not required to ever paste it anywhere, though. The Copy & Paste facility works on only one screen field at a time, each Copy operation overlays the data in the (cont.) buffer. If data is copied from a short field and pasted to a longer one it is padded with trailing spaces. If it is (cont.) copied from a long field to a shorter one, it is truncated on the right. This feature works equally well in conjunction with the Window Swap feature or in normal single screen mode. The buffer (cont.) is even retained when the operator logs off (via SYSLOG OFF) or simply exits MAGEC (via PF15) so that it is still (cont.) available when he/she returns. # Session Options ## Special Keys Option Any operator may set a session option code to specify that the PA1 (Ctrl-F1, on a PC) key and CLEAR (Esc, on a PC) key (cont.) are to be equated to certain, frequently-used functions in order to save operator keystrokes. To set the Option the (cont.) operator may at any time enter (into SFUNCT) the function code OPTION . No key value is required, as it will be filled in by the OPTION function using the operator's employee number. The (cont.) screen will be returned to the operator with the operator's name shown and the current session option code. The cursor (cont.) will be positioned onto the current code so that the operator may change his/her Special Keys session (cont.) option. The operator may alter the Special Keys option code and press ENTER (large plus key, on a PC) to set the new code for (cont.) this session and also to store the new code on his security system profile so that each time this operator logs on it (cont.) will automatically be set until it is again changed. If the operator desires to set the new code for this session only, (cont.) and not to store it for future sessions (log-ons) then he/she may do so by pressing the PF4 (F4 on a PC) key instead of (cont.) the ENTER key. There are five valid codes which may be set as the Special Keys option. Any other code will be rejected with an error message. The five valid codes are: **Code       Key       Meaning** A       PA1      return to application menu **      CLEAR      go to Logo screen B      PA1      go to main menu       CLEAR      go to Logo screen C      PA1      undefined       CLEAR      go to Logo screen D      PA1      go to MSKDEF screen       CLEAR      go to TSKLST screen E      PA1      return to application menu       CLEAR      go to main menu Option D is used only by application developers since the MSKDEF and TSKLST functions are not usually used by (cont.) non-developer personnel. The Option E (for Easy) is appropriate for novice users since it is very menu (cont.) oriented. ## Stack Option The Stack Option is also set on the OPTION screen. It controls how MAGEC will handle a stack overflow which occurs when (cont.) applications attach to other applications with the ability to return. An example of this is when a full-screen (cont.) application invokes a pop-up window application. Pressing PF3 in the pop-up will return to the first application. You (cont.) have several choices as to how to deal with the situation where the maximum number of returns has been saved and (cont.) another attach is being attempted. The choices will be presented on the screen. # Security ## Security Officers There are two levels of security officers, local and central. The local officers are, likely, the departmantal managers (cont.) and supervisors in the user departments. The central security officers are usually certain select individuals in the (cont.) central data processing facility. Local officers can handle all the day-to-day requirements in the user area: setting up new operators, suspending (cont.) operators who are no longer in the department, disabling and enabling terminals. Their authority to do these functions (cont.) is limited to their own location (or department). Whenever operators encounter difficulties with logging on or in accessing functions for which they feel they should be (cont.) authorized they should first contact the local security officer to try to remedy the problem. Central security officers have virtually unrestricted authorization and can set up local officers or suspend them and (cont.) can alter any security parameters for any location. If a problem cannot be solved at the local security officer level (cont.) then a central officer may be contacted. In some installations company policy might not allow for local officers. Then the central officers will have to be contacted for any problems first. ## Suspended Operators Operators may become "suspended" for a number of reasons. They may be suspended by a security officer via an online (cont.) transaction which takes effect immediately on being received by the system. They may be suspended automatically by (cont.) MAGEC as they attempt to log on if: They have reached the termination date set in the Security File. They attempt to log on unsuccessfully too many times in a row. They do not use the system (log on) for too many days and MAGEC assumes they are no longer active employees A security officer will have to be notified to reinstate an operator who is suspended. The automatic suspensions are to (cont.) protect against unauthorized accesses which might occur if a would-be intruder had an unlimited number of tries to (cont.) guess a correct password or to find one for an ex-employee. When the officer looks at the suspended operator's profile in the security system a message on the screen will indicate (cont.) to the officer why this operator was suspended. The officer may immediately reinstate the operator if (cont.) appropriate. ## Restricted Access Each operator has a security profile recorded in the system. In this profile are authorization level codes which (cont.) designate how high an authorization this operator has in each logical application. Logical applications are defined by (cont.) the security and development staff. Some possible logical applications are: 01 General Ledger 02 Accounts Payable - et cetera The number preceeding each name above indicates a logical application number as it might be assigned by persons who (cont.) define the logical applications for this organization. As new applications are developed new logical applications might (cont.) possibly be added. These logical applications are what appear on the main menu screen. When an operator uses (cont.) the **MENU function (or a special function key equated to it) to request the main menu, MAGEC lists on the screen each logical (cont.) application which is defined and for which this operator has any authorization at all. Every function code is defined as "belonging to" one logical application and as requiring some level of authorization (cont.) within that logical application in order to be accessed. The operator posesses some level of authorization (it might be (cont.) zero in some cases) in each of the logical applications. Before allowing the operator to access any function, MAGEC (cont.) checks that the operator's authorization for the proper logical application is sufficient for the function attempted. (cont.) If it is not, the operator will receive a message in SCOMPL saying "UNAUTHORIZED for "xxxxxx" (cont.) function". Whenever an operator requests an application menu, whether it was from the main menu or by keying the $$MENU function code, MAGEC lists functions belonging to the designated logical application. It shows only those for which the operator has sufficient authorization. In addition to restricting access by operator, MAGEC can also limit accesses made from any given terminal. At the time (cont.) that an operator logs on at a terminal, MAGEC reduces the operator's authorization levels for any logical application (cont.) in which the terminal has a lower (lower than the operator's) authorization level specified. This reduction is not a (cont.) permanent one, it applies only to this session and does not alter the operator's security profile. If such a temporary (cont.) reduction is made, a message saying so will display on the bottom line of the screen when the operator logs (cont.) on. Both operators and terminals may be restricted to use the system only on certain days of the week or times of the day (cont.) or holidays. An operator will be unable to successfully log on to a terminal if either the operator's or the terminal's (cont.) security profile does not permit it. The exception to this is in the case of central security officers whose ultra-high (cont.) authorization levels override many of the restrictions imposed upon ordinary operators and even local security (cont.) officers. # Printed Documentation ## The DOC File The online documentation which is displayed when the operator uses the HELP key (PF1) is stored on a system file which (cont.) data processing personnel know as the "DOC file". The DOC file can also store other kinds of (cont.) documentation. If User personnel desire hardcopy printouts of any documentation from the DOC file, whether it be online documentation (cont.) or other, a printout can be produced in minutes. The name of the utility program which is used to print documentation (cont.) is MAGECLBR . It may be run by data processing personnel on request. Full explanation on the use of MAGECLBR is included in the (cont.) "Offline Utilities" chapter of the MAGEC *Programmer's Reference Guide*, which the data processing department has (cont.) copies of. The control card format to print a hardcopy of any topic from the DOC file is: -MAGECPRT DOC tttt where : tttt               = any valid 30-character topic name You can view the documentation on the DOC file via the **HELP function discussed under the heading Viewing Documentation earlier in this section. # Short-Lists ## PF24 When you do any of the browse functions (i.e. LOC, SCN, FND) the program automatically saves a list of the keys to the (cont.) items found. For example, if you searched for customers named Jones and were returned a display showing five (5) (cont.) "matches", you could then cursor-select one of the displayed customers and receive either a display or update screen (cont.) for it. Very often you will next want to go to another of the five "matching" customers to do a similar (cont.) operation. You can use the PF24 (Alt-F4 on PC) key to request a display showing the list of matching items; this is called the (cont.) "Short-List" since it is a brief (up to sixteen items) list of selected items chosen from the much larger list (the (cont.) entire customer file). The Short-List will display the range of 16 items that were displayed last on the LOC, SCN, or (cont.) FND screen. Next: https://magec.com/DOC/markdown/user07.md.txt