DDEINITIATE

Usage

TIBCO iProcess Workspace (Windows)

Warning: (iProcess only) This expression is not available to the TIBCO iProcess Script Server Plug-in. Therefore, even though you can successfully enter the expression in your iProcess Script plug-in definition, it will not be processed by the iProcess Engine. It will return SW_NA.

Initiates a DDE conversation with a DDE server.

Syntax

DDEINITIATE (fldresult, server, topic)

where:

• fldresult specifies the name of the iProcess field to contain the resulting channel number if successful; this must be a numeric field of at least 10 digits (no decimals required).
• server is a text string representing the DDE server to talk to.
• topic is a server-specific text string representing the topic for the conversation.

The topic or the server and topic may be null strings (""). In the case of a null topic, the first available topic specified by the server is used, and this may be determined with the DDEGETTOPIC command. In the case of a null server (as well as a null topic), the first available server responds, and its name may be determined with the DDEGETNAME command.

Returns

One of the following numeric values:

Value

Description

0

Success

1

Failure (no such server/topic

2

Failure (result field too small)

3

Failure (not iProcess Workspace (Windows))

Examples

TIBCO iProcess Modeler:

DDEINITIATE(excelch, "EXCEL", "FILE.XLS")
DDEINITIATE(excelch, "WINWORD", FILEFLD + ".DOC")

TIBCO Business Studio:

IPEDDEUtil.DDEINITIATE(excelch, "EXCEL", "FILE.XLS");
IPEDDEUtil.DDEINITIATE(excelch, "WINWORD", FILEFLD + ".DOC");