MARENLM uses FHS forms. The figure below shows the MARENLM basic form. Refer to the “FHS” manual [11] for further details. The interface is language-dependent. The language of the user interface can be set for a task using the MODIFY-MSG-ATTRIBUTES command. The English user interface is described here:
File ---> (1)
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File :
List of location specification More :
From 0 to 0 of 0 ---> (2)
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
********************************End of data*******************************
---> (3)
------------------------------------------------------------------------------
CMD==> ---> (4)
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL ---> (5)Structure of the MARENLM basic form
Menu bar (1)
The menu bar contains the available menu titles. Each of which, in turn, contains a group of menu options that are displayed in a drop-down menu below the menu title. From the File menu in the MARENLM menu bar, you can select the functions required to manage the reservation file.
Status area (2)
The status area informations you of the form contents and names the reservation file that is currently open.
Work area (3)
The work area displays the entries in the open reservation file and/or prompts a user selection. This is where parameters are queried or messages issued. A maximum of 3 entries are displayed in the work area. If not all entries can be displayed in the work area, the user can page through the work area accordingly. Entries to be edited can be selected. The selection is made with “x”,”X”, “/”, “A” or “a” in first column (column heading “S”). “x”,“X” or “/” selects an existing entry. The entry selected can then be changed or deleted using the function keys (or the relevant control statement in the command line). Positions for entering new entries can be selected with “x”,”X”, “/”, “a” or “A”.
If the entry is not selected, then the user cannot access the columns from “Location” to “FREE-POOL Name” (see "Editing entries in the reservation file").
The end of the reservation file is indicated by the following line:
********************************End of data*******************************
If no reservation file is open this line is displayed directly below the status area and no selection can be made in the work area. A new reservation file contains 3 “empty” entries which can be selected and edited.
Dialog boxes in which the parameters needed for an action are queried or in which messages are issued are also opened in the work area.
Command area (4)
The user can enter statements for interactive operations in the command line (see “Shortcut keys and control statements”).
Display area - key area (5)
The display area contains an overview of the current function key allocation.
Working with the MARENLM basic form
In the MARENLM basic form, menu options can be selected, commands can be issued using shortcut keys and control statements can be entered in the command area.
The functions pertaining to the management of the reservation file are all contained in the File menu in the menu bar.
You access the menu bar by pressing the cursor key 
or 
. In order to view the menu options, the selected menu title has to be confirmed with 
.
Within the menu, the options are numbered (starting with 1). To select an option from the menu, its number must be entered in the field in front of the first menu option. Depending on the menu and on the processing status, the field may already contain an option number. Confirm your entry by pressing the key.
If MARENLM requires further information in order to execute an action, a dialog box will be opened. You can enter the parameters MAREN needs in the dialog box. This manual contains a detailed description of the parameters following the function they belong to.
Messages
MARENLM messages are issued in a dialog box. To close the dialog box again, press the 
or 
key.
Error messages
If problems occur while a reservation file is being generated or opened, a DMS message is issued. A brief error description is output together with the four-character return code. If you require further information on the meaning of the return code, enter the following statement in the command line:
sys /help-msg DMS<dms-returncode>
When the complete error description has been displayed, you can return to MARENLM by pressing the key.
Shortcut keys and control statements
The object of shortcut keys is to speed up the entry of standard actions. The command is executed when a specific function key is pressed. The key area displays the function key allocations for various standard situations.
Control statements can be entered in the command area. For further information on control statements refer to the manual “FHS” [11].
The table below contains the MARENLM shortcut keys (function keys) and the control statements they belong to. Alternatively to the function keys, control statements can be entered in the command area.
| Key | Control statement | Meaning |
 | HELP | Calls context-sensitive help from FHS. |
 | EXIT | Terminates MARENLM, closes a dialog box. |
| INSERT | Inserts a new entry in the reservation file. The function can only be used if you marked an entry before. If you mark an entry with “X” or “/” the new entry is inserted above the marked entry, if you use “A” to mark an entry, the new entry will be inserted below the one you marked. |
 | ERASE | Deletes an entry from the reservation file. The function can only be used if you marked an entry before with “X” or “/”. |
 | FORWARD; + | Pages forward to the next page (3 entries). |
| +n | Pages forward n entries. | |
| ++ | Pages forward to the end of the file. | |
 | BACKWARD; - | Returns to the previous page (3 entries). |
| -n | Pages back n entries. | |
| -- | Pages back to the start of the file. | |
| MODIFY | Modifies an entry. The function can only be used if you marked an entry before with “X” or “/”. |
 | CANCEL | Cancels a function or selection, closes a dialog box. Terminates MARENLM when called from the basic menu. |
| SYS | Switches to BS2000 command mode. |
| RESHOW | Refreshes the screen contents. |
If no function keys are available you can allocate functions to the P keys using the SETP control statement. This allocation with SETP is only valid in the current MARENLM session.
The SETP control function is entered as follows:
SETP {Pn|(Pn,…,Pm)|Pn-Pm} {ON|OFF}[,…]
Operands
Pn | the P key with the number n all P keys listed, Pn,..,Pm the entire range of P keys, from Pn to Pm allocates the F key to the specified keys cancels the allocation |
The SETP operands can be specified several times. They have to be separated by a comma, as shown in the example below. The number of blanks surrounding each comma is irrelevant.
Example
SETP P1 ON, P2 OFF, (P3,P7,P8) ON, (P4-P6) OFF
This SETP control statement allocates the keys as follows:
P1 - F1, P3 - F3, P7 - F7, P8 - F8
The allocation of P2, P4, P5 and P6 was canceled.