Privilege ADA, DA, administrator without domains
The default value *UNCHANGED in a given operand signifies that the previous setting is 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 and NEW-DOMAIN operands are thus meaningless for them.
Format
MODIFY-VOLUME-ATTRIBUTES Alias: MD / MDVA | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
VOLUME =
Archive numbers of tapes whose catalog entries are to be modified.
VOLUME = <vsn>(...)
Archive number.
FILE-SEQUENCE = 1 / <integer 1..9999>
File sequence number whose catalog entry is to be modified.
FILE-NAME = *UNCHANGED / *NONE / <filename 1..41 without-cat-user>
Name of the file with the specified file sequence number located on the tape. If an directory name is entered in the catalog entry, NEW-DIR-NAME=*NONE or NEW-FREE-POOL=*NO must be specified before a file name can be entered.
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.
VOLUME-SEQUENCE = *UNCHANGED / <integer 1..255>
File section number within a multivolume file (MV set).
FIRST-VOLUME = *UNCHANGED / *NONE / <vsn>
First archive number of a multivolume file (file set ID).
ACCESS-COUNT = *UNCHANGED / <integer 0..99999999>
Number of (read and write) accesses to the tape.
RESERVATION-COUNT = *UNCHANGED / <integer 0..9999>
Specifies how often this tape has been reserved up to now.
RESERVATION-DATE = *UNCHANGED / *NONE / <date>
Specifies the last time this tape was reserved.
DEVICE-NAME = *UNCHANGED / *NONE / <alphanum-name 2..4>
Name (mnemonic) of the device on which the tape was last processed.
OPEN-MODE = *UNCHANGED / *NONE / *INPUT / *OUTPUT / *EXTEND / *INOUT / *OUTIN / *SINOUT / *REVERSE
Open mode of the last access to the tape.
CLOSE-INDICATOR = *UNCHANGED / *NONE / *OPEN / *CLOSE
Indicates the status of a tape output file.
CLOSE-INDICATOR = *OPEN
Indicates that the output file was opened but has not yet been closed.
CLOSE-INDICATOR = *CLOSE
Indicates that the output file has been properly closed.
LAST-CLOSE-DATE = *UNCHANGED / *NONE / <date>
Date in the format yyyy-mm-dd. Specifying the last day on which a file on this tape was closed.
LAST-CLOSE-TIME = *UNCHANGED / *NONE / <time>
Time in the format hh[:mm[:ss]], where initial zeros need not be entered for hh, mm and ss. Specifies the time of day a file on this tape was last closed.
CREATION-CATALOG-ID = *UNCHANGED / *NONE / <cat-id>
Catalog ID of the pubset on which the tape was last written to. If a directory name is entered in the catalog entry, NEW-DIRECTORY-NAME=*NONE or NEW-FREE-POOL=*NO must be specified before a value for CREATION-CATALOG-ID can be entered.
CREATION-USER-ID = *UNCHANGED / *NONE / <name 1..8>
User ID under which the tape was last written to. If a directory name is entered in the catalog entry, NEW-DIR-NAME=*NONE or NEW-FREE-POOL=*NO must be specified before a value for CREATION-USER-ID can be entered.
CRE-JOB-OR-REQ-NAME = *UNCHANGED / *NONE / <name 1..8>
Name of the last job which wrote to this tape.
CREATION-DATE = *UNCHANGED / *NONE / <date>
Date in the format yyyy-mm-dd. Specifies the day on which the tape was last written to.
CREATION-TIME = *UNCHANGED / *NONE / <time>
Time in the format hh[:mm[:ss]], where initial zeros need not be entered for hh, mm and ss. Specifies the time of day at which the tape was last written to.
LAST-WRITE-BLK-CNT = *UNCHANGED / <integer_0..2147483647> / <text 10..10 without-sep>
Number of blocks occupying this tape at FSEQ = 0001. At FSEQ = 0001, the counter contains all blocks up to the end of this file.
SAVE-FILE-ID = *UNCHANGED / *NONE / <composed-name 15..15> (...)
SAVE-FILE-ID of a save file from HSMS/ARCHIVE.
SAVE-FILE-ID = <composed-name 15..15> (...)
The SAVE-FILE-ID has the following format: S.yymmdd.hhmmss.
SUB-SAVE-NUMBER = <integer 0..15>
SUB-SAVE-NUMBER of the backup tape (or backup subtask) of the SAVE-FILE-ID named above. If the administrator assigned a SAVE-FILE-ID, a SUB-SAVE-NUMBER must also be specified.
SUB-SEQUENCE-NUMBER = <integer 1..255>
SUB-SEQUENCE-NUMBER for the SUB-SAVE-NUMBER and SAVE-FILE-ID specified above. If the administrator assigned a SAVE-FILE-ID, then a SUB-SEQUENCE-NUMBER must also be specified.
LAST-ACCESS-STATUS = *UNCHANGED / *PARAMETERS(...)
Parameters during the last access.
LAST-ACCESS-USER-ID = *UNCHANGED / *NONE / <name 1..8>
User ID during the last access.
LAST-ACCESS-ACCOUNT = *UNCHANGED / *NONE / <alphanum-name 1..8>
Account number during the last access.
LAST-ACCESS-JOB-NAME = *UNCHANGED / *NONE / <name 1..8>
Job name during the last access.
LAST-ACCESS-TSN = *UNCHANGED / *NONE
Task sequence number during the last access.
LAST-ACCESS-TSN = *NONE
Four blanks are entered. This enables the internal MAREN tape lock to be lifted.
LAST-ACCESS-SNO = *UNCHANGED / *NONE / <integer 1..255>
Session number during the last access.
LAST-ACCESS-DATE = *UNCHANGED / *NONE / <date>
Date of the last access in the format yyyy-mm-dd.
LAST-ACCESS-TIME = *UNCHANGED / *NONE / <time>
Time of the last access in the format hh[:mm[:ss]], where initial zeros need not be entered for hh, mm and ss.
LAST-ACCESS-HOSTNAME = *UNCHANGED / *NONE /
<alphanum-name 1..8>
System name during the last access.
VOLUME = *INTERVAL(...)
All tapes whose archive number lies within the range specified below are processed.
FROM = *FIRST
All tapes are processed, starting with the lowest available archive number.
FROM = <vsn>
Archive number. All tapes whose archive number is greater than or equal to the specified archive number are processed.
TO = *LAST
All tapes are processed up to the highest existing archive number.
TO = <vsn>
Archive number. All tapes whose archive number is less than or equal to the specified archive number are processed.
FROM-FSEQ = 1 / <integer 1..9999>
File sequence number of the FROM operand. Specifies the precise file sequence number at which processing is to begin. This operand is relevant only if the statement is issued via the MAREN program interface.
VOLUME = *ALL
All tapes are processed.
VOLUME = *BY-INPUT-FILE(...)
Selects the catalog entries to be modified by means of an input file.
FILE-NAME = <filename 1..54>
Name of a SAM file which contains full catalog entries in MAREN format. Files created with editors can also be assigned.
From all the catalog entries in the input file, only the archive numbers (VOLUME) and file sequence numbers (FILE-SEQUENCE) contained in it are evaluated. The catalog entry for the specified tape is read from the MAREN catalog, and the catalog entry fields specified there in the statement are updated.
If there is no catalog entry in the MAREN for a tape contained in the input file, this fact is logged, task switch 31 is set, and processing continues with the next archive entry from the input file.
If a file is assigned which contains no complete catalog entries and which was created using an editor, the records it contains must have the following format:
Byte | Contents |
1-4 | Record length field |
5-10 | VSN, if necessary padded with trailing blanks, e.g. 'TAPE1 |
11-14 | File sequence number, e.g. '0001' |
15-510 | Not set or any text |
Further selection criteria (SELECT operand) are taken into account in accordance with the catalog entry. If, for example, SELECT=*FREE was specified and the tape is flagged in the MAREN catalog as reserved but as free in the input file, the MAREN catalog is not changed.
Only the catalog entries in the MAREN catalog are updated. The input file remains unchanged.
SELECT =
Specifies which catalog entries are to be selected.
SELECT = *ALL(...)
All catalog entries identified by the VOLUME operand are processed.
DOMAIN =
Selects the domain.
DOMAIN = *ANY
The tapes from all domains are processed.
DOMAIN = *OWN
The tapes from the user’s own domain are processed. The user’s own domain is the domain of the system on which the ADA is currently working.
DOMAIN = *STD-DOMAIN
The tapes from the standard domain are processed.
DOMAIN = <alphanum-name 1..8>
The tapes from the specified domain are processed.
NEW-DOMAIN =
Assigns the domain.
NEW-DOMAIN = *SAME
The domain assignment remains unchanged.
NEW-DOMAIN = *OWN
The tapes are assigned to the user’s own domain. The user’s own domain is the domain of the system on which the ADA is currently working.
NEW-DOMAIN = *STD-DOMAIN
The tapes are assigned to the standard domain.
NEW-DOMAIN = <alphanum-name 1..8>
The tapes are assigned to the specified domain.
SELECT = *RESERVED(...)
Only the catalog entries of reserved local and foreign tapes are processed.
USER-IDENTIFICATION = *ALL / <name 1..8>
User ID. All catalog entries assigned to the specified user ID are processed.
DOMAIN = *ANY / *OWN / *STD-DOMAIN / <alphanum-name 1..8>
Reserved tapes from a selected domain are processed.
DIRECTORY-NAME =
The reserved tapes assigned to the specified directory are selected. If this directory is located under a remote 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.
DIRECTORY-NAME = *ALL
No selection is made from the directory.
DIRECTORY-NAME = <filename 1..54 without-gen-vers> (...)
Only tapes which are allocated to the pool of the specified directory are selected. The selection may already have been restricted using the VOLUME operand.
SAVE-FILE-ID =
The tapes to be processed are selected using the save file of the directory named above.
SAVE-FILE-ID = *ALL
All tapes from this directory are to be processed.
SAVE-FILE-ID = *LATEST
All tapes listed in the last, i.e. most recent save file are selected.
SAVE-FILE-ID = <integer -32767..0>
All tapes listed in the nth save file are selected (the older the save file, the larger the number n). 0 equals *LATEST. Example: if -5 is specified, the tapes are selected from the last save file but five.
SAVE-FILE-ID = <composed-name 15..15>
All tapes in the save file with the specified SAVE-FILE-ID are selected. The SAVE-FILE-ID has the following format: S.yymmdd.hhmmss.
VOLUME-GROUP = *ANY / *NONE / <text 1..32 without-sep>
Specifies the volume group to which a tape must belong for it to be processed. When *ANY is specified, the volume group is irrelevant; when *NONE is specified, the tape may not belong to a volume group. “*” can be entered as the last character. In this case all volume groups which begin with the specified string are selected.
NEW-USER-ID = *SAME / <name 1..8>
User ID. This ID will be entered for all selected catalog entries.
NEW-USER-ID = *SAME
The user ID remains unchanged.
NEW-DOMAIN = *SAME / *OWN / *STD-DOMAIN / <alphanum-name 1..8>
Domain assignment. The tapes are reassigned to the specified domain.
NEW-DIRECTORY-NAME = *SAME / *NONE / <filename 1..54 without-gen-vers>
The new directory name for reserved tapes is specified here. If this directory is located under a remote 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. If the catalog entry fields FILE-NAME, CREATION-CATALOG-ID, or CREATION-USER-ID are set in the archive entry, these must be deleted with *NONE.
NEW-DIRECTORY-NAME = *SAME
The allocation to a directory is not modified.
NEW-DIRECTORY-NAME = *NONE
Any directory name present is deleted.
NEW-FREE-POOL =
Modifies the allocation to particular free tape pool.
NEW-FREE-POOL = *SAME
The allocation to a free tape pool remains unchanged.
NEW-FREE-POOL = *NO
The tapes are assigned to the *NO free tape pool.
NEW-FREE-POOL = *GLOBAL
The tapes are assigned to the free tape pool for general HSMS/ARCHIVE applications under any user ID.
NEW-FREE-POOL = *TSOS
The tapes are assigned to the free tape pool for HSMS/ARCHIVE applications under the user ID TSOS.
NEW-FREE-POOL = <filename 1..54 without-gen-vers>
The tapes are assigned to the free tape pool for ARCHIVE applications using the specified directory. If this directory is located under a remote 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. The directory name specified here must match that entered under DIRECTORY-NAME or NEW-DIRECTORY-NAME, or DIRECTORY-NAME must not be entered. Prior to modification, the contents of the catalog entry fields FILE-NAME, CREATION-CATALOG-ID and CREATION-USER-ID must be deleted with NONE.
NEW-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. If the relevant free tape pool does not yet exist, it will be created.
The value *STD may not be specified.
NEW-VOLUME-GROUP = *SAME / *NONE / <text 1..32 without-sep>
Defines the new volume group to which a selected tape is assigned. When *SAME is specified, the volume group remains unchanged; when *NONE is specified, the affiliation to a volume group is deleted.
SELECT = *FREE(...)
Only the catalog entries from free tapes are processed.
FREE-POOL =
Selects the catalog entries of free tapes to be modified on the basis of the free tape pool.
FREE-POOL = *NO
Only tapes assigned to the *NO free tape pool are selected.
FREE-POOL = *GLOBAL
Only free tapes assigned to the free tape pool for general HSMS/ARCHIVE applications under any user ID are selected.
FREE-POOL = *TSOS
Only free tapes assigned to the free tape pool for HSMS/ARCHIVE applications under the user ID TSOS are selected.
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>
Only free tapes assigned to the free tape pool of the specified directory are selected. If this directory is located under a remote 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.
DEVICE-TYPE =
Device type.
DEVICE-TYPE = *STD
Only tapes of the default device type (DEFAULT-DEVICE-TYPE) specified in the control program's start procedure are selected.
DEVICE-TYPE = *ANY
All tapes are selected.
DEVICE-TYPE = <structured-name 1..8>
Device type. For a list of possible entries (depending on the BS2000 version), see manual “System Installation” [6].
DOMAIN =
Selects the domain.
DOMAIN = *ANY
The free tapes from all domains are processed.
DOMAIN = *OWN
The tapes of the user’s own domain are processed. The user’s own domain is the domain of the system on which the ADA is currently working.
DOMAIN = *STD-DOMAIN
The tapes of the standard domain are processed.
DOMAIN = <alphanum-name 1..8>
The tapes of the specified domain are processed.
NEW-FREE-POOL =
Modifies the allocation of free tapes to particular free tape pool.
NEW-FREE-POOL = *SAME
The allocation to a free tape pool remains unchanged.
NEW-FREE-POOL = *NO
The tapes are assigned to the *NO free tape pool.
NEW-FREE-POOL = *GLOBAL
The tapes are assigned to the free tape pool for general HSMS/ARCHIVE applications under any user ID.
NEW-FREE-POOL = *TSOS
The tapes are assigned to the free tape pool for HSMS/ARCHIVE applications under the user ID TSOS.
NEW-FREE-POOL = <filename 1..54 without-gen-vers>
The tapes are assigned to the free tape pool for HSMS/ARCHIVE applications using the specified directory. If this directory is located under a remote 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.
NEW-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. If the relevant free tape pool does not yet exist, it will be created.
NEW-DOMAIN =
Assigns the domain.
NEW-DOMAIN = *SAME
The domain assignment remains unchanged.
NEW-DOMAIN = *OWN
The tapes are assigned to the user’s own domain. The user’s own domain is the domain of the system on which the ADA is currently working.
NEW-DOMAIN = *STD-DOMAIN
The tapes are assigned to the standard domain.
NEW-DOMAIN = <alphanum-name 1..8>
The tapes are assigned to the specified domain.
ACCOUNT = *UNCHANGED / *NONE / <alphanum-name 1..8>
Account number of the user ID entered in the catalog entry.
PROTECTION = *UNCHANGED/ *PARAMETERS(...)
Tape protection attributes.
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.
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 =
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 specified 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 =
Expiration date for all files on the tape.
EXPIRATION-DATE = *UNCHANGED
The expiration date is not updated.
EXPIRATION-DATE = *NONE
The expiration date is deleted for all selected files.
EXPIRATION-DATE = <date with-compl>
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. However, 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 its 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 been reached.
TEMPORARY-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies the tape’s current location.
The locations of the logical tapes (operating mode ROBAR-2 for ETERNUS CS) can be modified. In this case HOME-LOCATION, FREE-LOCATION and TEMPORARY-LOCATION must be identical.
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. This field may contain any information. This catalog entry field cannot be read or changed by the user.
ADMINISTR-FIELD-2 = *UNCHANGED / *NONE / <c-string 1..16 with-low>
Comment text. This field may contain any information. 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.
OVERFLOW-CONTROL =
Type of screen overflow control in interactive mode.
OVERFLOW-CONTROL = *BY-PROGRAM
Control by the program: after eighteen catalog entries have been processed, a message is displayed inquiring whether the current operation is to be continued or aborted.
OVERFLOW-CONTROL = *BY-SYSTEM
Control by BS2000. Screen overflow control is based entirely on the system parameter TCHOFLO or the value set in the MODIFY-TERMINAL-OPTIONS command.
REGISTRATION-DATE = *UNCHANGED / *NONE / <date with-compl>
Date, in the format yyyy-mm-dd, on which the tape was entered in the MAREN catalog.
Notes
In the MAREN catalog entry, the three catalog entry fields FILE-NAME, CREATION-CATALOG-ID and CREATION-USER-ID occupy the same area in which the name of a directory can also be stored. Consequently, when entering a directory name (NEW-DIRECTORY-NAME or NEW-FREE-POOL=<filename>), these three catalog entry fields must be empty or explicitly deleted. This is achieved by setting them to *NONE. Conversely, any existing directory name must likewise be deleted (NEW-DIRECTORY-NAME=*NONE) if, for example, a file name is to be added to the MAREN catalog entry by means of FILE-NAME=<filename>.
A volume expiration date which precedes the expiration date of the first tape of an MF/MV set must not be set for the subsequent tapes in the set. The expiration date for the first tape (VOLUME-SEQUENCE = 1) must be reset if all the tapes in an MF/MV set are to be released.
The operands DIRECTORY-NAME and NEW-DIRECTORY-NAME can only be used in connection with reserved tapes. The FREE-POOL operand can only be used in connection with free tapes. Thus, if a specific DIRECTORY-NAME is employed in a selection criterion in a SELECT operand, only the catalog entries for reserved tapes are modified. However, if a special free tape pool is specified (FREE-POOL operand), only the catalog entries for free tapes are modified.
If you increment the file expiration date EXPIRATION-DATE, the expiration date FREE-DATE will also be incremented.
If you decrement the file expiration date EXPIRATION-DATE, the INITIALIZATION catalog entry field is set to YES.
Modification of the expiration date FREE-DATE is ignored for foreign tapes.
If the value of the FREE-DATE operand is less than that of the EXPIRATION-DATE operand in the catalog entry, then the catalog entry is not modified. Instead, the spin off mechanism is triggered and an appropriate message is output. Decrementing FREE-DATE causes no problems provided EXPIRATION-DATE is decremented at the same time, e.g.:
//MODIFY-VOLUME-ATTRIBUTES VOLUME=TAPE01,FREE-DATE=0,EXPIR-DATE=0It is not possible to change the storage location for tapes assigned to a location with the operating mode ROBAR-2.
Tapes in ARCHIVE directories are not released despite their expiration date being reached. They must first be removed from the directory by means of the ARCHIVE statement POOL or PURGE. If this is not possible because the directory has been deleted in the meantime, the internal MAREN allocation to a directory can subsequently be canceled using the parameter DIRECTORY-NAME= *NONE.
The internal tape lock (MAREN lock) can only be lifted in interactive mode using the statement
MODIFY-VOLUME-ATTRIBUTES VOLUME=<vsn>,LAST-ACCESS-TSN=*NONEwithout any further operand. If the lock has actually been set for a TSN which still exists, the messageMARM157appears.Related tapes can be combined to form a volume group. All files which are located on a tape automatically belong to this volume group. When a reserved tape which is assigned to a volume group is released, the assignment to the volume group is canceled for this tape.
Examples
//modify-volume-attr vol=*int(mb2240,mb2249),location=*par(home-loc=robabba1)
|
This statement is used to assign the permanent location robabba1 for the tapes whose archive numbers lie within the range mb2240 to mb2249.
//modify-volume-attr vol=*all,select=*res(user-id=test1,new-user-id=test2)
|
This statement assigns all tapes previously archived under the user ID TEST1 to the new user ID TEST2.
//mod-vol-attr vol=*int(id5000,id6000),sel=*reserved(user-id=user1), |
The expiration date of all tapes whose archive numbers lie within the range id5000 to id6000 and are assigned to the user ID user1 is set to the current date. As a consequence, the specified tapes are released in the course of the next release run using the MARENADM statement FREE-VOLUMES. Tapes whose archive numbers lie outside the specified number range or are not cataloged under the user ID USER1 are not affected.
//print-vol-attr voL=*int(id5000,id6000),sel=*y(loc01), |
The location da1100 is to be replaced with da1200 in all catalog entries. For this purpose, the SELECT operand in the PRINT-VOLUME-ATTRIBUTES statement must indicate that all catalog entries containing the value da1100 in their HOME-, FREE- or TEMPORARY-LOCATION catalog entry field are to be included in the output file list.vol.1. This can be defined using the parameter set loc01. The output file assigned in PRINT-VOLUME-ATTRIBUTES then serves as the input file for the MODIFY-VOLUME-ATTRIBUTES statement:
//mod-vol-attr vol=*by-input-file(f-name=list.vol.1), |