EGL Server Guide for iSeries


Making EGL Server for iSeries, COBOL, and generated modules available

The setup tasks that are required to run EGL applications on iSeries are simpler than with other run-time environments because no run-time setup control programs are produced, other than the application program itself.

EGL Server for iSeries and the generated COBOL applications use the run-time job library list (*LIBL) to resolve all named object references

The library list must be set up by the application programmer, system administrator, or EGL application developer before starting the application. To aid in the library setup, Table 5 lists the names and types of objects that EGL might use while running in the iSeries environment. EGL searches for these objects dynamically when the application is running by scanning the libraries named in the library list. It is recommended that the installation library, QEGL, be added to the library list of the end user when running EGL applications.

EGL uses the first object it finds that matches the target name in the libraries named in the library list. This first-found object is used in all cases of object resolution except for objects of *FILE type. In this case, EGL uses the first member it finds that matches the target name, after the first member have been qualified with the correct file name. Multiple files with the same name might exist in the libraries named in the library list. EGL checks each library file until it finds the first instance of the member name.

Table 5. Names and types of objects used by EGL at run time

Object and library name Type Description
QVGN* QEGL *PGM *SRVPGM EGL Server for iSeries program and service program objects.
OVGNMSGF QEGL *MSGF EGL Server for iSeries product message file.
QVGNMAPG userlib *FILE Members of this file contain the generated applications 5250 form groups. Members are named for the form group it contains.
QVGNTAB userlib *FILE Members of this file contain the generated applications tables. Members are named for the table it contains.
QVGNPRNT QEGL *FILE This is the standard printer device file for application use of the Printer file. Usually, all jobs on the system share one of these objects.
QVGMAP QEGL *FILE This standard display device file is used for interactive applications when they display maps. Usually, all jobs on the system share one of these objects.
mmmmnls userlib *MSGF A specific application's message table, where mmmm is the message table prefix as defined to the application, and nls is the value of the build descriptor option targetNLS when the application was generated.
calltarg userlib *PGM Any target of the call or transfer statements coded within an application.
filetarg userlib *FILE Any file named on record definitions used by EGL process options within an application.
Note:
The designated library userlib in Table 5 indicates that the object is in a library named by the application developer at the time the application was developed.

The two exceptions to using the library list to resolve object references by running applications are as follows:

In either case, SQL object resolution is independent of the library list.


[ Top of Page | Previous Page | Next Page | Table of Contents ]