Delete Media Definition (QSRDLTMD, QsrDeleteMediaDefinition) API

The Delete Media Definition (OPM, QSRDLTMD; ILE, QsrDeleteMediaDefinition) API deletes a media definition specified by the user. A media definition defines the devices, media, and data format to be used in parallel by a save or restore operation. For more information about using a media definition, see Save to multiple devices in the Backup and recovery topic.

Authorities and Locks

Media Definition Authority

*OBJEXIST

Library Authority

*EXECUTE

Media Definition Lock

*EXCL

Library Lock

*SHRUPD

Required Parameter Group

Qualified media definition name

INPUT; CHAR(20)

The media definition to be deleted. The first 10 characters contain the media definition name. The second 10 characters contain the name of the library in which the media definition is located.

The media definition name can be either a specific name or a generic name, which is a string of one or more characters followed by an asterisk (*). If you specify a generic name, this API deletes all media definitions that have names beginning with the string for which the user has authority.

You can use the following special values for the library name. It should be noted, however, that the library name that is actually used is not passed back to the user. Care should be taken when using these special values to avoid unexpected results.

*CURLIB	The job's current library is used to locate the media definition. If no library is specified as the current library for the job, the QGPL library is used.
*LIBL	The library list is used to locate the media definition.
*USRLIBL	The user portion of the job's library list is used to locate the media definition.
*ALL	All libraries in the system, including QSYS, are searched.
*ALLUSR	All user-defined libraries, plus libraries containing user data and having names starting with Q. For information on the libraries included, see *ALLUSR in Generic library names.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Error Messages