FRM100 - Calling a Function

Slave Workstation

To complete this exercise you must be using Visual LANSA as a Slave Workstation. This means it can be connected to a Master LANSA system on an IBM i server, so that you can check in and check out Repository objects and execute a form in client/server mode against the IBM i server.

If you are using a free trial copy of Visual LANSA or Visual LANSA as a Standalone installation, you can complete the exercise but will only call the function as a Windows Application running on the desktop, with a local database.

Objective

• To demonstrate the EXCHANGE and CALL commands and the CALL_SERVER FUNCTION BuiltIn Function.
  To do this:

• You will create a simple form, Salary Review, which calls a function passing department code and a number that represents 'percentage salary increase'.

• The called function will create a list of employees for the requested department, containing both current and new salaries based on the percentage increase. This results list is returned to the calling form.

• The Salary Review form will display the result in a list view and calculates the total cost of the increase.

• The called function will be compiled for Windows and will also be checked in and compiled on the IBM i server.

• The Salary Review form will be tested in two different modes:

• As a Windows Application running on the desktop, with a local database.

• As a client to an RDMLX IBM i Server

• The form will use a system variable *SSERVER_CONNECTED (value Y or N) to determine whether to CALL the local function, or use CALL_SERVER_FUNCTION to call the function running on the IBM i server.

In order to achieve these objectives, you must complete the following:

Step 1. Create the Called Function

Step 2. Create Salary Review Form

Step 3. Add Form Logic

Step 4. Test Salary Review Application

Summary

Before You Begin

Complete all earlier FRM exercises.

This exercise requires access to an IBM i server.