The examples below show reservation files using MARENLM masks. They can naturally also be edited with EDT.
Example 1: Defining a location for a specific user
When issuing a scratch request, USER1 may only access tapes in the location ROBOT001, and USER2 can only access tapes in the location ROBOT002. All other users access the default location.
In this case, the parameters have the following values:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.1
List of location specification More :
From 1 to 3 of 3
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
ROBOT001 USER1
ROBOT002 USER2
*ANY
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL Example 2: Reserving tapes in a specific location for a specific user
It is also possible to make very specific allocations. For instance, it is possible to reserve a specific device type from the location allotted to an archive system for a specific user who wishes to use the tape with HSMS/ARCHIVE, i.e. with a specific directory.
To achieve this, the parameters have to have the following values:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.2
List of location specification More :
From 1 to 3 of 3
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
ROBOT MT0001 MT0099 TAPE-C4 ADMIN BACKUP
A :CAT:$ADMIN.ARCHIVE.DIR
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL The user ID ADMIN using the BACKUP job and the directory ARCHIVE.DIR, can use the tapes MT0001 through MT0099 at the location ROBOT.
In case of a HSMS request, BACKUP corresponds to the request name.
Example 3: Defining a location for a specific device type
If a scratch request is issued for device type TAPE-C4, the location ROBOT001 is to be accessed. All other tape requests access the default location.
In this case, the parameters have the following values:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.3
List of location specification More :
From 1 to 3 of 3
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
ROBOT001 TAPE-C4
*ANY
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL If a user issues a scratch request for the file called “TEST”, the reservation has to be made with the location ROBOT002.
In this case, the parameters would have the following values:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.3
List of location specification More :
From 1 to 3 of 3
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
ROBOT002 TAPE-C4
F TEST
IF TEST/F & T-C4
ROBOT001 TAPE-C4
IF T-C4
*ANY
OTHER
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL Note the order of the entries in this example: if entries 2 and 3 were to be switched around, the entry for ROBOT002 would not be read by MARENLM because the default location would be found first and the reservation made.
The field contains user information or a comment.
Example 4: Defining a number range for a user ID
A range of tapes is to be defined for USER1 in the default location. In this case, the parameters have the following values:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.4
List of location specification More :
From 1 to 3 of 3
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
*ANY MT0001 MT0099 USER1
*ANY
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL Example 5: Using the reject field
All scratch requests for device type TAPE-C4 are to be rejected.
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.5
List of location specification More :
From 1 to 2 of 2
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
*ANY TAPE-C4 R
*ANY
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL Example 6: Combinations
As shown in the following example, the various application options offered by MARENLM can be combined:
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.6
List of location specification More : + -
From 1 to 3 of 13
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
ROBOT002 MT0001 MT0005 TAPE-C4 USER1 TEST ---> 1)
F FILE1
ROBOT TAPE-C4 USER1 R ---> 2)
*ANY USER2 ---> 3)
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.6
List of location specification More : + -
From 4 to 6 of 13
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
*ANY TAPE-U4 ---> 4)
ROBOT002 MT0006 MT0010 TAPE-U5 USER3 ---> 5)
A ARCHIVE1
ROBOT003 MT2541 MT2542 TAPE-U4 TEST2 ---> 6)
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL
| 1st entry: | The user USER1 with the job name TEST may use the TAPE-C4 tapes from the number range MB0001 through MB0005 for the file FILE1 at location ROBOT002. |
| 2nd entry: | Any other requests for TAPE-C4 tapes by the user USER1 are rejected. |
| 3rd entry: | All requests from the user USER2 are satisfied from the location the user has specified with ADD-MAREN-FILE-ENTRY LOCATION= ... or in ARCHIVE/HSMS, or from the DEFAULT-HOME-LOCATION. |
| 4th entry: | All requests for TAPE-U4 tapes are satisfied from the location the user has specified with ADD-MAREN-FILE-ENTRY LOCATION= ... or in ARCHIVE/HSMS, or from the DEFAULT-HOME-LOCATION. |
| 5th entry: | Requests for TAPE-U5 tapes for the directory ARCHIVE1 by the user USER3 are satisfied from the location ROBOT002 and the number range MB0006-MB0010. |
| 6th entry: | This entry is meaningless as requests for TAPE-U4 were already dealt with in the 4th entry. |
Example 7: Allocating the free tape pool *TSOS
It may be necessary to modify the free tape pool to restore the old behavior, since the owner of the directory determines the presetting of the free pool if MAREN is used in combination with HSMS/ARCHIVE as of V6.0.
All directories of the SYSHSMS user ID will receive free tapes out of the free tape pool FREE-POOL=*TSOS (see line 1 in the list of the following screen). All directories of the TSOS user ID will be allocated to the free tape pool FREE-POOL=*TSOS by MAREN as default if this pool exists.
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.7
List of location specification More :
From 1 to 2 of 2
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
*ANY
A $SYSHSMS.
*TSOS
*ANY
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL All HSMS/ARCHIVE jobs shall receive their free tapes out of the free tape pool FREE-POOL=*TSOS.
File
------------------------------------------------------------------------------
The Maren Location Manager
------------------------------------------------------------------------------
File : maren.lmf.7
List of location specification More :
From 1 to 2 of 2
S Location Start-VSN Last-VSN Vol.Type Userid Jobname Rej.
A/F ARCHIVE-Directory / Filename
FREE-POOL-Name Info
-----------------------------------------------------------------------------
*ANY
A
*TSOS
*ANY
********************************End of data*******************************
------------------------------------------------------------------------------
CMD==>
F1=HELP F3=EXIT F4=INSERT F5=ERASE F7=FOR. F8=BACK. F9=MOD F12=CANCEL