HP NonStop G-Series User Manual
Page 119
Tandem DDE Gateway Dictionary Structure
Extending the Tandem DDE Gateway
110838 Tandem Computers Incorporated
8–17
To enable this User Hook Library function, return the
TDMGW_HOOK_ENABLE_UMS_POST_REC constant from the
TdmgwHookEnableUserHooks function.
Prototype
BOOL FAR PASCAL TdmgwHookUmsPostReceiveMessage
(HWND hMainWnd,
in
LPSTR lpPortName,
in
char far * lpUmsMessageStartAddress,
in/out
unsigned int far * puUmsMessageLength,
in/out
BOOL far * pbIgnoreUmsMessage,
out
struct tagTdmgwErrorMsg far * pstructErrMsg)
out
Parameters
Return Value
Zero - Error.
Non-zero - No error.
(If zero is returned, the UMS message data will not
be sent to client applications.)
hMainWnd
Window handle of the Tandem DDE Gateway main
window.
lpUmsMessageStartAddress
Pointer to the UMS message, including MESSAGE-
VERSION, DDE-ITEM-NAME, and UMS-USER-
DATA. The message is stored in a buffer 31000
bytes long so you can add data.
puUmsMessageLength
Input - length of UMS message.
(UMS-USER-HEADER and UMS-USER-DATA.)
Output - revised length of UMS message.
pbIgnoreUmsMessage
Zero - send data to clients.
Non-Zero - Do not send data to clients.
pstructErrMsg
See “Returning Error Messages,” earlier in this
section.
Tandem DDE Gateway
Dictionary Structure
You create the Tandem DDE Gateway Dictionary by using the Bridge program on the
Tandem system. You sort the resulting file and download it to your workstation. This
file contains the definitions of your applications message structures in a simple format.
You can write workstation-based application development tools to read this file, for
example, to generate code for your client applications.
The Tandem DDE Gateway Dictionary is a stream of bytes divided into fixed length
records of two types, one header record and many element data records describing the
individual data element in message layouts. The dictionary is sorted in ascending
order by element name (szElement). There are no control characters or indexes.
(Searches by key on the dictionary by the Tandem DDE Gateway and Browser use a
binary-search algorithm.)