Delete Media Definition (QSRDLTMD, QsrDeleteMediaDefinition) API
| 1 | Qualified media definition name | Input | Char(20) |
| 2 | Error code | I/O | Char(*) |
Service Program: QSRLIB01
Default Public Authority: *USE
Threadsafe: No
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.
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 about 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
| 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. |
API introduced: V4R4
[ Back to top | Backup and Recovery APIs | APIs by category ]