Data Queue APIs--Categories - FTP Directory Listing - IBM

Open List of Objects (QGYOLOBJ) API
Number of library authorities: 1
Object authorities: '*OBJMGT '
Library authorities: '*USE '
The selection control parameter would contain:
Length of selection control format: 21
Select or omit status value: 1
Displacement to statuses: 20
Number of statuses: 1
Statuses: 'A'
Because the program that calls the QGYOLOBJ API adopts authority, the authority check should be
done at the call level previous to the current level (thus call level 1). With call level 1, the list would
not include any objects for which you have adopted authority by the current program.
The select or omit status value of 1 indicates that the returned list will omit the objects you do not
have object management authority to. This authority is specified in the object authorities field.
The format of this parameter is described in Authority Control Format.
Selection control
INPUT; CHAR(*)
The criteria used to select or filter objects from the list based on specified information status values.
This parameter is useful to reduce the total number of objects returned in the list. The list of objects
can be generated with only the specific status that you are interested in. For example, this might be
all damaged objects or all objects that the caller of the API is not authorized to. The list of objects
also can be generated with all objects except objects of a specific status.
The following example shows what you would specify to select all damaged objects:
Length of selection control format: 22
Select or omit status value: 0
Displacement to statuses: 20
Number of statuses: 2
Statuses: DP
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qgyolobj.htm (5 of 24) [10/4/1999 2:36:21 PM]