MAREN subsystem
The MAREN subsystem is added to the current subsystem catalog when MAREN is installed with IMON. The subsystem declaration of MAREN is contained in the SYSSSC.MAREN.<ver> file. The MAREN subsystem must be started with /START-SUBSYSTEM SUBSYSTEM-NAME=MAREN when the BS2000 system is started.
Message file
The message file of MAREN is entered in the MIP parameter file and enabled by MIP when MAREN is installed with IMON.
The message file can also be included in the startup parameter service by adding it to the message file in the system parameter MSGFIL in the SYSOPT-CLASS2 parameter set and activating it when the monitor system is started:MSGFILxx=<msg_filename>
MSGOFL=n
Here xx is the serial number (01..15) in the system parameter MSGFIL, and msg_filename the fully qualified name of the message file.
The number n of message files must also be incremented by one accordingly.
The message file can also be assigned as a message output file retroactively using the MODIFY-MIP-PARAMETERS command.
Assigning the syntax file
The syntax file of MAREN is entered in the SDF parameter file and activated by SDF when MAREN is installed with IMON.
The syntax file can also be activated by means of the MODIFY-SDF-PARAMETERS command.
Preparing the MAREN catalog
An already existing MAREN catalog can be continued to use with the new MAREN version.
If, e.g. after first installation, MAREN operation is to be started with a new, empty MAREN catalog, the following steps are to be executed:
- The MAREN delivery package contains an empty catalog file (
SYSDAT.MAREN.<ver>.CATALOG). It contains a parameter record but does not contain catalog entries. This file must be cataloged as the file that is intended to be used for the future MAREN catalog, e.g.$SYSMAREN.MAREN.CAT. - The MAREN catalog can be edited with the administrator program MARENADM. For example, free tapes could be added to the list of tapes available for reservation with the MARENADM statement ADD-FREE-VOLUMES.
You must check free tapes to see if they need to be initialized so that they can be written to after being reserved. If the free tapes added need to be initialized, the INIT=*YES operand must be used in the MARENADM statement ADD-FREE-VOLUMES.
- In addition, the MARENADM statement ADD-RESERVED-VOLUME enables catalog entries to be generated for tapes which are assigned to a user ID but are not registered in the MAREN catalog. These may be created from the catalog entries of tape files in the TSOSCAT (VOLUME=*BY-TSOSCAT operand) or be taken from a SAM file with catalog entries in MAREN format (VOLUME=*ALL(INPUT-FILE=<file>) operand).
- If you want to add a large number of tape files in an incompatible format to the MAREN catalog, please contact a Competence Center or the Sales & Marketing Dept. of Fujitsu.
Starting the MAREN control programs MARENCP and, if required, MARENUCP
How to configure and start the MAREN control programs is described in the sections “MARENCP control program” and “Automatic free volume allocation with MARENUCP”.
Setting MAREN parameters
Various parameters can be used to control how MAREN works. The following types of parameter exist:
- System-specific parameters
These are set using the MARENADM statement EDIT-/MODIFY-MAREN-PARAMETERS or MODIFY-DOMAIN-ASSIGNMENT.When a system is added to the MAREN network the system-specific parameters are generated, see section “MAREN network”.
- Global parameters
These are set using the MARENADM statement MODIFY-GLOBAL-PARAMETERS. With the exception of the access mode (ACCESS-MODE parameter), global parameters are only meaningful when domains are used. - Domain-specific parameters
These are set using the MARENADM statement MODIFY-DOMAIN-PARAMETERS. The domain-specific parameters are only meaningful when domains are used.
The MAREN administrator can have the settings of the MAREN parameters displayed using the MARENADM statements SHOW-...-PARAMETERS, and adjust these to the conditions in his/her system using the EDIT-/MODIFY-...-PARAMETERS statements.
Effectiveness of modifications to parameters
The parameter sets modified with the EDIT-/MODIFY-...-PARAMETERS statements are stored in the MAREN catalog.
The modifications become effective immediately on the MAREN administrator’s system because the parameter records are read with every MAREN or MARENADM statement. Each time MARENUCP is called, MAREN transfers the parameter records to MARENUCP. To accept new values, MARENUCP need only be terminated and restarted when the access mode is changed (ACCESS-MODE parameter).
In a MAREN network, modifications to parameters also become effective immediately. Each time a MAREN component accesses the MAREN catalog on a system of the MAREN network, the modified parameter records are read and accepted.
The tables below provide an overview of the parameters. The parameters and their effect are described in detail under the MODIFY-...-PARAMETERS statements.
| System-specific parameters | Value range | Default setting | Description / Meaning |
| ALL-DOMAIN-ADMIN | ALLOWED / NOT-ALLOWED | NOT-ALLOWED | controls whether an ADA may work on the system |
| ARCHIVES-WORK-TIME | 0..23:59 | 00000000 | time the central archive is open |
| AUDIT | YES / NO / OPTIONAL | YES | controls the tape-specific checks |
| BATCH-EXEC-TIME | 0..32767 | 100 | batch task execution time |
| BATCH-REQUEST-TIME | 0..32767 | 1800 | batch task request time |
| CID-UID | YES / NO | NO | transfers catalog and user IDs to the catalog entry |
| DEFAULT-ADMIN-SCOPE | OWN-DOMAIN / ALL-DOMAIN | OWN-DOMAIN | administration scope when MARENADM is started |
| DEFAULT-DEVICE-TYPE | <name> | TAPE-C4 | default device type for new reservations |
| DEFAULT-FREE-DATE | 0..9999 | 7 | default reservation period for tapes |
| DEFAULT-HOME-LOC | <name> / HOST | CENTRAL | default permanent location |
| DEFAULT-USER-ACCESS | OWNER-ONLY / FOREIGN-READ- ONLY / ALL-USERS | OWNER-ONLY | determines whether tapes are shareable by default |
| DEVICE-COMPLETION | YES / NO | YES | DEVICE parameter completion |
| DIALOG-EXEC-TIME | 3..32767 | 50 | dialog task execution time |
| DIALOG-REQUEST-TIME | 3..32767 | 180 | dialog task request time |
| EXPORT-ADDRESS-ACK | YES / NO | NO | mailing address confirmation |
| EXPORT-FOREIGN-TAPES | YES / NO | NO | export foreign tapes |
| EXPORT-PROCESSING | YES / NO | YES | export permission |
| EXPORT-RECEIPT | CONSOLE / PRINTER / FILE / NO | NO | receipt output control |
| FOREIGN-TAPE-CHECK | YES / NO | YES | foreign tape check |
| FREE-POOLS | NO / GLOBAL / TSOS / <name> | empty | free tape pool |
| HOST | <name> | empty | name of the local system |
| INPUT-FILE-CHECK | YES / NO | NO | input file name check |
| INPUT-TAPE-CHECK | YES / NO | YES | input tapes check |
| LOCATION-NAME | <name> / CENTRAL | CENTRAL | name of a location |
| LOGGING | YES / NO | NO | definition of logging |
| MAREN-PASSWORD | <c-string> / <x-string> / <integer> / NONE / SECRET | NONE | MAREN password |
| MOUNT-CHECK-INTERVAL | <integer 9..9999> | 60 | wait time until a check is made to see whether a tape has been mounted |
| OPERATING-MODE | MANUAL / ROBAR-1 / ROBAR-2 / EXTERNAL | MANUAL | operating mode of a storage location |
| OPERATOR-ROLE | <name 1..8> | SYSMAREN | operator role which is required when MARENUCP runs or INITIALIZE-VOLUMES is called |
| OVERRULE-LOC | YES / REJECT | YES | allows / rejects the use of a location other than the one specified in MARENLM |
| PRIVILEGED-USER-ID | <userid> / NONE | empty | user privilege assignment |
| RESERVATION-SEQUENCE | BY-VSN / BY- RESERVATION- COUNT / BY-LAST-ACCESS- DATE / BY-FREE-DATE | BY-VSN | the tapes which are to be reserved are selected in the order specified here |
| RESERVE-DEVICE-TYPES | <name> | TAPE-C4 / T6250 | device types which are permissible for new reservations |
| RETPD-CHECK | YES / NO | YES | reservation period check |
| SHOW-INFORMATION | NORMAL / MAXIMUM | NORMAL | determines the format for output to SYSOUT |
| SYMBOLIC-NAME | SAME / <name> | SAME | symbolic name of a location |
| TESTMODE | YES / NO | NO | switches test mode on/off |
| TSOS-PRIVILEGED | YES / NO | NO | TSOS privilege assignment |
| TYPE | REMOTE / LOCAL | LOCAL | location ID |
| Global parameter | Value range | Default setting | Description / Meaning |
| ACCESS-MODE | SHARED / EXCLUSIVE | SHARED | mode of access to the MAREN catalog (shared or exclusive) 1 |
| ALL-DOMAIN-ADM-PASSW | <c-string> / <x-string> / <integer> / NONE / SECRET | NONE | password for the All-Domain Administrator |
| DOMAIN-PROTECTION | ACTIVE / NON-ACTIVE | NON-ACTIVE | controls whether domains are used |
1See section “Selecting the mode”
| Domain-specific parameters | Value range | Default setting | Description / Meaning |
| FREE-VOLUMES | FROM-OWN- DOMAIN / FROM-STD- DOMAIN | FROM-STD-DOMAIN | defines whether free tapes are taken from the user’s own domain or the standard domain |
Other adjustments
- If required, all users of the MAREN user program can be sent a message with the aid of the MAREN bulletin feature. The relevant text should be stored in the file defined during installation with IMON (see section “MAREN bulletin”).
- If the standard form implemented in MAREN is not to be used for export receipts, a customized layout for export receipts and return notes must be designed (see section “Export receipt”).
- If required, exit routines can be created and incorporated in a module library in order to modify certain MAREN activities see chapter “MAREN exits”.
Security aspects
In cases where data security is the top priority, the following recommendations must be considered:
Setting the system-specific MAREN parameters.
FOREIGN-TAPE-CHECK = YES
INPUT-TAPE-CHECK = YES
INPUT-FILE-CHECK = YES
RETPD-CHECK = YES
TSOS-PRIV = NO
PRIVILEGED-USER-ID = *NONE
MAREN-PASSWORD = YES
LOGGING = YES
AUDIT = YES- The MAREN catalog must have the attribute USER-ACCESS=*OWNER-ONLY.
- The MAREN catalog and the logging files should be situated on different pubsets.
- To prevent archive numbers of the same name being mistaken for each other, there should be only one MAREN catalog in each data center.
- All the tapes of an archive system should belong to a single MAREN catalog.
- Before the MAREN subsystem is unloaded, the data center must take the necessary organizational steps to ensure that tape processing is no longer possible.