Privilege ADA, DA, administrator without domains
This statement is used to define or modify the system-specific MAREN parameters of a BS2000 system.
When a MAREN parameter is modified on the local system using this statement, this modification becomes effective immediately.
This modification becomes effective on the other systems of the MAREN network from the time when the MAREN control program executing there first reads the modified parameter set. This occurs, for example, when the MAREN administrator has entered the SHOW-MAREN-PARAMETERS statement.
The default value *UNCHANGED in the corresponding operands signifies that the previous declaration is applicable.
Format
MODIFY-MAREN-PARAMETERS Alias: MDMP | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1The Operand value *V8.1-AND-LOWER is obsolete. It can still be specified for compatibility reasons.
Operands
LOCATION-ENTRIES = *UNCHANGED / *PARAMETERS(...)
In MAREN a location table is kept in which all locations are entered. Any changes to the location table are entered in the MAREN catalog.
LOCATION-NAME = <alphanum-name 1..8>
Location name. For a processing location, the system name must be specified.
ACTION = *ADD(...) / *REMOVE
Specifies whether the specified location name is to be added or deleted.
ACTION = *ADD(...)
Specifies whether the location is to be added. A maximum of 24 locations may be defined.
SYMBOLIC-NAME = *SAME / <alphanum-name 1..8>
Symbolic location name. Each location name can be assigned a symbolic location name to make addressing easier.
SYMBOLIC-NAME = *SAME
Declares that the name specified for the LOCATION-NAME parameter is to be used.
TYPE =
This location identifier refers to the physical distance between the location and the data center.
TYPE = *LOCAL
Specifies that the location is in the area of the local data center. This means that the tapes from this location can be directly requested for processing purposes.
TYPE = *REMOTE
Specifies that the location is in the area of a remote data center. This means that any request to process tapes located there is rejected by MAREN because the volume is not available locally.
OPERATING-MODE =
Operating mode from which MAREN recognizes the location to which the jobs are to be sent.
OPERATING-MODE = *MANUAL
Location to be operated manually.
OPERATING-MODE = *ROBAR-1
Operating mode for real archive systems which are controlled via ROBAR.
OPERATING-MODE = *ROBAR-2
Operating mode for the archive system ETERNUS CS which is controlled via ROBAR.
OPERATING-MODE = *EXTERNAL
Operating mode for the location of a group of tapes and tape devices. The group is, for example, at a separate location which is to be operated manually in a remote building. The tapes in this archive should be processed only on the tape devices located there and not be mixed with tapes from other locations.
OVERRULE-LOCATION = *UNCHANGED / *YES / *REJECT
Specifies whether a location specified by the user is preferably used when a reservation file is employed.
OVERRULE-LOCATION = *REJECT
The location specified by the user is employed (differing locations lead to the reservation being rejected).
OVERRULE-LOCATION = *YES
The location specified in the reservation file is used.
VOLUME-ACCESS-CHECKS = *UNCHANGED / *PARAMETERS(...)
Specifies which of the various tape checks are to be performed by MAREN.
INPUT-TAPE-CHECK = *UNCHANGED / *YES / *NO
Specifies whether all tape checks are also to be performed in the case of input tapes (see the AUDIT operand on "MODIFY-MAREN-PARAMETERS Modify system-specific MAREN parameters").
INPUT-FILE-CHECK = *UNCHANGED / *YES / *NO
Specifies whether the file name is to be checked in the case of input tapes (see also operand AUDIT on "MODIFY-MAREN-PARAMETERS Modify system-specific MAREN parameters").
TSOS-PRIVILEGED = *UNCHANGED / *YES / *NO
Specifies whether the user ID TSOS is to be excluded from the tape checks.
PRIVILEGED-USER-ID = *UNCHANGED / *NONE / <name 1..8>
User ID to be excluded from the tape checks.
RETPD-CHECK = *UNCHANGED / *YES / *NO
Specifies whether the file expiration date (catalog entry field EXPIRATION-DATE) is to be checked for output tapes (see also operand AUDIT on "MODIFY-MAREN-PARAMETERS Modify system-specific MAREN parameters").
FOREIGN-TAPE-CHECK = *UNCHANGED / *YES / *NO
Specifies whether all foreign tapes are to be entered in the MAREN catalog before processing.
FOREIGN-TAPE-CHECK = *YES
All tapes must be entered in the MAREN catalog prior to processing. Otherwise, any attempt to access a tape will be rejected with an error message.
FOREIGN-TAPE-CHECK = *NO
When accessing foreign tapes not included in the MAREN catalog, the tape checks are not performed and no messages are issued.
DEVICE-COMPLETION = *UNCHANGED / *YES / *NO
Automatic completion of the specifications in the IMPORT-FILE command or FILE macro.
DEVICE-COMPLETION = *YES
For file assignments with the operand VOLUME=vsn but without a DEVICE entry, the device type (if any) from the MAREN catalog entry is included in the parameter list of the corresponding DMS command or macro.
DEVICE-COMPLETION = *NO
The parameter list is not modified.
AUDIT = *UNCHANGED / *YES / *NO / *OPTIONAL
Specifies whether accesses to these tapes are to be monitored by MAREN and, if necessary, aborted.
AUDIT = *YES
Accesses are monitored. The AUDIT flag in the catalog entries of the tapes is not evaluated. In the event of an error the basic action is aborted. Individual tape checks can, however, be disabled using the FOREIGN-TAPE-CHECK, INPUT-TAPE-CHECK, INPUT-FILE-CHECK and RETPD-CHECK operands. Specific user IDs can also be excluded from monitoring.
AUDIT = *NO
Accesses are not monitored. The AUDIT flag in the catalog entries of the tapes is not evaluated. Individual tape checks which were enabled using the FOREIGN-TAPE-CHECK, INPUT-TAPE-CHECK, INPUT-FILE-CHECK and RETPD-CHECK operands are performed, but in the event of an error they do not lead to an abortion.
AUDIT = *OPTIONAL
Accesses are monitored, and errors which are detected are reported. However, the action involved is only aborted if the AUDIT flag is set in the catalog entry of the tape concerned or no catalog entry exists. Individual tape checks can, however, be disabled using the FOREIGN-TAPE-CHECK, INPUT-TAPE-CHECK, INPUT-FILE-CHECK and RETPD-CHECK operands. Specific user IDs can also be excluded from monitoring.
TEST-MODE = *UNCHANGED / *YES / *NO
Enables or disables test mode.
CAUTION!
When test mode is enabled, only tasks with the job name MARENTST are recorded by MAREN. For all other tasks, both all tape checks and the updating of the MAREN catalog are suppressed. The usual protection mechanisms will not be applied. Inconsistencies between backup archives and file catalogs may happen.
LOGGING = *UNCHANGED / *YES / *NO
Defines whether a record is written into the logging file for each modification of an catalog entry.
CID-UID = *UNCHANGED / *YES / *NO
When tape output files are created, causes not only the job name, date and time, but also the catalog ID of the pubset and the user ID under which the file is created to be included in the catalog entry. This does not apply for ARCHIVE backup runs with directory because in these cases the directory name is stored in the catalog entry with the catalog and user IDs.
MOUNT-CHECK-INTERVAL = *UNCHANGED / <integer 9..9999 seconds >
Defines the interval, in seconds, at which MARENUCP periodically checks whether a tape has been mounted. The first interval begins with the request for the operator to mount a free tape. The default value set is 60.
Only when MARENUCP first starts the value from the MARENUCP-ENTER file is accepted (the default value applies if nothing is specified); subsequently the specification in the ENTER file is ignored.
RESERVATION-SEQUENCE = *UNCHANGED / *BY-VSN /
*BY-RESERVATION-COUNT / *BY-LAST-ACCESS-DATE / *BY-FREE-DATE
Defines the criterion according to which MARENUCP selects free tapes. The default value set is *BY-VSN.
Only when MARENUCP first starts the value from the MARENUCP-ENTER file is accepted (the default value applies if nothing is specified); subsequently the specification in the ENTER file is ignored.
RESERVATION-SEQUENCE = *BY-VSN
The selection criterion is the sequence of the archive numbers, beginning with the lowest alphanumeric archive number.
RESERVATION-SEQUENCE = *BY-RESERVATION-COUNT
The selection criterion is the number of reservations, beginning with the lowest number.
RESERVATION-SEQUENCE = *BY-LAST-ACCESS-DATE
The selection criterion is the date of the most recent access, beginning with the earliest date.
RESERVATION-SEQUENCE = *BY-FREE-DATE
The selection criterion is the date of the most recent release, beginning with the earliest date.
OPERATOR-ROLE = *UNCHANGED / <name 1..8>
Operator role which is to be used for the execution of MARENUCP and for the INITIALIZE-VOLUMES statement. When MARENCP is first started, the operator role SYSMAREN is entered.
MAREN-DEFAULTS = *UNCHANGED / *PARAMETERS(...)
Specifies the MAREN default values which are to be modified.
DEFAULT-FREE-DATE = *UNCHANGED / <integer 0..9999>
Number of days. Specifies the reservation period for tapes if the user has not made an appropriate entry during reservation.
DEFAULT-HOME-LOC = *UNCHANGED / *HOST / <alphanum-name 1..8>
Location name. Specifies which name is to be used for the permanent location in statements with the parameter HOME-LOCATION=*STD.
DEFAULT-HOME-LOC = *HOST
The local system name is used on every system.
DEFAULT-DEVICE-TYPE = *UNCHANGED / <alphanum-name 1..8>
Defines the default device type. The default device type declared is used as the default in nearly all statements. If no explicit specification is made for the DEVICE-TYPE operand in these statements, only tapes of the device type DEFAULT-DEVICE-TYPE are selected. An exception to this is the SHOW-VOLUME-ATTRIBUTES statement.
DEFAULT-USER-ACCESS =
Specifies whether foreign user IDs may access the tape.
DEFAULT-USER-ACCESS = *OWNER-ONLY
Access to the tape is possible only under the specified user ID.
DEFAULT-USER-ACCESS = *FOREIGN-READ-ONLY
Only read access to the tape is possible under a foreign user ID.
DEFAULT-USER-ACCESS = *ALL-USERS
Unrestricted access to the tape is possible under a foreign user ID.
RESERVE-DEVICE-TYPES = *UNCHANGED / *PARAMETERS(...)
MAREN keeps a table which must contain all volume types which are permissible for new reservations. Up to 20 entries can be defined.
DEVICE-TYPE = <structured-name 1..8>
Device type. For a list of possible entries (depending on the BS2000 version), see manual “System Installation” [6].
ACTION = *ADD / *REMOVE
Specifies whether the device type is to be added or deleted.
EXPORT-RESTRICTIONS = *UNCHANGED / *PARAMETERS(...)
Restrictions with respect to the MAREN statement EXPORT-VOLUME.
EXPORT-PROCESSING = *UNCHANGED / *YES / *NO
Specifies whether the MAREN statement EXPORT-VOLUME for exporting own tapes is to be permitted.
EXPORT-FOREIGN-TAPES = *UNCHANGED / *YES / *NO
Specifies whether the export of own tapes assigned to a foreign user ID with the attribute USER-ACCESS=ALL-USERS is to be permitted.
EXPORT-ADDRESS-ACK = *UNCHANGED / *YES / *NO
Specifies whether the defined mailing address should be acknowledged by the operator when exporting or returning tapes.
ARCHIVES-WORK-TIME = *UNCHANGED / *PARAMETERS(...)
Time the central archive is open. Tapes can only be exported or returned during the specified time period. Any specifications entered in seconds will be ignored.
OPEN-TIME = <time>
Opening time in the format hh[:mm[:ss]], where initial zeros need not be entered for hh, mm and ss.
CLOSE-TIME = <time>
Closing time in the format hh[:mm[:ss]], where initial zeros need not be entered for hh, mm and ss.
When the value “24:00” is specified in the CLOSE-TIME operand, CLOSE-TIME=00:00 is used. OPEN-TIME=00:00 and CLOSE-TIME=00:00 also mean that the archive is open all day.
EXPORT-RECEIPT = *UNCHANGED / *CONSOLE / *PRINTER(...) / *FILE / *NO
This operand controls the creation and printout of the export receipts of the EXPORT-VOLUME statement. The layout of the export receipt is described in section “Export receipt”.
EXPORT-RECEIPT = *CONSOLE
No export receipt is generated. The message MARM162 appears on the console.
EXPORT-RECEIPT = *PRINTER(...)
Specifies that the export receipts are to be generated and printed immediately. For this purpose, the temporary file MAREN.EXPORT-RECEIPT.<vsn> is created under the user ID of the calling task. If this file already exists, it is extended with OPEN=EXTEND. The result is the same as a printout produced with the PRINT-DOCUMENT in conjunction with DOCUMENT-FORMAT=*TEXT(LINE-SPACING=*BY-EBCDIC-CONTROL) and DELETE-AFTER-PRINT=*DESTROY. This specification is also evaluated for the statements RETURN-VOLUMES and SECURE-FREE-VOLUMES with the operand MESSAGE-DEST=*PRINTER.
DEVICE-NAME =
Identifies the printer to be used for output.
DEVICE-NAME = *ANY-LOCAL-PRINTER
Output is to a local printer.
DEVICE-NAME = <name 1..8>
Output is to a RSO printer.
FORM-NAME =
Identifies the paper (form type) to be used for output.
FORM-NAME = *STD
A standard form is used.
FORM-NAME = <alphanum-name 1..6>
Name of the form to be used. This name must be defined in the SPOOL parameter file and can be queried by means of the SHOW-SPOOL-FORMS command. The SPOOL parameter file also defines whether a cover page is to be printed (see the “Spool & Print - Commands” manual [23]).
EXPORT-RECEIPT = *FILE
Specifies that the export receipt is only to be written to the file MAREN.EXPORT- RECEIPT.<vsn> under the user ID of the calling task and is not to be printed. If the file does not exist or is empty, it is created. If this file already exists, it is extended with OPEN=EXTEND. The file can be printed later using the PRINT-DOCUMENT command.
EXPORT-RECEIPT = *NO
Specifies that export receipt are not to be created.
LIFE-TIME-LIMITS = *UNCHANGED / *PARAMETERS(...)
Specifies how long the tasks are to remain in certain wait states.
BATCH-REQUEST-TIME = *UNCHANGED / <integer 0..32767 seconds >
Wait time in seconds. Specifies the maximum time a batch task is to wait for acceptance of a MAREN transaction (access to the MAREN catalog).
BATCH-EXEC-TIME = *UNCHANGED / <integer 0..32767 seconds >
Wait time in seconds. Specifies the maximum time a batch task is to wait for execution of a MAREN transaction.
DIALOG-REQUEST-TIME = *UNCHANGED / <integer 3..32767 seconds >
Wait time in seconds. Specifies the maximum time an interactive task is to wait for acceptance of a MAREN transaction.
DIALOG-EXEC-TIME = *UNCHANGED / <integer 3..32767 seconds >
Wait time in seconds. Specifies the maximum time an interactive task is to wait for execution of a MAREN transaction.
MAREN-PASSWORD = *UNCHANGED / *NONE / <c-string 1..4> / <x-string 1..8> /<integer -2147483648..2147483647> / *SECRET
Password for the MAREN administrator
PASSWORD = *NONE
No password is specified.
PASSWORD = *SECRET
Requests a blanked-out input field for the password. Entries in this field are not visible on the screen. This operand value can only be specified in unguided dialog. In guided dialog, the field provided for entering passwords is always blanked out.
FREE-POOLS = *UNCHANGED / *PARAMETERS(...)
Determines the free tape pool which is to be generated or deleted.
FREE-POOL =
Specifies which free tape pool is to be edited.
FREE-POOL = *NO
The *NO free tape pool is edited.
FREE-POOL = *GLOBAL
The *GLOBAL free tape pool is edited.
FREE-POOL = *TSOS
The *TSOS free tape pool is edited.
If aliases are specified for the *NO, *GLOBAL or *TSOS values, then these operand values will be expanded to their full length for compatibility reasons (e.g. *GL is expanded to *GLOBAL).
FREE-POOL = <filename 1..54 without-gen-vers>
The free tape pool of a directory is edited. If this directory is located under another user ID, both the user ID and the catalog ID must be entered. The user's own user ID and standard catalog ID can be omitted.
FREE-POOL = <text 2..32 without-sep>
Specifies the name of a free tape pool. The name of the free tape pool must begin with “*” followed by at least one character from A-Z or 0-9. The characters “.”, “-” and “_” are permitted, but not at the end and not next to each other.
The values *STD and *SAME may not be specified.
ACTION =
Specifies if the free tape pool specified is to be created or deleted.
ACTION = *ADD
The free tape pool will be created. Tapes can then be subsequently allocated to the free tape pool.
ACTION = *REMOVE
The free tape pool will be deleted. No more tapes may be allocated to the free tape pool.
SHOW-INFORMATION = *UNCHANGED / *NORMAL / *MAXIMUM
Specifies which format the output of the SHOW-VOLUME-ATTRIBUTES statement is to have when a single archive number is specified. The INFORMATION operand of the SHOW-VOLUME-ATTRIBUTES statement renders this setting ineffective.
SHOW-INFORMATION = *NORMAL
Output will take place in the format with the most important information. Output is not guaranteed and may be changed again in future software versions.
SHOW-INFORMATION = *MAXIMUM
The output contains all information. Output is not guaranteed and may be changed again in future software versions.
HOST =
Defines the system(s) whose parameters are to be modified.
HOST = *OWN
The parameters of the user’s own system are to be modified.
HOST = *ALL
When domains are used, the parameters are modified for all systems in the DA’s own domain; for the ADA, the parameters are changed for all systems.
HOST = <alphanum-name 1..8>
The parameters of the user’s own system are to be modified.
HOST = *ALL-FROM-DOMAIN (...)
The parameters of all systems in a domain are to be modified.
DOMAIN = *STD-DOMAIN / *OWN / <alphanum-name 1..8>
Specifies the domains for whose systems the parameters are modified.
ALL-DOMAIN-ADMIN = *UNCHANGED / *ALLOWED(...) / *NOT-ALLOWED
Defines whether the ADA may work on the systems specified in the HOST operand.
The specifications can also be made for ALL-DOMAIN-ADMIN and DEFAULT-ADMIN-SCOPE if no domains are being used. The setting becomes effective as soon as domains are used.
ALL-DOMAIN-ADMIN = *ALLOWED(...)
The ADA may work on the systems specified in the HOST operand.
DEFAULT-ADMIN-SCOPE = *UNCHANGED / *OWN-DOMAIN / *ALL-DOMAIN
Defines which administration scope is to be set on the specified systems when MARENADM is started. When MARENCP is started for the first time, DEFAULT-ADMIN-SCOPE=*OWN-DOMAIN is set.
DEFAULT-ADMIN-SCOPE = *OWN-DOMAIN
When MARENADM is started on the specified systems, the rights of the DA are set.
DEFAULT-ADMIN-SCOPE = *ALL-DOMAIN
When MARENADM is started on the specified systems, the rights of the ADA are set provided the ADA password was specified beforehand. If the ADA password was not specified beforehand, a warning is issued and MARENADM starts with the rights of the DA.
ALL-DOMAIN-ADMIN = *NOT-ALLOWED(...)
The ADA may not work on the hosts specified in the HOST operand.
DEFAULT-ADMIN-SCOPE = = *OWN-DOMAIN
When MARENADM is started on the specified systems, the rights of the DA are set.
Examples
//modify-maren-parameters loc-entries=*par(loc-name=archiv01)
| |
% | MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED The location archiv01 is added. It is located in the area of the local data center, and its symbolic name is likewise ARCHIV01. |
//modify-maren-parameters
loc-entries=*par(loc-name=da1700,action=*add(symb-name=dva17,type=*remote))
| |
% | MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED The location da1700 with the symbolic name dva17 is added. No immediate access is possible to the tapes stored there, since this location is not in the area of the local data center. |
//modify-maren-parameters loc-entries=*par(loc-name=dva11,action=*rem)
| |
% |
The location dva11 is deleted. |
//modify-maren-parameters maren-def=*par(def-free-date=200)
| |
% | MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED The default reservation period for reserving a tape has been changed to 200 days. |
//modify-maren-parameters archives-work-time=*par(open-time=7:30,cl-time=20)
| |
% | MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED The opening time for the central archive is 7:30 to 20:00 hours. Within this time period, tapes can be exported or requested. |
//modify-maren-parameters export-receipt=*printer(dev-name=rsostat1)
| |
% | MARM170 STATEMENT '//MODIFY-MAREN-PARAMETERS' PROCESSED Export receipts for tapes are to be printed on the RSO printer with the name rsostat1. |