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

List Objects (QUSLOBJ) API
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.
Error code bytes provided. The length of the area that the calling application provides for the error code,
in bytes.
Extended object attribute. The extended attribute of the object, such as a program or file type. Extended
attributes further describe the object. For example, an object type of *PGM may have a value of RPG
(RPG program) or CLP (CL program), and an object type of *FILE may have a value of PF (physical file),
LF (logical file), DSPF (display file), SAVF (save file), and so on.
Format name. The format of the returned output.
Information status. Whether or not the QUSLOBJ API returns the requested information for this object.
Possible values are:
blank
The requested information is returned. No errors occurred.
A
No information is returned. The job that called this API needs either the authority specified in the
object authorities field or *ANY authority (the default) to the object.
D
The requested information is returned. However, the object is damaged and should be re-created as
soon as possible.
L
No information is returned because the object is locked.
P
The requested information is returned. However, the object is partially damaged. In most instances,
to recover from partial object damage, you delete the damaged object and either restore a saved
copy or create the object again. For some damaged objects, special recovery procedures are
possible. Refer to the Backup and Recovery book for more information on damaged objects.
If two or more conditions occur that include no authorization (A) to the object, the status is set to A. If the
object is damaged (D) and locked (L), or if the object is partially damaged (P) and locked, the status is set
to L.
If the value of this field is A or L, your application should not use the other fields for the object. Only the
object name, library, and type fields contain accurate data.
Last-used date and time. The date and time at which the object was last used, in system time-stamp
format. If the object has no last-used date, the field contains hexadecimal zeros.
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.
http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (16 of 25) [10/4/1999 2:35:53 PM]