Privilege ADA, administrator without domains
This statement deletes the catalog entries of free tapes from the MAREN catalog.
Tapes of an archive system must be exported before they are deleted. Otherwise the message MARM015 is issued for the tapes concerned:
Format
REMOVE-FREE-VOLUMES Alias: RMFV | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
VOLUME =
Archive numbers of the free tapes whose catalog entry is to be deleted.
VOLUME = *ALL
All tapes are processed.
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 program interface.
VOLUME = <vsn>
Archive number.
SELECT =
Specifies which catalog entries are to be processed.
SELECT = *STD
Specifies that processing is not restricted to any particular location for free tapes.
SELECT = *BY-ATTRIBUTES(...)
FREE-LOCATION = *ALL / <alphanum-name 1..8>
Location name or symbolic location name. All catalog entries with the specified location for free tapes are processed.
FREE-LOCATION = *ALL
Processing is not restricted to any particular location for free tapes.
DEVICE-TYPE =
Device type.
DEVICE-TYPE = *STD
Only tapes of the default device type (DEFAULT-DEVICE-TYPE) are selected whose value was specified in the MODIFY-MAREN-PARAMETERS statement.
DEVICE-TYPE = <structured-name 1..8>
Device type. Which types can be specified depends on the BS2000 version (see the manual “System Installation”
[6]). In addition, foreign device types can be specified which have been made known using the ADD-FOREIGN-DEVICE-TYPE statement. Device type TAPE-UxE is not permissible as free tapes are not encrypted.
FREE-POOL =
Selects the catalog entries of free tapes to be deleted on the basis of the free tape pool.
FREE-POOL = *NO
Only free tapes assigned to the *NO free tape pool are selected.
FREE-POOL = *GLOBAL
Only free tapes assigned to the *GLOBAL free tape pool are selected.
FREE-POOL = *TSOS
Only free tapes assigned to the *TSOS free tape pool 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 for HSMS/ARCHIVE applications using 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 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.
DOMAIN =
Specifies the domain whose tapes are to be processed.
DOMAIN = *STD-DOMAIN
The tapes of the standard domain 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 = <alphanum-name 1..8>
The tapes of the specified domain are processed.
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.
Examples
//remove-free-vol vol=(tape05,tape06)
|
The archive numbers of the free tapes tape05 and tape06 are deleted from the MAREN catalog.
//remove-free-vol vol=*int(id0001,id0100),sel=*by-attr(free-loc=cpu11)
|
From the set of all free tapes of the standard device type assigned to the tape location CPU11, all archive numbers in the value range ID0001 through ID0100 are removed.