DDEREQUEST
Usage
TIBCO iProcess Workspace (Windows)
Send a request to a DDE server for an item of data.
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.
Syntax
DDEREQUEST (channel, item, flditem, format, timeout)
where:
| • | channel is a numeric value specifying the channel number of the conversation. |
| • | item is a server-specific text string representing the data item requested. |
| • | flditem is a text string specifying the iProcess fieldname reference to contain the returned string. |
| • | format is one of the following numeric values, specifying the formatting requirement for the returned string: |
|
Value |
String formatting |
|
0 |
All characters are to be placed into the iProcess field (flditem). |
|
1 |
Truncate the string at first non-printing or non-ASCII character. |
| • | timeout is a numeric value specifying the number of seconds to wait for a response. |
Returns
One of the following numeric values:
|
Value |
Description |
|
0 |
Success |
|
1 |
Not processed (bad item or server does not handle REQUEST) |
|
2 |
Timeout - server busy |
|
3 |
Bad channel |
|
4 |
Unknown error from server |
Examples
TIBCO iProcess Modeler:
DDEREQUEST (mychan, "DATA5", strfield, 0, 5)
TIBCO Business Studio:
IPEDDEUtil.DDEREQUEST(mychan, "DATA5", strfield, 0, 5);