Summary of DDE Functions in a 16-Bit Environment

Summary of DDE Functions in a 16-Bit Environment lists the DDE functions that can be used with Personal Communications. The table lists the name of the DDE function, the command the client sends to Personal Communications, and the values that can be used for the variables in the client command.

Table 1. Summary of DDE Functions in a 16-Bit Environment

Function name Client command
Change Menu Item
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aCHANGEMENU) );
hData = Handle to a global memory object
Create Menu Item
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, 
             aCREATEMENU) );
cfFormat = CF_DSPTEXT
Find Field
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aFIELD) );
cfFormat = CF_DSPTEXT
Get Keystrokes
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aKEYS) );
cfFormat = CF_DSPTEXT
Get Mouse Input
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aMOUSE) );
cfFormat = CF_TEXT │ CF_DSPTEXT
Get Number of Close Requests
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aCLOSE) );
cfFormat = CF_DSPTEXT
Get Operator Information Area
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aOIA) );
cfFormat = CF_DSPTEXT
Get Partial Presentation Space
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aEPS) );
cfFormat = CF_TEXT │ CF_DSPTEXT
Get Presentation Space
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aPS) );
cfFormat = CF_TEXT │ CF_DSPTEXT
Get Session Status
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aSSTAT) );
cfFormat = CF_TEXT
Get System Configuration
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aSYSCON) );
cfFormat = CF_TEXT
Get System Formats
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aFORMATS) );
cfFormat = CF_TEXT
Get System Status
PostMessage( hServerWnd,
               WM_DDE_REQUEST,
               hClientWnd,
               MAKELONG(cfFormat, aSTATUS) );
cfFormat = CF_TEXT
Get System SysItems
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aSYSITEMS) );
cfFormat = CF_TEXT
Get System Topics
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aTOPICS) );
cfFormat = CF_TEXT
Get Trim Rectangle
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aTRIMRECT) );
cfFormat = CF_TEXT
Initiate Menu Conversation
PostMessage( hServerWnd,
             WM_DDE_INITIATE,
             hClientWnd,
             MAKELONG(aIBM327032, SN) );
N = a session letter A through Z
Initiate Session Conversation
SendMessage( -1,
             WM_DDE_INITIATE,
             hClientWnd,
             MAKELONG(aIBM327032, aSessionN) );
N = a session letter A through Z.
Initiate Structured Field Conversation
SendMessage( -1,
             WM_DDE_INITIATE,
             hClientWnd,
             MAKELONG(aIBM327032, aLUN_xxxx)
N = a session letter A through Z. xxxx = a user defined string.
Initiate System Conversation
SendMessage( -1,
             WM_DDE_INITIATE,
             hClientWnd,
             MAKELONG(aIBM327032, aSystem) );
Put Data to Presentation Space
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aEPS) );
hData = Handle to a global memory object
Search for String
PostMessage( hServerWnd,
             WM_DDE_REQUEST,
             hClientWnd,
             MAKELONG(cfFormat, aSTRING) );
cfFormat = CF_DSPTEXT
Send Keystrokes
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aKEYS) );
hData = Handle to a global memory object
Session Execute Macro
PostMessage( hServerWnd,
             WM_DDE_EXECUTE,
             hClientWnd,
             MAKELONG(NULL, hCommands) );
hCommands = Handle to a global memory object
Set Cursor Position
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aSETCURSOR) );
hData = Handle to a global memory object
Set Mouse Intercept Condition
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aMOUSE) );
hData = Handle to a global memory object
Set Presentation Space Service Condition
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aEPSCOND) );
hData = Handle to a global memory object
Set Session Advise Condition
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aPSCOND) );
hData = Handle to a global memory object
Set Structured Field Service Condition
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aSFCOND) );
hData = Handle to a global memory object
Start Close Intercept
SendMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aCLOSE) );
hOptions = Handle to a global memory object
Start Keystroke Intercept
SendMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aKEYS) );
hOptions = Handle to a global memory object
Start Menu Advise
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aSELECTMENU) );
hOptions = Handle to a global memory object
Start Mouse Input Intercept
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aMOUSE) );
hOptions = Handle to a global memory object
Start Read SF
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aSF) );
hOptions = Handle to a global memory object
Start Session Advise
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aItem) );
hOptions = Handle to a global memory object aItem = OIA │ PS │ TRIMRECT
Stop Close Intercept
PostMessage( hServerWnd,
             WM_DDE_UNADVISE,
             hClientWnd,
             MAKELONG(NULL, aCLOSE) );
Stop Keystroke Intercept
PostMessage( hServerWnd,
             WM_DDE_UNADVISE,
             hClientWnd,
             MAKELONG(NULL, aKEYS) );
Start Mouse Input Intercept
PostMessage( hServerWnd,
             WM_DDE_ADVISE,
             hClientWnd,
             MAKELONG(hOptions, aMOUSE) );
hOptions = Handle to a global memory object
Stop Menu Advise
PostMessage( hServerWnd,
             WM_DDE_UNADVISE,
             hClientWnd,
             MAKELONG(NULL, aSELECTMENU) );
Stop Read SF
PostMessage( hServerWnd,
             WM_DDE_UNADVISE,
             hClientWnd,
             MAKELONG(NULL, aSF) );
Stop Session Advise
PostMessage( hServerWnd,
             WM_DDE_UNADVISE,
             hClientWnd,
             MAKELONG(NULL, aItem) );
aItem = OIA │ PS │ TRIMRECT │ NULL
Terminate Session Conversation
SendMessage( hServerWnd,
             WM_DDE_TERMINATE,
             hClientWnd,
             MAKELONG(NULL, NULL) );
Terminate Menu Conversation
SendMessage( hServerWnd,
             WM_DDE_TERMINATE,
             hClientWnd,
             MAKELONG(NULL, NULL) );
Terminate Structured Field Conversation
SendMessage( hServerWnd,
             WM_DDE_TERMINATE,
             hClientWnd,
             MAKELONG(NULL, NULL) );
Terminate System Conversation
SendMessage( hServerWnd,
             WM_DDE_TERMINATE,
             hClientWnd,
             MAKELONG(NULL, NULL) );
Write SF
PostMessage( hServerWnd,
             WM_DDE_POKE,
             hClientWnd,
             MAKELONG(hData, aSF) );
hData = Handle to a global memory object