Version 9.7
 —  Getting Started  —

Creating a New Application

An application is a project which can contain an internal system within an organization, such as human resources, billing, customer services etc. In this task, you will create a new ApplinX application. Every ApplinX application is connected to a host and has a repository containing all the ApplinX entities. The steps detailed in this task include the basic steps required to create an application. Advanced configuration is explained in Application Configuration Parameters in the Reference Guide.

Start of instruction setTo create an ApplinX application

Before creating a new application, ensure that ApplinX server is available and running, and start the Designer. Log in to the relevant server or add an additional server as required (refer to the sections Logging on and Adding a New Server Connection.

  1. In the ApplinX Explorer, right-click on the ApplinX server and select New Application... .

    Or:
    Select the menu item File > New > Other.... In the resulting window, expand the Software AG node, then the ApplinX node, select Application, and then click Next.

    The Create a New Application wizard is displayed.

    graphics/newappwizard1.png

  2. Enter a name for the application and a suitable description.

  3. Select the initialization mode:

    Automatic

    Automatically loaded when the server is started.

    When first accessed

    Loaded when first accessed, in other words, when the code that initializes startup is first called (default).

  4. Click Next.

    graphics/newappwizard2host.png

    Select whether to use an existing host or to create a new host.

    Note:
    SAG_MainFrame is accessible only from within the Software AG network. Therefore, this host can only be selected when working offline using a trace file.

  5. When selecting to define a new host, enter a name for the host and select the relevant type of host. Click Next.

    graphics/newappwizard3host.png

    The host connection and conversion parameters are displayed. It is mandatory to enter the host's name/IP address (IPv4 and IPv6 address formats are supported). Configure the other parameters as required. Further details of these parameters are available in Host Configuration Parameters in the Reference Guide.

  6. Click Next to create and configure a rvbepository for your application.

    graphics/newappwizard4db.png

    Select the repository type. The ApplinX repository is used to hold ApplinX entities such as the Screens, Paths, Services, Programs and Procedures. It is recommended to use the Internal DB, as this repository's performance is optimized. The ApplinX repository database can be any JDBC/ODBC compliant database such as Apache Derby, Oracle, SQL server, Adabas, DB2 or Microsoft Access.

    Select whether to import predefined transformations. ApplinX predefined built-in transformations provide you a basic kit of commonly used transformations. Once you have imported the transformations, they will appear in the list of transformation entities in the repository and they are ready to either be used as-is or to be further edited and customized to suit your exact needs.

    If you selected to work with Internal DB, click Finish.

    Otherwise click Next to configure the repository parameters.

    graphics/newappwizard5db.png

  7. Click Finish. The application is displayed in the ApplinX Explorer. It is possible to further configure the application properties by right-clicking on the application name and selecting Properties. Refer to Application Configuration Parameters in the Reference Guide for details regarding the advanced configuration properties.

Confirming Connectivity

Start of instruction setTo confirm connectivity to the host

  1. In the ApplinX Explorer, expand the relevant application node.

  2. Expand the Sessions node. Right-click on Default and select Connect. The first host screen is displayed and the icon of the default session changes to graphics/emu_session_connected.gif. Navigate between the screens to confirm connection and host functionality. If there is a connection problem, check that the host is working and that the host definitions are correct.

Further information regarding application configuration can be found in Defining Applications in the Designing and Developing an Application documentation.

Top of page