startApplication

startApplication(schemaName: String;
                 appName:    String): Process;

The startApplication method of the Application class enables your logic to initiate an application in the same Jade database as the initiating application.

The parameters for the startApplication method are listed in the following table.

Parameter Description
schemaName Specifies the name of the schema in which the application is located
appName Specifies the name of the application to start

If invoked on the server node from a server method or server application, this method can be used only to start a non‑GUI application. An exception is raised if the application type is not ApplicationType_Non_GUI_Web, ApplicationType_Non_GUI_Rest, or ApplicationType_Non_GUI. On a client node, this method starts all types of application. For details about running non‑GUI applications in standard (or fat client) mode, see the Application class applicationType property.

You can use the MaxWaitAppStart parameter in the [JadeClient] or [JadeServer] section of the Jade initialization file to increase the time that Jade waits for a GUI or GUI, No Forms application to initiate before raising an exception. When your system has a large number of applications to start, the default value of 45 seconds may not be sufficient for the loading on the machine during startup. For details, see your Jade Initialization File Reference.

An application is terminated when all forms of that application are closed. A client node is terminated when all applications running on that node terminate. Application and database server nodes must be terminated by the user or service.

This method returns the Process instance of the application that was started. The application that calls this method continues executing after Jade has successfully created a new process. If the application is not initiated (for example, because of EnableAppRestrictions security restrictions) an exception is raised in the application requesting the initiation.

The types of application that you can start by using the startApplication method on client nodes or server nodes are listed in the following table, which also lists their termination behavior.

Start-up Location GUI Non_GUI and Non_GUI_Web GUI_No_Forms
Client nodes Stays while application has forms Always stays running Always stays running
  Executes finalize method Executes finalize method Executes finalize method
Server nodes Not available Always stays running Not available
    Executes finalize method  

In this table: