- 论坛徽章:
- 0
|
回复 #3 lizi211314 的帖子
2) list member API
List Database File Members (QUSLMBR) API
Required Parameter Group:
1 Qualified user space name Input Char(20)
2 Format name Input Char(
3 Qualified database file name Input Char(20)
4 Member name Input Char(10)
5 Override processing Input Char(1)
Optional Parameter:
6 Error code I/O Char(*)
Service Program Name: QUSLMBR
Default Public Authority: *USE
Threadsafe: Conditional; see Usage Notes.
The List Database File Members (QUSLMBR) API generates a list of database file members and places the list in a specified user space. When you specify a generic member name, you can generate a subset of the member list. You can use the QUSLMBR API with database file types *PF, *LF, and *DDMF. The generated list replaces any existing information in the user space. The file members listed in the user space are not in any predictable order. To retrieve additional information about each member in the list, see the Retrieve Member Description (QUSRMBRD) API.
You can use the QUSLMBR API to:
* List members more quickly than by using the *MBRLIST value on the TYPE parameter of the Display File Description (DSPFD) command.
* Retrieve information for all of the members of a database file more quickly and easily than by multiple calls to the Retrieve Member Description (QUSRMBRD) API. It is your discretion to decide which API best suits the needs of your application. For example, if you want to selectively retrieve member descriptions for a subset of the member list, you might want to use both the QUSLMBR and QUSRMBRD APIs.
* Ensure that the last date the source was changed matches the date of the source used to create the object.
Authorities and Locks
User Space Authority
*CHANGE
User Space Library Authority
*EXECUTE
File Authority
*OBJOPR
User Space Lock
*EXCLRD
File Lock
*SHRRD
Required Parameter Group
Qualified user space name
INPUT; CHAR(20)
The user space that is to receive the created list. The first 10 characters contain the user space name, and the second 10 characters contain the name of the library where the user space is located. You can use these special values for the library name:
*CURLIB The job's current library
*LIBL The library list
Format name
INPUT; CHAR(
The content and format of the information returned for each member. The possible format names are:
MBRL0100 Member name
MBRL0200 Member name and source information This format requires more processing than the MBRL0100 format.
MBRL0310 Member name and basic description. The member information is the same as that generated by the Retrieve Member Description (QUSRMBRD) API using format MBRD0100. This format requires more system processing and takes longer to produce than the MBRL0200 format.
MBRL0320 Member name and expanded description. The member information is the same as that generated by the Retrieve Member Description (QUSRMBRD) API using format MBRD0200. The additional information requires more system processing and takes longer to produce than the MBRL0310 format.
MBRL0330 Member name and full description. The member information is the same as that generated by the Retrieve Member Description (QUSRMBRD) API using format MBRD0300. The additional information requires more system processing and takes longer to produce than the MBRL0320 format.
For more information, see MBRL0100 List Data Section, MBRL0200 List Data Section, or MBRL0300 List Data Section.
Qualified database file name
INPUT; CHAR(20)
The name of the database file whose member names are to be placed in the list. The first 10 characters contain the database file name, and the second 10 characters contain the name of the library where the file is located. You can use these special values for the library name:
*CURLIB The job's current library
*LIBL The library list
Member name
INPUT; CHAR(10)
A specific member name, a generic member name, or this special value:
*ALL All members
Override processing
INPUT; CHAR(1)
Whether overrides are to be processed. The following character values are used:
0 No override processing
1 Override processing |
|