[DDEConnect Parameters]DDESend Contexts[/DDEConnect]

Connects to a DDE server program on the local machine. (New for 3.0)

To embed the results of a DDE command into one of your pages, put a DDEConnect context into a template, and put [DDESend] contexts inside of that. The DDESend steps contained inside the context are executed, and any returned value is displayed in place of the context. Any [xxx] tags inside the context are first substituted for their real values before the DDE is executed.

DDEConnect does nothing by itself; you must insert one or more [DDESend] contexts inside it to perform any real work. DDEConnect establishes a connection to the DDE server program, and provides an environment for the DDESend contexts to do their work and return text results.

Example (normally you would put the following text into a .TPL file on your server and use a web browser to link to it):

[DDEConnect program=PCAuthorize&topic=GetBatches]
[DDESend]Tela00001031 1[/DDESend]
[/DDEConnect]

In this example, the DDE command "GetBatches from PCAuthorize" is executed, and the results (a listing of all the batch information for batch #1) is displayed. Notice that the whitespace between "Tela00001031" and "1" is actually a tab character, which is part of the PCAuthorize specification.

Caution! DDE has complete access to all DDE-aware programs on your web server. You can write a DDE context that can do damage to the machine or retrieve secret information. Don't worry: remote visitors to your web site have no way of executing their own DDE contexts remotely; they can only execute DDE commands inside a template file that you have saved on your web server's hard disk.

Parameter	Description
program	(Required) Name of the DDE server program to connect to, such as PCAuthorize
topic	(Required) Name of the DDE topic on which to send messages, such as GetBatches. Defined by the DDE server program; refer to that program's documentation for more information.