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

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

as400bks.rochester.ibm.com
from as400bks.rochester.ibm.com More from this publisher
30.06.2013 Views

Object APIs Object APIs You can use object APIs to obtain information about OS/400 objects. The object APIs and their functions include the following: ● Change Library List (QLICHGLL) changes the current library, the two product libraries, and the user part of the job's library list. ● Change Object Description (QLICOBJD) changes object information for a specific object. ● Convert Type (QLICVTTP) converts an object type to and from hexadecimal format. ● List Objects (QUSLOBJ) generates a list of object names and descriptive information based on the specified parameters. ● Materialize Context (QusMaterializeContext) returns either the type and subtype of the object or system pointers for all or for a selected set of objects that are contained by the context. ● Move Folder to ASP (QHSMMOVF) moves a root folder and its contents from its existing auxiliary storage pool (ASP) to the specified target ASP through a save and restore process. ● Move Library to ASP (QHSMMOVL) moves a library and its contents from its existing auxiliary storage pool (ASP) to the specified target ASP through a save and restore process. ● Open List of Objects (QGYOLOBJ) generates a list of object names and descriptive information based on specified selection parameters. ● Rename Object (QLIRNMO) renames an existing object to a new object name or new library name or both and optionally replaces the object. ● Retrieve Library Description (QLIRLIBD) retrieves attributes for a specific library. ● Retrieve Object Description (QUSROBJD) retrieves object information for a specific object. The QUSLOBJ and QUSROBJD APIs return much of the same information. However, the APIs differ in several respects: ● The APIs group the returned information differently among their output formats. For example, the OBJL0300 format of the QUSLOBJ API does not contain exactly the same data as the OBJD0300 format of the QUSROBJD API. ● The APIs use different data formats for some specific items, such as dates and times. ● The APIs differ in efficiency, depending on your application. In most cases, the QUSROBJD API is faster at retrieving information about a single object. The QUSLOBJ API is faster at retrieving information about several objects. Top | Object API categories | APIs by category [Information Center Home Page | Feedback ] [Legal | AS/400 Glossary] http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/obj6.htm [10/4/1999 2:35:37 PM]

Change Library List (QLICHGLL) API Change Library List (QLICHGLL) API Required Parameter Group: 1 Current library name Input Char(11) 2 First product library name Input Char(11) 3 Second product library name Input Char(11) 4 User library list names Input Array(*) of Char(11) 5 Number of user library names Input Binary(4) 6 Error code I/O Char(*) Threadsafe: Yes The Change Library List (QLICHGLL) API changes the current library, the two product libraries, and the user part of the current thread's library list. When the initial thread's library list is changed, each library added to the list is locked with a shared-read lock. If a library is being removed from the initial thread's library list, the shared-read lock is released. When a secondary thread's library list is changed, libraries added to the library list are not locked. Authority to the library is checked whenever a library name is specified on one of the required parameters. You may want to save the current thread's library list before changing it. The QWCRTVCA API can be used to retrieve the current thread's library list. The Retrieve Job Information (QUSRJOBI) API can be used to retrieve the initial thread's library list, when the current thread is not the initial thread. You can then change the library list back to its original value by using the QLICHGLL API with the libraries saved from the QUSRJOBI or QWCRTVCA API. Authorities and Locks Library Authority *USE Library Lock *SHRRD (initial thread only) http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qlichgll.htm (1 of 4) [10/4/1999 2:35:39 PM]

Change Library List (QLICHGLL) API<br />

Change Library List (QLICHGLL) API<br />

Required Parameter Group:<br />

1 Current library name Input Char(11)<br />

2 First product library name Input Char(11)<br />

3 Second product library name Input Char(11)<br />

4 User library list names Input Array(*)<br />

of<br />

Char(11)<br />

5 Number of user library names Input Binary(4)<br />

6 Error code I/O Char(*)<br />

Threadsafe: Yes<br />

The Change Library List (QLICHGLL) API changes the current library, the two product libraries, and the<br />

user part of the current thread's library list.<br />

When the initial thread's library list is changed, each library added to the list is locked with a shared-read<br />

lock. If a library is being removed from the initial thread's library list, the shared-read lock is released.<br />

When a secondary thread's library list is changed, libraries added to the library list are not locked.<br />

Authority to the library is checked whenever a library name is specified on one of the required parameters.<br />

You may want to save the current thread's library list before changing it. The QWCRTVCA API can be<br />

used to retrieve the current thread's library list. The Retrieve Job Information (QUSRJOBI) API can be<br />

used to retrieve the initial thread's library list, when the current thread is not the initial thread. You can<br />

then change the library list back to its original value by using the QLICHGLL API with the libraries saved<br />

from the QUSRJOBI or QWCRTVCA API.<br />

Authorities and Locks<br />

Library Authority<br />

*USE<br />

Library Lock<br />

*SHRRD (initial thread only)<br />

http://infocntr.rchland.ibm.com/pubs/html/as400/v4r5/ic2924/info/apis/qlichgll.htm (1 of 4) [10/4/1999 2:35:39 PM]

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

Saved successfully!

Ooh no, something went wrong!