3 application

The network version makes it possible to split the DM applications in several parts.

In doing so, the capacity of the display machine can be better used and the server can be relieved from overload. In addition, any actions like for example creating graphics, querying external interfaces can be carried out via the display machine.

The object application for distributed applications contains information about the application, its functions, and the type of communication. Individual applications can be started and terminated.

Definition

{ export | reexport } application  { <Identifier> }
{
  <object-specific attributes>
}

Events

Children

Parent

none

3.1 Attributes

Attribute	RLD	PID	Properties	Short Description
.active	boolean	boolean	S,G/D/C	active state of an object
.certificatefile (since A.06.02.g)	string	string	S,G/D/C	defines the certificate file used for an SSL connection
.codepage	enum	enum	S,G/D/C	defines the code page used to call application functions
.connect	string	string	S,G/D/C	defines command line the application has been started with (IDMconnect)
.dialog	identifier	instance	-,G/-/-	dialog to which the object belongs
.document[integer]	object	document	S,G/-/-	accesses the I-th XML Document
.exec	string	string	S,G/D/C	defines command line the application has been started with (IDMexec)
.external	boolean	boolean	-,G/-/-	returns if the object class is an USW class
.external[integer]	class	class	-,G/-/-	returns the I-th registered USW class
.extevent	boolean	boolean	S,G/-/C	sends asynchronous events to client in network and MS Windows
.firstrecord	object	record	S,G/-/C	accesses the first record of an object
.index	integer index	integer index	-,G/-/-	current index of object in the child list of its parent
.label	string	string	S,G/D/C	name / identifier of the object
.lastrecord	object	record	S,G/-/C	accesses the last record of an object
.local	boolean	boolean	S,G/D/C	local application
options[enum]	boolean	boolean	S,G/D/C	options for an SSL connection opt_cert_required opt_no_ssl_v2 opt_verify_peer (since IDM version A.06.02.h)
.password (since A.06.02.g)	string	string	S,G/D/C	password for starting the application side with the RSH or SSH protocol
.privatekeyfile (since A.06.02.h)	string	string	S,G/D/C	file with the private key used for the SSH protocol
.publickeyfile (since A.06.02.h)	string	string	S,G/D/C	file with the public key used for the SSH protocol
.record[integer]	object	record	S,G/-/C	accesses the I-th record of an object
.recordcount	integer	integer	-,G/-/-	queries the number of child records
.toolhelp	string object	string text	S,G/D/C	gives a short explanation of object at the cursor
.transformer[integer]	object	transformer	S,G/-/-	accesses the I-th transformer of an object
.transport	string	string	S,G/D/C	defines transport mechanism
.username (since A.06.02.g)	string	string	S,G/D/C	user name for starting the application side with the RSH or SSH protocol

3.2 Specific Attributes

The object application has no display attributes. The following attributes are available:

.active

This attribute defines and queries whether the application is currently active. Changing this attribute from false to true has the effect that the application is started. The application is terminated when the attribute is set from true to false.
.connect

This attribute defines that the application connects to a running server process which has been started on the host (defined by the host name or IP address and the port number).
.exec

This attribute defines that the application starts a process given by the path on the host (defined by the host name or IP address). It contains the program name, path, host name, and miscellaneous information.
.label

Internal identifier of the application.
.local

Defines whether the application runs locally or on a network.
.transport

.transport defines the internal transport mechanism that the communication layer is to use. This is possible by the "tcpip" protocol.

The attributes .transport, .connect, .local and .exec can only be changed if .active is set to false.

The attributes .connect and .exec depend on the used transport mechanism, i.e. future versions of the transport layer may have different types of connection establishment.

If the "tcpip"-protocol is used, the syntax used for .connect is:

The "host"-parameter contains the host name, the "port" parameter contains the port number.

If the "tcpip" protocol is used, the syntax for .exec is:

The "host" parameter contains the host name on which the program is to be started.

The "username" parameter may contain a user name which exists on the host. The "password" parameter may contain the valid password of the user. These two parameters are optional.

The "path" parameter contains the path of the program to be started.

As of IDM version A.05.02.i, the Distributed Dialog Manager (DDM) supports the IPv6 protocol on all architectures that natively support IPv6.

3.3 Example

application TestAppl
{
  .active  false;
  .connect "localhost:4711";
 
  /* function definitions */
  function callback CheckFilename() for deselect, modified;

  function boolean  FillListbox(object,  string,
                                integer, integer,
                                string input output);

  function integer FillContinue(object, integer, integer,
                                string input output);

  function void  QueryListbox (object, string);
}