home *** CD-ROM | disk | FTP | other *** search
/ Windows Shareware GOLD / NuclearComputingVol3No1.cdr / other / f1205 / ddewatch.prn < prev    next >
Encoding:
Text File  |  1990-09-17  |  10.0 KB  |  238 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                    DDEWatch 1.3
  9.  
  10.  
  11.                                Horizon Technologies Inc.
  12.  
  13.             Overview:            Overview:            Overview:
  14.  
  15.                DDEWatch is a Microsoft Windows program designed to monitor
  16.                Dynamic Data Exchange (DDE) messages.  It is a useful tool
  17.                to aid in the development of DDE based applications.  'C'
  18.                language programmers, Excel macro developers and others can
  19.                use DDEWatch as both a debugging tool and a way to learn
  20.                DDE.
  21.  
  22.                DDEWatch displays each DDE message as it occurs.  The
  23.                information displayed contains the window handles of both
  24.                the sender and receiver, the message type and any additional
  25.                parameters.  These parameters include keyword
  26.                representations of flag fields, command strings, data
  27.                format, and data strings.  DDEWatch displays each new DDE
  28.                message below the previous one.  When the screen is full,
  29.                the next message replaces the first.  A line separates the
  30.                first and last messages captured.
  31.  
  32.                DDEWatch also displays a list of the client-server window
  33.                handles of all active DDE sessions.  DDEWatch maintains this
  34.                list to reflect every new DDE session detected.  When a DDE
  35.                session ends, DDEWatch removes the client-server window
  36.                handles from the list.
  37.  
  38.             The DDEWatch Display:            The DDEWatch Display:            The DDEWatch Display:
  39.  
  40.                Once DDEWatch is invoked, it displays all DDE message
  41.                traffic in real time.  The DDEWatch display is divided
  42.                vertically into two sections.
  43.  
  44.                The left section of the display shows a list of active DDE
  45.                sessions.  The hexadecimal numbers are the client and server
  46.                window handles.  The following figure shows two active
  47.                sessions:  Client "630c" communicating with Server "2f30",
  48.                and Client "5f10" communicating with the same server.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.           DDEWatch - Copyright (C) September 17, 1990 Horizon Technologies
  60.           Inc.  All rights reserved.  (517) 347-0800                 Page 1
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.     ---------------------------------------------------------------------
  73.     | - |                         DDEWatch                    | \/ | /\ |
  74.     ---------------------------------------------------------------------
  75.     | File                                    |
  76.     ---------------------------------------------------------------------
  77.     | Client Server |630c<-2f30 Data    Advise AckReq Release Fmt=Te|
  78.     |---------------|5f10->2f30 Request    Fmt=Text|Position        |
  79.     |* 630c   2f30  |5f10<-2f30 Data    Response AckReq Release Fmt=|
  80.     |* 5f10   2f30  |5f10->2f30 Ack        App=00|Position            |
  81.     |        |5f10->2f30 Execute    "[l][d]"            |
  82.     |        |5f10<-2f30 Ack        App=00|"[l][d]"            |
  83.     |        |630c->2f30 Ack        App=00|0            |
  84.     ---------------------------------------------------------------------
  85.     |<-| |||                             |->|
  86.     ---------------------------------------------------------------------
  87.  
  88.                The asterisk to the left of the client numbers indicates
  89.                that DDEWatch is displaying messages for that session.  To
  90.                suppress the display for a particular session, position the
  91.                mouse pointer over the client-server pair and click the left
  92.                mouse button.  To resume the display, repeat the procedure.
  93.  
  94.                To temporarily suppress the display of messages for all
  95.                sessions, position the mouse pointer over the right section
  96.                of the DDEWatch display and hold the left mouse button down.
  97.                To resume, release the button.
  98.  
  99.                The right section of the DDEWatch display shows detailed
  100.                information about each DDE message.  The client's window
  101.                handle is always to the left of the server's.  The arrow
  102.                shows the direction of the message.  A left arrow (<-)
  103.                indicates a message from the server to the client.  A right
  104.                arrow (->) indicates a message from the client to the
  105.                server.
  106.  
  107.                The type of message and its parameters are shown immediately
  108.                to the right of the window handles.  The parameters are
  109.                dependant on the type of message and are listed in the
  110.                following table:
  111.  
  112.      Message Type      Parameters
  113.     ------------------------------------------------------------------------
  114.     |Initiate    | Application Name
  115.     |        | (vertical bar)
  116.     |        | Topic Name
  117.  
  118.           DDEWatch - Copyright (C) September 17, 1990 Horizon Technologies
  119.           Inc.  All rights reserved.  (517) 347-0800                 Page 2
  120.  
  121.  
  122.  
  123.  
  124.  
  125.     |---------------+-------------------------------------------------------
  126.     |Terminate    | (nothing)
  127.     |---------------+-------------------------------------------------------
  128.     |Advise        | AckReq (iff the fAckReq bit is set)
  129.     |        | DeferUpd (iff the fDeferUpd bit is set)
  130.     |        | Fmt=format name*
  131.     |        | (vertical bar)
  132.     |        | Item Name
  133.     |---------------+-------------------------------------------------------
  134.     |Unadvise    | Item Name
  135.     |---------------+-------------------------------------------------------
  136.     |Ack (Initiate)    | Application Name
  137.     |        | (vertical bar)
  138.     |        | Topic Name
  139.     |---------------+-------------------------------------------------------
  140.     |Ack (Execute)    | Negative (iff fAck is not set)
  141.     |        | (Busy) (iff fBusy is set)
  142.     |        | App=xx (where xx is the hex value of bAppReturnCode)
  143.     |        | (vertical bar)
  144.     |        | "Command string"
  145.     |---------------+-------------------------------------------------------
  146.     |Ack (Other)    | Negative (iff fAck is not set)
  147.     |        | (Busy) (iff fBusy is set)
  148.     |        | App=xx (where xx is the hex value of bAppReturnCode)
  149.     |        | (vertical bar)
  150.     |        | Item Name
  151.     |---------------+-------------------------------------------------------
  152.     |Data        | Response (iff fResponse is set)
  153.     |        | Advise (iff fResponse is not set)
  154.     |        | AckReq (iff fAckReq is set)
  155.     |        | Release (iff fRelease is set)
  156.     |        | Fmt=format name*
  157.     |        | "Data" (iff the format of the data is text)
  158.     |        | (vertical bar)
  159.     |        | Item Name
  160.     |---------------+-------------------------------------------------------
  161.     |Request    | Fmt=format name*
  162.     |        | (vertical bar)
  163.     |        | Item Name
  164.     |---------------+-------------------------------------------------------
  165.     |Poke        | Release (iff fRelease is set)
  166.     |        | Fmt=format name*
  167.     |        | "Data" (iff the format of the data is text)
  168.     |        | (vertical bar)
  169.     |        | Item Name
  170.     |---------------+-------------------------------------------------------
  171.     |Execute    | "Command string"
  172.     ------------------------------------------------------------------------
  173.             * The standard format names that are displayed for the
  174.               DDE messages Advise, Data, Request and Poke are Text,
  175.               BitMap, MetaFile, Sylk, Dif, Tiff and OemText
  176.  
  177.           DDEWatch - Copyright (C) September 17, 1990 Horizon Technologies
  178.           Inc.  All rights reserved.  (517) 347-0800                 Page 3
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.             The DDEWatch Menu:            The DDEWatch Menu:            The DDEWatch Menu:
  186.  
  187.                Monitoring DDE messages degrades system performance
  188.                considerably.  It may, therefore, be desirable to disable
  189.                DDEWatch temporarily.  This can be accomplished by selecting
  190.                _____               Watch from the ____                              File menu.  This will also remove the
  191.                checkmark next to the _____                                     Watch menu item to indicate that
  192.                monitoring has been disabled.  To resume, repeat the
  193.                procedure.
  194.  
  195.                All output from DDEWatch may be captured in an ASCII text
  196.                file.  This can be accomplished by selecting ___                                                            Log from the
  197.                ____               File menu.  This will also place a checkmark next to the ___                                                                        Log
  198.                menu item to indicate that file logging has been activated.
  199.                By default, the output will be appended to the file
  200.                ____________               DDEWATCH.LOG in the current directory.  To suspend file
  201.                logging, repeat the procedure.
  202.  
  203.             The DDEWatch Section in Win.Ini:            The DDEWatch Section in Win.Ini:            The DDEWatch Section in Win.Ini:
  204.  
  205.                DDEWatch supports the following entries in Win.Ini under the
  206.                [DDEWATCH] section.
  207.  
  208.                Watch= Sets the initial mode for monitoring DDE messages.
  209.                       1 (the default) indicates that monitoring will begin
  210.                       upon program invocation.  0 indicates that
  211.                       monitoring will be initially disabled.
  212.  
  213.                Log=   Sets the initial mode for file logging of DDE
  214.                       messages.  0 (the default) indicates that file
  215.                       logging will be inactive upon program invocation.  1
  216.                       indicates that file logging will be initially
  217.                       active.
  218.  
  219.                LogFile=  Sets the DOS file name for DDE message logging to
  220.                       something other than the default ____________                                                       DDEWATCH.LOG.
  221.  
  222.                Example:
  223.                     [DDEWatch]
  224.                     Watch=0
  225.                     Log=0
  226.                     LogFile=ExcelDDE.log
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.           DDEWatch - Copyright (C) September 17, 1990 Horizon Technologies
  237.           Inc.  All rights reserved.  (517) 347-0800                 Page 4
  238.