A tape set consists of all the tapes which belong to a tape file, or more precisely, all those catalog entries which have the same FILE-NAME and FIRST-VOL values.
The default value *UNCHANGED in a given operand signifies that the previous setting is still applicable. The value *NONE signifies that the specified catalog entry fields can be deleted in the catalog entry.
Format
MODIFY-TAPE-SET-ATTRIBUTES Alias: MDTSA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SELECT = *BY-ATTRIBUTES(...)
Tape set to be selected for modification.
FILE-NAME = <filename 1..41 without-cat-user>
File name for which a tape set is to be selected.
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 is equivalent to *LATEST, specifying -1 indicates the penultimate file status, etc.
VERSION = *ALL
Selects all the tapes which exist for the specified file name.
VERSION = *NOT-CREATED
Selects only those volumes which have been reserved with the specified file name but which have not been used (catalog entry fields CREATION-DATE and CREATION-TIME have not been set). The TYPE-OF-VOLUMES setting is of no consequence in this case and is therefore not interpreted.
TYPE-OF-VOLUMES =
This operand selects the volume sequences (catalog entry field VOLUME-SEQUENCE) within a tape set. These numbers are usually unique. Some numbers may be duplicated following a restart.
If VERSION=*NOT-CREATED is specified, the TYPE-OF-VOLUMES operand is ignored.
TYPE-OF-VOLUMES = *VALID(...)
If a volume sequence occurs more than once in a tape set, the one created most recently is selected.
CLOSE-CHECK =
This operand allows you to select whether the catalog entry fields CLOSE-INDICATOR should be evaluated.
CLOSE-CHECK = *NO
The CLOSE-INDICATOR catalog entry field is not evaluated.
CLOSE-CHECK = *YES
If the CLOSE-INDICATOR catalog entry field is not set to CLOSED for one of the tapes in the tape set, the statement is aborted.
TYPE-OF-VOLUMES = *OBSOLETE
If a volume sequence occurs more than once in a tape set, all VSNs are selected except the one most recently created.
TYPE-OF-VOLUMES = *ANY
The volume sequences for a tape set are not checked to establish whether they occur more than once.
PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET
Password. The previously valid password must be entered here if the tape is protected by a password.
PROTECTION = *UNCHANGED / *PARAMETERS(...)
Tape protection attributes.
NEW-PASSWORD = *UNCHANGED / *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483648..2147483647> / *SECRET
Password protecting tapes against unauthorized access. The password C'$$$$' is not permitted. The password is changed using this operand.
NEW-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.
USER-ACCESS =*UNCHANGED / *OWNER-ONLY / *FOREIGN-READ-ONLY / *ALL-USERS
Specifies whether foreign user IDs may access the tape.
USER-ACCESS = *OWNER-ONLY
Access to the tape is possible only under the specified user ID.
USER-ACCESS = *FOREIGN-READ-ONLY
Only read access to the tape is possible under a foreign user ID.
USER-ACCESS = *ALL-USERS
Unrestricted access to the tape is possible under a foreign user ID.
FREE-DATE = *UNCHANGED / <date> / <integer 0..32767 days >
Expiration date of the tape. Up to this date, the tape remains reserved for the given user ID.
FREE-DATE = <date>
Date in the format yyyy-mm-dd. Dates earlier than the current date are rejected.
FREE-DATE = <integer 0..32767 days >
Time specification in days (reservation period). MAREN adds this number to the current date to generate the expiration date.
EXPIRATION-DATE = *UNCHANGED / *NONE / <date> / <integer 0..32767 days >
File expiration date.
EXPIRATION-DATE = <date>
Date in the format yyyy-mm-dd. Dates earlier than the current date are rejected.
EXPIRATION-DATE = <integer 0..32767 days >
Time specification in days. MAREN adds this number to the current date to generate the expiration date.
INITIALIZATION = *UNCHANGED / *YES / *ERASE
Specifies whether the tape is to be reinitialized and if required also erased once it reaches its expiration date.
INITIALIZATION = *YES
The tape is to be initialized after being released. However, if data is written to this volume before it is released, the value for INITIALIZATION will revert to NO provided the tape was created without protection criteria.
INITIALIZATION = *ERASE
The tape is to be initialized after being released. The tape contents should also be erased in the process.
HOME-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies the location where the tape is normally to be stored.
REMARK = *UNCHANGED / *NONE / <c-string 1..24>
Comment text. This catalog entry field is output in response to the MAREN statement SHOW-VOLUME-ATTRIBUTES.
REMARK-2 = *UNCHANGED / *NONE / <c-string 1..10>
Comment text. This catalog entry field is output in response to the MAREN statement SHOW-VOLUME-ATTRIBUTES.
REMARK-3 = *UNCHANGED / *NONE / <c-string 1..12>
Comment text. This catalog entry field is output in response to the MAREN statement SHOW-VOLUME-ATTRIBUTES.
USER-FIELD = *UNCHANGED / *NONE / <c-string 1..54>
Comment text. This catalog entry field may contain any user-specific data, e.g. name, department.
Notes
- If errors occur when determining the MAREN tape set, e.g. because only the tapes with the volume sequences 1 and 3 have been entered in the MAREN catalog for a given file version but not VSN 2, the catalog entries are not modified.
- It is not possible to change the storage location for tapes of a tape set assigned to a location with the operating mode ROBAR-2.
- Which catalog entry fields play a role when determining a file version and consequently a tape set is described in the “MAREN System Administrator Guide” [1].
- When modifying tape attributes, the FSEQ-1 entry is also modified if entries with FSEQ > 1 are also part of the tape set. The following operands are affected:
- INITIALIZATION
- EXPIRATION-DATE
This may modify FREE-DATE in the FSEQ-1 entry. The initialization flag would also be set when EXPIRATION-DATE is reduced. - FREE-DATE
This is reduced only if the EXPIRATION-DATE operand of all catalog entries for this tape is less than or equal to the new FREE-DATE.
- If the HOME-LOC, FREE-LOC, TEMP-LOC, EXPORT-ADDRESS, or EXPORT-DATE operands are modified in an entry with FSEQ > 1, MAREN outputs warning
MARM020. - If the FSEQ-1 entry cannot be read or modified, e.g. because the entry is still being processed, MAREN outputs warning
MARM021.
Example
//modify-tape-set-attributes select=*by-attr(file-name=tape.file,version=*all,type-of-volumes=*valid),protection=*par(user-access=*foreign-read)
|
Read access from foreign user IDs is to be permitted for all tapes under the user's own ID to which the tape file TAPE.FILE has been written. All versions and thereby all tape sets of this file in the MAREN catalog are selected (VERSION=*ALL). If there are individual versions of this file with tapes to which data has been written but which were replaced by other tapes in a subsequent restart, these tapes are not modified (TYPE-OF-VOLUMES=*VALID).