This document covers the following topics:
NGUCLCON
This subprogram requests a conversation with a server providing the service DDE-VIEW.SERVICE on the topic DDE-VIEW.TOPIC. If an appropriate server can be found, this starts a conversation identified by a unique conversation ID, which is returned to DDE-VIEW.CONV-ID. If not, this field is empty on return of the request. If you plan on having more than one conversation, store the value of DDE-VIEW.CONV-ID as you will need it to identify conversations.
Before you execute this subprogram, you must assign the *DIALOG-ID system variable of the client dialog to DDE-VIEW.CONV-ID. You must also assign the string "DLGID" to DDE-VIEW.MESSAGE.
| Name/Data Type | Explanation |
|---|---|
| 1 DDE-VIEW | Input/Output PDA for DDE subprograms. |
| 2 SERVICE (A20) | Service name. |
| 2 TOPIC (A20) | Topic name. |
| 2 CONV-ID (I4) | Conversation ID. |
| 2 MESSAGE (A20) | Message information. |
| 2 ITEM (A20) | Item of current conversation. |
| 2 FORMAT (A20) | Format of data to be sent. |
| 2 TIMEOUT (I4) | Time interval before the conversation is interrupted because there is no server message. |
| 2 DATALEN (I2) | Length of data. |
| 2 DATA-ARRAY (A1/1:V) | |
| 1 Max-Index (I2) | Input Highest index of DATA-ARRAY; can be set to any I2 value. |
| 1 Response (I4) | Output Natural error (if applicable). |