About this tutorial


In this tutorial, you will learn about checking your PC and browser requirements, verifying your aXes installation and setting up a project.


Successful aXes installation


Check development PC

Check Internet Explorer settings

Check aXes demo library and server settings

Set up a project

Check your development PC is ready

To do application development using eXtensions you need to have an up to date development PC. Complete this checklist:

PC Check List


Core 2 Duo class processor, equivalent or better with 1Gb RAM or more

You can use eXtensions on systems below this recommended specification, but your development activities will be impacted accordingly. You should consider upgrading your development system.

Screen resolution of 1440×1080 or better

There are productivity and ease of use benefits to be gained by using a wide screen monitor or multiple side-by-side monitors when doing any type of IT application development. Any form of IT application development on a low-resolution monitor (eg: 1024x768) will take longer and be more cumbersome than it needs to be.

Windows 8 or later.


Internet Explorer set as the default browser


Check your Internet Explorer settings

To do aXes application development you will use Internet Explorer.

Complete this Internet Explorer checklist:

Internet Explorer Check List

Check that Internet Explorer's SmartScreen Filter is turned off.

Use the Safety button to view the status of your Internet Explorer SmartScreen Filter. If it is turned on then turn it off.

The off setting is strongly recommended for application developers to avoid Internet Explorer failures.

Check that the aXes server is in your trusted sites list.

Open your browser. Use Tools -> Internet Options -> Security tab.

Select Trusted sites, and click the Sites button.

In this example http://lansa04 is the aXes server root address, so it was added:


In order to see the changes you make immediately, ensure that you are not using cached pages. To do this, click on the Settings button in the browsing history section of the General tab, and then select the option to check for newer versions of stored pages, every time I visit the webpage:


Check that any pop up blocker(s) you have installed do not block pop ups initiated by scripts loaded from your aXes server.

Check that library AXESDEMO is installed and useable

To complete the eXtensions tutorials you must have library AXESDEMO installed on your system.

The aXes demonstration material is installed by option 99 during an aXes install.

Perform this check before starting any eXtensions tutorials:

Check for AXESDEMO Library

Sign on to a 5250 screen.


Run the command CALL XHRRPGTRN

The resulting 5250 display should look like this:


The eXtensions tutorials will use these objects from the AXESDEMO library:






5250 Employee Maintenance Program



Display file used by program XHRRPGTRN 



Physical file of Business Units



View of Business Units



Physical file of Departments 



Physical file of Employees



View of Employees



View of Employees

Check your aXes Server settings

Check this if your aXes system has been upgraded from 1.32 (or earlier).

Do not check this if you have installed a brand new aXes system.

Check aXes Server Settings

Locate your aXes W3 configuration file.

Typically, it is located in folder axes/configs and named aXesW3.conf

Edit the file and locate the PostLimit directive. It may look like this:

# The maximum allowed size of data POSTed to the transaction server

# PostLimit=5000

Change the line to be like this:

# The maximum allowed size of data POSTed to the transaction server


Ensure the PostLimit directive is no longer a comment (no leading hash) and the value has been changed to 12000.

If you changed this file, save the changes, then stop and restart your aXes server instances so that the change can take effect.

Set up an eXtensions project

Create a new short cut onto your workstation's desktop:


http://<your aXes host>/ts/dev/index.html


aXes Projects Home Page

Replacing <your aXes host> with the appropriate IP address and port number.

For example: http://lansa08:8310/ts/dev/index.html

It should appear on your desktop like this:


Use the new shortcut to open the aXes Projects Home Page.

When requested, enter the aXes developer user profile and password.


The shipped defaults are,

User Name: dev

Password: dev

You should change these default values.

The aXes Projects Home Page should now be displayed, something like this:


Decide on a unique name for your aXes project.

Your chosen project name should be short and consist of only letters from the English alphabet and numbers. For example, MyProject1 or PaulProject2 would be good names. If existing projects are shown in the list on the right, use a name for your new project that is not already shown in the list.

Click on the Create a new Project … option.

The resulting display should look like this:


Note the warning about backing up your IFS project folders.

Enter a name and description for your project.

Then click the Create Project button.

A message like this should appear:


Close the Projects Home Page now.

While learning to use eXtensions is it common to have a private or personal project. However, when working on a real project you should create just a single project that all the developers on the project work within. Projects are discrete entities and cannot be merged.

You have completed this tutorial and are ready to start the next tutorial.