wguidspy.gml

开放源码的编译器open watcom 1.6.0版的源代码

A conversation is the connection established between two applications
that is necessary to perform DDE operations. When the Conversations
item is checked, &dde makes an entry in the event list each time a
conversation is established or terminated.
.point Links
A link is a relationship between two DDE applications: a server and a
client. A link is established for a single value maintained by the
server. When this value changes the server notifies the client. When
the Links item is checked, &dde logs notifications in the event list
each time a link is established or terminated.
.endpoint
.*
.beglevel
.*
.section Setting the Message Filter
.*
.np
.ix 'Set Message Filter'
.ix 'Message Filter' 'set'
.ix '&dde' 'set message filter'
The Set Message Filter item opens the Message Filter dialog which
lists the various DDE messages that can be posted or sent. This
dialog allows you to select the specific messages you want &dde to
write to the event list.
.keep 16
.figure *depth='2.22' *scale=75 *file='DDE5' In the Set Message Filter dialog, select the messages on which you want &dde to report.
.np
Select the messages that you want &dde to report on when posted or
sent. A message is activated when its check box contains a check.
.begbull $compact
.bull
Use the Set All button in this dialog to activate all of the messages.
.bull
Use the Clear All button in this dialog to deactivate all of the
messages.
.endbull
.np
Click on OK when the desired messages are activated.
.*
.section Setting the Callback Filter
.*
.np
.ix 'Callback Filter' 'set'
.ix '&dde' 'set Callback Filter'
The Set Callback Filter menu item opens the Callback Filter dialog
which lists the various types of transactions for which a DDE
callback function may be called. This dialog allows you to specify
the transaction types you want &dde to report in the event list.
.keep 19
.figure *depth='2.48' *scale=68 *file='DDE6' In the Set Callback Filter dialog, select the transaction types on which you want &dde to report.
.np
Select the transaction types on which you want &dde to report. A
transaction type will be reported on when its check box contains a
check.
.begbull $compact
.bull
Use the Set All button in this dialog to activate all of the
transaction types.
.bull
Use the Clear All button in this dialog to deactivate all of the
transaction types.
.endbull
.np
Click on OK when the desired transaction types are activated.
.*
.endlevel
.*
.im wguilog &dde
.*
.section Tracking with &dde
.*
.np
In the process of DDE interactions programs register and unregister
several types of DDE objects such as:
.begbull $compact
.bull
.ix '&dde' 'track strings'
Strings
.bull
.ix '&dde' 'track conversations'
Conversations
.bull
.ix '&dde' 'track links'
Links
.bull
.ix '&dde' 'track servers'
Servers
.endbull
.np
The tracking windows offer you an easy way to determine at any time
which objects are currently registered with the system.
.np
To open a tracking window choose Strings, Conversations, Links or
Servers from the Track menu. This opens a tracking window that
displays all the objects of the selected type that have been
registered but not unregistered since &dde started. The tracking
windows are automatically updated whenever an event occurs that
changes the displayed information.
.np
Each tracking window lists its information in tabular form under
several headings. You can sort the displayed information based on any
column by clicking on the column heading for that column.
.*
.beglevel
.*
.section Tracking Strings
.*
.np
.ix 'Strings' 'track in &dde'
.ix '&dde' 'track strings'
Choose Strings from the Track menu to open a Strings window which
tracks all strings currently registered with the operating system. As
strings are destroyed, &dde removes them from the list.
.keep 15
.figure *depth='2.1' *scale=90 *file='DDE9' The Strings window tracks all strings currently registered with the operating system.
.np
The information in this window is:
.begpoint $break
.point Handle
The unique numeric identifier for the string
.point Count
The current usage count of the string.  A string is deleted when its
usage count is zero.
.point String
The text of the registered string
.endpoint
.*
.section Tracking Conversations
.*
.np
.ix 'Conversations' 'tracking'
.ix '&dde' 'track conversations'
Choose Conversations from the Track menu to open a Conversations
window which tracks all conversations currently active in the system.
.keep 12
.figure *depth='1.46' *scale=91 *file='DDE10' The Conversations window tracks all conversations currently active in the system.
.np
The information in this window is:
.begpoint $break
.point Client
The unique numeric identifier for the client
.point Server
The unique numeric identifier for the server
.point Service
The service name specified when the conversation was established
.point Topic
The topic specified by the client when the conversation was established
.endpoint
.*
.section Tracking Links
.*
.np
.ix 'Links' 'tracking'
.ix '&dde' 'track links'
Choose Links from the Track menu to open a Links window which tracks
all links currently active in the system.
.keep 9
.figure *depth='1.09' *scale=68 *file='DDE11' The Links window tracks all links currently active in the system.
.np
The information in this window is:
.begpoint $break
.point Client
The unique numeric identifier for the client
.point Server
The unique numeric identifier for the server
.point Type
A value indicating if the link is Hot or Warm. When a link is
established between a client and server, the server notifies the
client whenever the value of the item changes. When the link type is
Warm, the only information sent to the client is notification that the
value of the item has changed. When the link type is Hot, then the
notification that the value has changed is sent to the client as well
as the new value of the item.
.point Service
The service name specified when the conversation on which this link
exists was established
.point Topic
The topic specified by the client when the conversation was
established.
.point Item
The name of the item for which the link is established.
.point Format
The format of the information that is being communicated between
applications.
.endpoint
.*
.section Tracking Servers
.*
.np
.ix 'Servers' 'tracking'
.ix '&dde' 'track servers'
Choose Servers from the Track menu to open a Servers window which
tracks all servers currently registered with the operating system.
.keep 12
.figure *depth='1.46' *scale=92 *file='DDE12' The Servers window tracks all servers currently registered with the operating system.
.np
The information in this dialog is:
.begpoint $break
.point Server Name
The name of each server that is registered with the operating system.
This name is generally descriptive of the type of server.
.point Instance Name
The server name with a numeric identifier added by the operating
system. This name uniquely identifies the server in the system.
.endpoint
.*
.endlevel
.*
.section Working with Aliases
.*
.np
.ix 'Aliases' 'in &dde'
.ix '&dde' 'Aliases in'
The event list displays an overwhelming array of numeric identifiers.
The alias functions allow you to replace these numeric identifiers
with meaningful text.  This makes the event list easier for
you to understand. For example, if you are monitoring a server
application and you know it's task id is 0x1234 then you can replace
every occurrence of that task id with the text "server".
.*
.beglevel
.*
.section Defining Aliases
.*
.np
Using the alias functions you can define aliases for window handles,
task id's and conversation id's.
.begstep
.step Choose Add hwnd alias, Add task alias or Add conversation alias
from the Alias menu
.orstep Click on the appropriate icon on the toolbar.
.result
This opens the appropriate Add Alias dialog. The dialog contains a
list box that lists all identifiers of the chosen type that &dde
has encountered.
.keep 28
.figure *depth='3.45' *scale=79 *file='DDE13' In the Add Alias dialog box, you replace the selected window handle, task, or conversation id with descriptive text.
.step Click once on the window handle, task, or conversation
for which you want to add an alias
.orstep Enter a numeric value in the Value field.
.step Position the cursor in the Current Text field.
.step Enter the text
with which you want to replace this numeric identifier.
.step Click on OK
to register the alias and close the dialog
.orstep Select the Do More button
to register the alias and leave the dialog open.
.result
This allows you to create aliases for more numeric identifiers.
.endstep
.*
.section Disabling Aliases
.*
.np
Choosing Disable Aliases from the Aliases menu changes all aliased
values back to their original numeric identifiers. The Disable Aliases
menu item is checked when this option is active. Choosing the menu
item again disables it. Numeric identifiers are then replaced by their
text aliases again.
.*
.section Purging Aliases
.*
.np
Choosing Purge Aliases from the Aliases menu deletes all aliases set
up in &dde.. Any values replaced by aliases will revert to their
original numeric values.
.*
.endlevel