Retrieve Short Name (QDBRTVSN) API
Required Parameter Group:
1 | Qualified ![]() ![]() |
Output | Char(20) |
2 | Long ![]() ![]() |
Input | Char(128) |
3 | Length of long ![]() ![]() |
Input | Binary(4) |
4 | Library name | Input | Char(10) |
5 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: Yes
The Retrieve Short Name(QDBRTVSN) API allows you to get the 10-character object
name of a database file
or
library
by providing
the long
object
name. The information is returned as a qualified
object
name. (Objects with long object names can be created using SQL CREATE statements.
An object with a long name also has a short 10-character name.)
Authorities and Locks
Object
Authority
- *OBJOPR
Required Parameter Group
- Qualified
object
name
- OUTPUT; CHAR(20)
The short
object
name being retrieved and the library in which it is located. The first 10 bytes contain the
object
name, and the second 10 bytes contain the library name. If the input library name is *LIBL, or *CURLIB, the library name will be returned.
If the object being retrieved is a library, the second 10 bytes will contain 'QSYS'.
If the 20 bytes are blanks, this means the
object
name could not be returned.
- Long
object
name
- INPUT; CHAR(128)
The long
object
name from which the short name will be retrieved.
- Length of long
object
name
- INPUT; BINARY(4)
The length of the long
object
name.
- Library name
- INPUT; CHAR(10)
The name of the library of the
object
. If you use
*CURLIB or *LIBL
, the actual name of the library will be returned in the qualified
object
name parameter. You can use the following special values:
*CURLIB The job's current library. *LIBL The library list. blank
Indicates that the input long name is a long library name and the library short name will be returned.
- 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 |
---|---|
CPF2207 E | Not authorized to use object &1 in library &3 type *&2. |
CPF24B4 E | Severe error while addressing parameter list. |
CPF3C22 E | Cannot get information about file &1. |
CPF5715 E | File &1 in library &2 not found. |
![]() |
Library &1 not found.![]() |
API introduced: V3R7
[ Back to top | Database and File APIs | APIs by category ]