REMOVE-USER-VOLUMES Remove catalog entries of a user from the MAREN catalog

Privilege                 ADA, administrator without domains

This statement deletes all catalog entries under a specific user ID and, when required, transfers them to a file.

Format

REMOVE-USER-VOLUMES                                                   Alias: RMUV

USER-IDENTIFICATION = <name 1..8>
,ACCOUNT = *ALL / <alphanum-name 1..8>
,DOMAIN = *STD-DOMAIN / *OWN / <alphanum-name 1..8>
,OUTPUT = *SYSOUT / <filename 1..54 without-gen-vers>(...)
	<filename 1..54 without-gen-vers>(...)
		|	NEW-HOME-LOCATION = *UNCHANGED / <alphanum-name 1..8>
,OVERFLOW-CONTROL = *BY-PROGRAM / *BY-SYSTEM

Operands

USER-IDENTIFICATION = <name 1..8>
User ID whose catalog entries are to be deleted from the MAREN catalog.

ACCOUNT = *ALL / <alphanum-name 1..8>
Account number. Under the specified user ID, only those catalog entries which are assigned to the specified account number are deleted.

ACCOUNT = *ALL
All account numbers of the user ID.

DOMAIN =
Only those catalog entries are removed from the specified user ID which are assigned to the specified domain.

DOMAIN = *STD-DOMAIN
Only the catalog entries of the standard domain are deleted.

DOMAIN = *OWN
Only the catalog entries of the user’s own domain are deleted. The user’s own domain is the domain of the system on which the ADA is currently working.

DOMAIN = <alphanum-name 1..8>
Only the catalog entries of the specified domain are deleted.

OUTPUT =
Determines the output medium. Output to SYSOUT is the default.

OUTPUT = *SYSOUT
The deleted catalog entries are logged to SYSOUT.

OUTPUT = <filename 1..54 without-gen-vers>(...)
Name of an output file. The deleted catalog entries are written to the specified file. The file type is SAM.

NEW-HOME-LOCATION = *UNCHANGED / <alphanum-name 1..8>
Location name or symbolic location name. Specifies location where the tapes are normally to be stored once they have been returned to the MAREN catalog.

NEW-HOME-LOCATION = *UNCHANGED
The previous location names are transferred to the output file unchanged.

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

• Tapes of an archive system must be exported before they are deleted. Otherwise the message MARM015 is issued for the tapes concerned.

• Each deleted catalog entry is logged.

• If NEW-HOME-LOCATION is specified, this value is set for HOME-LOCATION, FREE-LOCATION, and TEMPORARY-LOCATION in the catalog entry.

• If MARENADM is executed under the user ID TSOS, the passwords are written to the output file in plain text. Otherwise, any existing passwords are overwritten with C'$$$$'.

• If a temporarily locked catalog entry exists for an entry to be deleted, it is likewise deleted if it belongs to the defined user ID and account number.

• The spin off mechanism is triggered if a catalog entry cannot be deleted.

Example

//remove-user-volumes user-id=user1,output=lst.remove.user1
%  MARM106 MAREN CATALOG ENTRY 'ID0001'/'0001' ERASED
%  MARM106 MAREN CATALOG ENTRY 'ID0101'/'0001' ERASED
%  MARM106 MAREN CATALOG ENTRY 'ID1100'/'0001' ERASED
%  MARM106 MAREN CATALOG ENTRY 'ID1101'/'0001' ERASED
%  MARM106 MAREN CATALOG ENTRY 'ID1102'/'0001' ERASED
%  MARM106 MAREN CATALOG ENTRY 'ID1103'/'0001' ERASED
%  MARM104 TOTAL OF 6 MAREN CATALOG ENTRIES ERASED
%  MARM119 FILE 'LST.REMOVE.USER1' WITH 6 RECORDS CREATED

All catalog entries of the ID user1 are saved unchanged to the file LST.REMOVE.USER1 and then removed from the MAREN catalog. Using the output file specified in the INPUT-FILE operand of the ADD-RESERVED-VOLUME statement, the catalog entries can be reconstructed or imported into another system.