Library list

When starting the ITP/SDK for iSeries the current library list used is saved. When leaving the ITP/SDK for iSeries the library list is restored to the value prior to starting the ITP/SDK for iSeries. All library list changes while working with the ITP/SDK for iSeries (by the SDK or the user itself) are rolled back.

The ITP/SDK for iSeries itself is responsible for implementing any library list changes needed. When starting the ITP/SDK for iSeries the ITP program library and the ITP/SDK for iSeries database library used are added to the end of the library list. If QTEMP was not already in the library list it is added to the end as well. When generating data retrieval programs for Entries (at the moment the compiler is invoked to create the program) the library containing the database file over which the Entry has been generated and the library in which the program has to be created (the object library of the DID-source) are temporarily added to the library list as well.

The command STRITP also uses the library ITPPGM35 as product library.

Typical library list settings are:

Before starting SDK	After starting SDK	During program generation	After program generation	After ending SDK
<System library list>	<System library list>	<System library list>	<System library list>	<System library list>
	ITPPGM35	ITPPGM35	ITPPGM35
<User library list>	<User library list> ITPPGM35 ITPSRC35	<Database library> <Object library> <User library list> ITPPGM35 ITPSRC35	<User library list> ITPPGM35 ITPSRC35	<User library list>

All these library list changes are automatically performed by the ITP/SDK for iSeries. This also means that at least four library list entries (five if QTEMP is not part of the user library list) must be available in order to work with the ITP/SDK for iSeries. The Database library will not be added to the library list if the Database library is already part of the User library list.

Beware that if an action is performed in the ITP/SDK for iSeries that is not under direct control of the SDK, the library list might not be the one that is actually needed. If for instance a data retrieval program is compiled manually (after using "F10=Command Entry" from one of the ITP/SDK for iSeries screens) the library containing the database file is not added to the library list. Also the presence of the "F10=Command Entry" on many of the ITP/SDK for iSeries screens enables the setting of the library list in such a way that the SDK may no longer function properly (there is no "restore library list" after the "F10=Command Entry" has ended).

Suppose the library XLIB is manually added to the library list before the program generation, then the library list settings from the previous example will be:

Before starting SDK	After starting SDK	After manually changing the library list	During program generation	After program generation	After ending SDK
<System lib. list>	<System lib. list>	<System lib. list>	<System lib. list>	<System lib. list>	<System lib. list>
	ITPPGM35	ITPPGM35	ITPPGM35	ITPPGM35
<User library list>	<User library list> ITPPGM35 ITPSRC35	XLIB <User library list> ITPPGM35 ITPSRC35	<Database lib.> <Object library> XLIB <User library list> ITPPGM35 ITPSRC35	XLIB <User library list> ITPPGM35 ITPSRC35	<User library list>