Library List Considerations for the Request Server Jobs
The prime purpose of the request server jobs is to call a LANSA function, often on a different server system and/or in a different LANSA system and/or partition to the requesting job.
The LANSA Composer Request Server for IBM i does this using a LANSA program library name and a partition name passed to it as part of the request. The request server job uses this information to invoke the requested function in LANSA, relying entirely on LANSA's standard library list management features - in other words, LANSA will alter the library list to contain the libraries necessary for execution of functions in the specified LANSA system and partition, according to the applicable LANSA system and partition settings.
The initial library list for the request server job should never contain any LANSA libraries. In particular, if the initial library list contains LANSA libraries for a LANSA system other than that in which the request is executing, severe and unpredictable execution errors may occur.
Note that the library containing the LANSA Composer Request Server for IBM i software does NOT need to be in the library list, providing the request server job is initiated using a qualified call to the DXRQSSERV program. The request server, although it may be installed in a LANSA system or partition library, is entirely composed of non-LANSA software, does not itself use the LANSA run-time (other than to execute the specified request) and makes fully-qualified references to its own components using the library name from which the DXRQSSERV program is started.
If your application requires libraries in the library list other than those that are automatically added by LANSA, then you will have to make provision yourself for adding those libraries. This would typically be done in one of two ways, depending on your specific requirements:
- By specifying the libraries in the initial library list for all request server jobs;
- By having your called function alter the library list as required.