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.
Format
MODIFY-VOLUME-ATTRIBUTES Alias: MD / MDVA | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
,PROTECTION = *UNCHANGED / *PARAMETERS(...)
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 a directory name is entered in the catalog entry, the specification DIR-NAME= *NONE is required before a file name can be entered.
EXPIRATION-DATE = *UNCHANGED / *NONE / <date> / <integer 0..32767 days >
File expiration date. The reservation period can be modified by the MAREN administrator using the MARENADM statement MODIFY-VOLUME-ATTRIBUTES. Nonprivileged users can only change the file expiration date using the RETPD operand in the ARCHIVE statement.
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).
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, the specification DIR-NAME= *NONE is required before a 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, the specification DIR-NAME= *NONE is required before a user ID can be entered.
CREATION-JOB-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.
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 in the statement are updated there.
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 | Archive number, if necessary padded with trailing blanks, e.g. 'TAPE1 ' |
| 11-14 | File sequence number, e.g. '0001' |
| 15-510 | Not set or any text |
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.
SELECT = *BY-DIRECTORY (...)
All tapes of a backup run belonging to a specific directory are processed. The selection may already have been limited using the VOLUME operand.
DIRECTORY-NAME = <filename 1..54 without-gen-vers>
Name of the directory. Only reserved tapes assigned to the 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.
SAVE-FILE-ID =
The tapes that are to be exported are selected using the save file of the directory specified above.
SAVE-FILE-ID = *ALL
All the tapes of the specified save file are selected.
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.
SELECT = *BY-VOLUME-GROUP (...)
The tapes which are to be processed are also selected by specifying the volume group.
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.
PASSWORD = *NONE / *YES / <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.
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.
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 = *UNCHANGED
Specifies that the existing password is not to be changed.
NEW-PASSWORD = *NONE
Specifies that the previous password is to be deleted.
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 =
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 =
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>
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 once it reaches its expiration date.
INITIALIZATION = *YES
The tape is to be initialized after being released. However, if data is written to it before it is released, the value for INITIALIZATION will revert to NO provided the tape was created without protection criteria.
INITIALIZATION = *ERASE
Specifies whether the tape is to be deleted once it reaches its expiration date.
DIRECTORY-NAME = *UNCHANGED / *NONE / <filename 1..54 without-gen-vers>
Name of an directory to which the tape is assigned. 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, CRE-CATALOG-ID, and CRE-USER-ID are supplied with values, these must be deleted with *NONE (e.g. FILE-NAME=*NONE).
DIRECTORY-NAME = *NONE
Any directory name present is deleted.
VOLUME-GROUP = *UNCHANGED / *NONE / <text 1..32 without-sep>
Defines the (new) volume group to which a selected tape is assigned. When *UNCHANGED is specified, the assignment is retained; when *NONE is specified, the affiliation to a volume group may be deleted.
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.
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.
Notes
- If VOLUME=*INTERVAL/*ALL is specified and some catalog entries cannot be modified in the specified area, these catalog entries are logged with a message to this effect, and the statement is continued.
- 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.
- 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.
- It is not possible to change the storage location for tapes assigned to a location with the operating mode ROBAR-2.
- The user cannot modify the directory names of own tapes assigned by the MAREN administrator to a directory free tape pool (FREE-POOL=<filename>).
- It is advisable to modify or delete the directory name when the directory whose pool the tape was assigned to is renamed or deleted.
- Tapes in directories are not automatically released when their expiration date is reached. They are released only after they have been removed from the directory using the relevant ARCHIVE or HSMS statements (ARCHIVE: PURGE or POOL; HSMS: MODIFY-ARCHIVE SAVE=*DELETE or VOLUME= *REMOVE). 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 MODIFY-VOLUME- ATTRIBUTES DIRECTORY-NAME=*NONE statement.
- If the tapes are selected using a save file from HSMS (operand SELECT=*BY-DIRECTORY(...)), temporarily locked catalog entries will also be processed.
- 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-attributes volume=idx005,free-date=<date>,user-acc=*all
|
The expiration date for tape IDX005 is set to the specified date. At the same time, the tape is declared shareable with no restrictions, i.e. foreign user IDs enjoy both read and write access to the tape.
//modify-volume-attributes volume=tape01,pass='x2w3',new-pass=*none
|
This statement deletes an existing password for the tape tape01.
//modify-volume-attributes volume=*int(IDX006,IDX008),remark='project1'
|
This statement enters the text project1 in the remark field of the archived tapes IDX006 through IDX008 belonging to the relevant user.
//print-vol-attr vol=*all,sel=*y(save01),output=list.vol.2,layout-contr=*no
|
All tapes whose catalog entry field REMARK contains the text “SAVEPROG” are to be released. For this purpose, the SELECT parameter of the PRINT-VOLUME-ATTR statement must be set such that the character string in the REMARK catalog entry field must match “SAVEPROG”. This selection criterion is already defined in the parameter set save01. Output is to be written to the LIST.VOL.2
The output file assigned in PRINT-VOLUME-ATTRIBUTES then serves as the input file for the MODIFY-VOLUME-ATTRIBUTES statement:
//modify-volume-attr vol=*by-input-file(f-name=list.vol.2),protection=*par(free-date=0)
|