30.06.2013 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

List Objects (QUSLOBJ) API<br />

Length of authority control format: 48<br />

Call level: 1<br />

Displacement to object authorities: 28<br />

Number of object authorities: 1<br />

Displacement to library authorities: 38<br />

Number of library authorities: 1<br />

Object authorities: '*OBJMGT '<br />

Library authorities: '*USE '<br />

The selection control parameter would contain:<br />

Length of selection control format: 21<br />

Select or omit status value: 1<br />

Displacement to statuses: 20<br />

Number of statuses: 1<br />

Statuses: 'A'<br />

Because the program that calls the QUSLOBJ API adopts authority, the authority check should be<br />

done at the call level previous to the current level (thus call level 1). With call level 1, the list would<br />

not include any objects for which you have adopted authority by the current program.<br />

The select or omit status value of 1 indicates that the returned list will omit the objects you do not<br />

have object management authority to. This authority is specified in the object authorities field.<br />

The format of this parameter is described in Authority Control Format.<br />

Selection control<br />

INPUT; CHAR(*)<br />

The criteria used to select or filter objects from the list based on specified information status values.<br />

This parameter is useful to reduce the total number of objects returned in the list. The list of objects<br />

can be generated with only the specific status that you are interested in. For example, this might be<br />

all damaged objects or all objects that the caller of the API is not authorized to. The list of objects<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/quslobj.htm (5 of 25) [10/4/1999 2:35:53 PM]

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!