Domain: | STORAGE-MANAGEMENT |
Privileges: | all except OPERATING, HARDWARE-MAINTENANCE and SECURITY-ADMINISTRATION |
This command allows an entry to be added to the MAREN TFT for a tape file. The USAGE operand defines the effect of the MAREN TFT entry:
*SELECT
A specific file version is to be processed for the specified tape file. By default, at volume substitution MAREN selects the latest file version entered under the user ID of the caller in the MAREN catalog.*SCRATCH
For the specified tape file, the location and free pool must be specified from which scratch tapes are requested if an archive number is not specified when the file is created. In addition, scratch tapes can be assigned to a volume group.
If there is already an entry for the specified file name in the MAREN TFT, this entry is deleted and a new one created.
Format
ADD-MAREN-FILE-ENTRY Alias: ADMFE | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
Operands
FILE-NAME = <filename 1..54>
This operand specifies the file name for which an entry is to be added to the MAREN task file table.
FILE-NAME = *ALL-SCRATCH-FILES
The entry in MAREN-TFT applies for all scratch tapes requested in the future. This operand value may only be specified in conjunction with USAGE=*SCRATCH(...).
USAGE =
Specifies the effect of the MAREN TFT entry.
USAGE = *SELECT(...)
A specific file version of the specified file is to be used.
VERSION =
This operand can be used to select a specific version (or status) of the specified file.
VERSION = *LATEST
Selects the latest version of the file (i.e. the last one created).
VERSION = <integer -9999..0>
Specifying 0 here is equivalent to specifying LATEST; the entry -1 specifies the previous file status, etc.
USER-IDENTIFICATION =
This operand selects the user ID to which the tapes are assigned (catalog entry field USER-ID).
USER-IDENTIFICATION = *OWN
Only those archive numbers are selected which are assigned to your own user ID, i.e. the user ID of the current task.
USER-IDENTIFICATION = *ANY
Selection is not based on user IDs. For foreign user IDs only shareable archive numbers (USER-ACCESS=*ALL-USERS or *FOREIGN-READ-ONLY) are selected.
USER-IDENTIFICATION = <name 1..8>
Only archive numbers of the specified user ID are selected. In the case of a foreign user ID, only shareable archive numbers (USER-ACCESS=*ALL-USERS or *FOREIGN-READ-ONLY) are selected.
USAGE = *SCRATCH(...)
Specifies which location and which volume group is to be used for free tape assignment if an archive number (scratch tape) is not specified when the file is created.
When locations are used, the specified location must have been configured appropriately in the reservation file. Otherwise it is ignored.
LOCATION =
Specifies the location to be used for the assignment of a scratch tape.
LOCATION = *STD
The location is not specified. MAREN's current defaults apply.
LOCATION = <alphanum-name 1..8>
If the file is created without specifying an archive number, MAREN selects a free archive number from this location.
FREE-POOL =
Specifies the free tape pool.
FREE-POOL = *STD
No free tape pool was specified.
FREE-POOL = *NO
A free tape is to be picked from the *NO free tape pool.
FREE-POOL = *GLOBAL
A free tape is to be picked from the *GLOBAL free tape pool.
FREE-POOL = *TSOS
A free tape is to be picked from the *TSOS free tape pool.
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 = <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.
VOLUME-GROUP = *NONE / <text 1..32 without-sep>
Specifies the volume group. When *NONE is specified, the tape is not assigned to a volume group.
Notes
Notes on USAGE=*SCRATCH(...)
The request for a location can still be rejected by a MAREN exit or by MARENLM. In this case, processing is aborted regardless of the location.
The definition of a location does not apply to other tasks or subtasks. If the file is opened in a subtask and a free tape is requested, the location defined for the file is not used.
The definition of a location can also be used for other system components as well as for file processing (e.g. for FDDRL).
Note on VOLUME-GROUP
Related tapes can be combined to form a volume group. The volume group is a tapespecific attribute. i.e. all files which are located on a tape belong to the same volume group.
Command return codes
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | The command was executed without errors | |
| 1 | MARM189 | Syntax error in the command | |
| 1 | 32 | MARM184 | Error (&00) when executing macro (&01) |
| 2 | 64 | MARC201 | Error when completing the file name |