Library Lists

This dialog allows you to set up your Compile-Time and Run-Time Library Lists. A library list specifies which libraries are to be searched for files and the order in which they are to be searched.

You may create more than one compile-time library list, although only one is used at any given time. Compile-time library lists are used when programs or smart pages are compiled. Compile-time library lists are saved on your development PC and are not shared outside of the RPGsp Development Environment.

In contrast, there is only one run-time library list per RPG/CGI object library. To set up more than one RPG/CGI object library, you must create additional iSeries Server Profiles. Run-time library lists are saved to the iSeries and immediately affect any pages being served from the corresponding RPG/CGI library. Run-time library lists are used by RPG Smart Pages as they are executed. Run-time library lists are also automatically shared amongst all developers working within the same RPG/CGI library.

Please note: If you need to add a library to the run-time library list that will only apply to a single server instance, use the syntax: ServerInstanceName:LibraryName

In the run-time library list pictured below, library L2DATA is on the library list only for pages being served from the RPGSPTEST server instance. Applications running on any of the other server instances using this RPG/CGI library will not have L2DATA on their library lists.

Compile-time Library List Name

This name identifies the compile-time library list. If you name a compile-time library list the same as a profile name, the list will be associated with the profile. The library list will then be selected automatically when you switch to the profile. When you add a library list, its default name will be the same as the current profile name.

Compile-time Libraries

This is the list of libraries comprising the compile-time library list. You must enter one library per line. Make sure not to leave any blank lines. These libraries are used when compiling RPG Smart Pages or traditional iSeries programs or modules. The compile-time library is stored on your PC, and each developer has their own set of compile-time library lists.

Run-time Libraries

This is the list of libraries comprising the run-time library list. You must enter one library per line. Make sure not to leave any blank lines. The run-time library list is stored in a source member named LIBLIST in the QCOMPILED file of the active RPG/CGI object library. The run-time library list only applies to RPG Smart Pages; it does not apply to traditional iSeries programs and modules. The runtime library list is read from the LIBLIST member and set by each RPGsp page before it is executed.

Using the special value of *JOBD or *SAME in the runtime library list will cause your RPGsp pages to not load the runtime library list. Instead, the library list of the current job will be used. This method is also useful if you would like to control the library list through CL programs, which is often the case in a converted Green-Screen application.

Keep the Same

This option synchronizes the compile-time and run-time library lists. It is enabled by default. When you type in a change to either list, the other list will also be updated. This option is useful for initially setting up your lists. As your environment grows more complex, you may want to disable this option for more control over the library lists.

Down Arrow

The down arrow allows you to synchronize your compile-time and run-time library lists by replacing the current run-time library list with the current compile-time library list.

Up Arrow

The up arrow allows you to synchronize your compile-time and run-time library lists by replacing the current compile-time library list with the current run-time library list.

Load from iSeries Button

The run-time library list must be loaded from the iSeries. By default, the library list is loaded automatically when you switch to the Library List Tab. If, for some reason, the library list does not load successfully, you will see a button labeled "Load from iSeries". You can click this button to attempt to load the run-time library list again.

Save to iSeries Button

The run-time library list must be saved to the iSeries if it is changed. You can click on the "Save to iSeries" button to do so manually, or you can let RPGsp save the library list automatically when you accept your changes with the Ok button or the Accept button.

Profound Logic Software, Inc.
www.ProfoundLogic.com
(937) 439-7925