Version 6.3.13 for Windows
 —  Dialog Component Reference  —

NGU-CLIENT-CONNECT Subprogram

This document covers the following topics:


Natural Object Name

NGUCLCON

Top of page

Description

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.

Top of page

Parameters

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).

Top of page