| 1 | Qualified media definition name | Input | Char(20) |
| 2 | Error code | I/O | Char(*) |
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 Saving to multiple devices to reduce your save window in the Backing up your system topic collection.
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 about the libraries included, see *ALLUSR in Generic library names. |
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9800 E | All CPF98xx messages could be signaled. xx is from 01 to FF. |
| CPF9999 E | Function check. &1 unmonitored by &2 at statement &5, instruction &3. |
[ Back to top | Backup and Recovery APIs | APIs by category ]