Bring Database Records (QDBBRCDS) API asynchronously brings database physical file records into main storage. You can use the QDBBRCDS API only with database file type *PF. If a distributed file is specified, only the records on the local system are brought. File overrides do not affect the specified file, library, or member names.

Required Parameter Group:

Optional Parameter Group 1

Authorities and Locks

Library Authority

*EXECUTE

File Authority

*OBJOPR

File Lock

None

Required Parameter Group

Qualified database physical file name

INPUT; CHAR(20)

The name of the database physical file containing the specified member whose information is to be retrieved and the library in which it is located. The first 10 characters contain the database physical file name; the second 10 characters contain the library name.

You can use these special values for the library name:

*CURLIB	The job's current library
*LIBL	The library list

Database physical file member name

INPUT; CHAR(10)

The name of the database physical file member for which information is to be retrieved.

Special values follow:

*FIRST	The first database physical file member found.
*LAST	The last database physical file member found.

Relative record array

INPUT; CHAR(*)

A array of unsigned Binary(4) variables that contain the relative record numbers that should be brought.

If an invalid relative record number is specified, it is tolerated and no error is returned. All relative record numbers prior to the invalid relative record number in the array are processed. Invalid relative record numbers in the array are ignored.

Number of records in the array

INPUT; BINARY(4)

An unsigned Binary(4) variable that contains the number of relative record numbers in the array. The number of relative record numbers must not exceed 1000.

Optional Parameter Group 1

Error code

I/O; CHAR(*)

The structure in which to return error information. If this parameter is omitted, diagnostic and escape messages are issued to the application.

Error Messages