Privilege ADA, DA, administrator without domains
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 the corresponding operands 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.
DAs can only execute the statement in their own domain. The DOMAIN operand is thus meaningless for them.
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.
USER-IDENTIFICATION =
This operand selects the user ID to which the tapes are assigned (archive entry field USER-ID).
USER-IDENTIFICATION = *ALL
The user IDs are not evaluated during selection.
USER-IDENTIFICATION = <name 1..8>
Only those archive numbers which are assigned to the specified user ID are selected.
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 field is not set to CLOSED for one of the tapes in the tape set, the statement is aborted.
TYPE-OF-VOLUMES = *OBSOLETE
If tape sequence numbers occur more than once for a tape set, all 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.
DOMAIN =
Selects the domain in which the attributes for the tapes of a tape set are modified.
DOMAIN = *ANY
The attributes for the tapes of a tape set are modified in all domains.
DOMAIN = *OWN
The attributes for the tapes of a tape set in the user’s own domain are modified. The user’s own domain is the domain of the system on which the ADA is currently working.
DOMAIN = *STD-DOMAIN
The attributes for the tapes of a tape set in the standard domain are modified.
DOMAIN = <alphanum-name 1..8>
The attributes for the tapes of a tape set in the specified domain are modified.
PROTECTION = *UNCHANGED / *PARAMETERS(...)
Tape protection attributes.
PASSWORD = *UNCHANGED / *NONE / <c-string 1..4> / <x-string 1..8> / <integer-2147483648..2147483647> / *SECRET
Password protecting against unauthorized access to the tape. The password C'$$$$' is not permitted. The password is changed using this operand.
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.
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. 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.
AUDIT = *UNCHANGED / *YES / *NO
Specifies whether MAREN is to monitor and if necessary refuse access to this tape.The AUDIT flag is evaluated only if the system-specific MAREN parameter AUDIT is set to OPTIONAL.
AUDIT = *YES
Access to this tape is to be monitored.
AUDIT = *NO
No monitoring is to take place.
INITIALIZATION = *UNCHANGED / *YES / *NO / *ERASE
Specifies whether the tape is to be reinitialized and if required also erased once it reaches the tapes expiration date.
LOCATION = *UNCHANGED / *PARAMETERS(...)
Location characteristics.
HOME-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies the location where the tape is normally to be stored.
FREE-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies location where the tape is to be relocated when it is transferred to the pool of free tapes after the reservation period has expired.
TEMPORARY-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies the tape’s current location.
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.
ADMINISTRATOR-FIELD = *UNCHANGED / *NONE / <c-string 1..8 with-low>
Comment text. Any internal information can be contained here. It cannot be read or changed by the MAREN user.
ADMINISTR-FIELD-2 = *UNCHANGED / *NONE / <c-string 1..16 with-low>
Comment text. Any internal information can be contained here. It cannot be read or changed by the MAREN user.
EXPORT-ADDRESS = *UNCHANGED / *NONE / <c-string 1..50>
Mailing address. Specifies the destination to which the tape is to be sent if mailed. If the tape is to be picked up personally, any text to this effect can be specified, e.g. “Mailbox G7”.
EXPORT-DATE = *UNCHANGED / *NONE / <date>
Export date in the format yyyy-mm-dd.
Notes
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.
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.
Examples
//modify-tape-set-attributes f-name=file.x,remark='release progx v1.0a'
The string specified for the REMARK operand is to be entered in the remark field for all tapes written to when the file FILE.X was last created. The remark is intended to describe the tape contents.
//modify-tape-set-attributes f-name=file.x,version=-1,type-of-vol=*obsolete,free-date=0
The second last time the specified file was created (VERSION=-1), the system crashed during tape output while writing to, say, the fifth tape. While the third tape was being written to, the user program set a restart point at which output can be resumed once the system has been restarted (using the RESTART-PROGRAM command).
The third tape from the aborted job is used again, while the remaining tapes, which have higher volume sequences (VOLUME-SEQUENCE), are automatically reassigned by the automatic free tape allocation facility. The tapes with volume sequences 4 and 5 which originated from the aborted job cannot be used. It should therefore be released (operand FREE-DATE=0).