NGU-CLIENT-GET-DATA Subprogram

#### Search Results

Search

# NGU-CLIENT-GET-DATA Subprogram

This document covers the following topics:

- Natural Object Name

- Description

- Parameters

## Natural Object Name

NGUCLGDA

## Description

You must use this subprogram in the event handler of a DDE-client event to fill the DDE-VIEW parameter data area. You must then ensure that your event handler code acts on the value of DDE-VIEW.MESSAGE. The possible values of DDE-VIEW.MESSAGE are:

DISCONNECT | The server has terminated the conversation identified by DDE-VIEW.CONV-ID by unregistering the topic, or by exiting.
DATA | The server has sent data for DDE-VIEW.CONV-ID and DDE-VIEW.ITEM. The data are contained in DDE-VIEW.DATA. The length of the data will be contained in DDE-VIEW.DATALEN.
NOTIFY | The server has new data available for the conversation identified by DDE-VIEW.CONV-ID and DDE-VIEW.ITEM. The data are not sent at this point. You must request these data in your event handler. Only then the data will actually be received.
TIMEOUT | No server message has been received during the timeout period.

When DDE-VIEW.MESSAGE has the value DISCONNECT, DATA, or NOTIFY, the fields DDE-VIEW.SERVICE and DDE-VIEW.TOPIC are also set appropriately.

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

### On this page

- Natural Object Name
- Description
- Parameters