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

List Objects (QUSLOBJ) API
Offset
Dec Hex
Type Field
0 0 BINARY(4) Length of selection control format
4 4 BINARY(4) Select or omit status value
8 8 BINARY(4) Displacement to statuses
12 C BINARY(4) Number of statuses
16 10 BINARY(4) Reserved
ARRAY(*) Statuses
of
CHAR(1)
Field Descriptions
Call level. The number of call levels to go back in the call stack to do the authority check. If optional
parameter group 2 is omitted, a call level of 0 is used.
For example, if the program that calls this API adopts authority, you would probably not want the
authority check to use the adopted authority. Therefore, the authority check should be done at the call level
previous to the current level. This field should then contain a 1. You can check the authority at various call
levels by specifying a number equivalent to the call level. For example, to check the authority at the
current call level, specify a 0. To check the authority at the previous call level, specify a 1.
This field must be greater than or equal to 0 and less than the number of programs in the call stack.
Displacement to library authorities. The byte offset from the beginning of the authority control format
to the list of library authorities. The offset value must be at least 28, which is past the reserved portion of
the format.
Displacement to object authorities. The byte offset from the beginning of the authority control format to
the list of object authorities. The offset value must be at least 28, which is past the reserved portion of the
format.
Displacement to statuses. The byte offset from the beginning of the selection control format to the list of
statuses requested. The offset value must be at least 20, which is past the reserved portion of the format.
Length of authority control format. The total length of the authority control format. The minimum size
is 48 bytes, which allows for one object and one library authority. An error is returned if the length
specified is less than the minimum.
Length of selection control format. The total length of the selection control format. The minimum size is
21 bytes, which allows for one status value. An error is returned if the length specified is less than the
minimum.
Library authorities. The authority to check for libraries. The array can contain up to ten 10-character
fields. If optional parameter group 2 is omitted, *EXECUTE authority is checked for on the libraries.
The authority values can be specified in any combination. If *ALL, *CHANGE, or *USE is specified with
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (7 of 25) [10/4/1999 2:35:53 PM]