NetDDE PDF

Wonderware FactorySuite NetDDE for the Microsoft Windows Operating System
Users Guide
Revision B July, 1999
Wonderware Corporation
All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of the Wonderware Corporation. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Wonderware Corporation. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements. 1998 Wonderware Corporation. All Rights Reserved. 100 Technology Drive Irvine, CA 92618 U.S.A. (949) 727-3200 http://www.wonderware.com Trademarks All terms mentioned in this book that are known to be trademarks or service marks have been appropriately capitalized. Wonderware Corporation cannot attest to the accuracy of this information. Use of a term in this book should not be regarded as affecting the validity of any trademark or service mark. Wonderware, InTouch and FactorySuite Web Server are registered trademarks of Wonderware Corporation. FactorySuite, Wonderware FactorySuite, WindowMaker, WindowViewer, SQL Access Manager, Recipe Manager, SPCPro, DBDump, DBLoad, HDMerge, HistData, Wonderware Logger, Alarm Logger, InControl, InTrack, InBatch, IndustrialSQL, FactoryOffice, FactoryFocus, License Viewer, Scout, SuiteLink and NetDDE are trademarks of Wonderware Corporation.
Contents
Chapter 1 - Introduction...................................... 1-1

About NetDDE......................................................................................................1-2 What is DDE? ................................................................................................1-2 What is NetDDE? ..........................................................................................1-3 NetDDE in the Windows 3.1 Environment ...........................................................1-4 NetDDE in the WFW and Win95/98 Environments .............................................1-5 NetDDE Connectivity with Windows NT.............................................................1-6 NetDDE Connectivity with VMS..........................................................................1-7 NetDDE Connectivity with UNIX ........................................................................1-8 NetDDE Connectivity with Macintosh..................................................................1-9
Chapter 2 - Installation Considerations............. 2-1

Installing NetDDE for Windows...........................................................................2-2 General Installation Requirements ........................................................................2-3 Avoiding Adapter Memory Conflicts with Windows.....................................2-3 Avoiding Adapter Memory Conflicts with DOS............................................2-3 Installation Requirements for NetBIOS ................................................................2-4 Installation Requirements for Serial......................................................................2-5 Loading the Serial TSRs ................................................................................2-5 WWCOMTSR Configuration Options...........................................................2-6 Custom Hardware Settings....................................................................................2-8 Compatibility with Serial I/O Servers............................................................2-8 Assigning I/O Addresses to Communication Ports ........................................2-9 Installation Requirements for WinSock ..............................................................2-12 DECnet from PATHWORKS 4.X ...............................................................2-12 DECnet from PATHWORKS 5.X ...............................................................2-14 Installing PATHWORKS for Windows 95/98 .............................................2-16
Chapter 3 - Starting NetDDE............................... 3-1

Introduction...........................................................................................................3-2 Starting in Windows 3.1 and Windows 95/98.......................................................3-3 Defining a Local Node Name................................................................................3-4 Selecting Network Interfaces ................................................................................3-5 Viewing Version Information................................................................................3-7 Closing NetDDE ...................................................................................................3-8
Chapter 4 - Customizing NetDDE Setup ............ 4-1

Modifying the Local Node Name..........................................................................4-2 Configuring Network Interfaces............................................................................4-3 Configuring Preferences........................................................................................4-5 Setting Up Network Routes...................................................................................4-7 Adding a New Route......................................................................................4-9 Modifying a Route .......................................................................................4-10 Deleting a Route ..........................................................................................4-10 Mapping Node Connections................................................................................4-11 Adding a Logical Node Name......................................................................4-12 Modifying a Logical Node Name.................................................................4-14 Deleting a Logical Node Name....................................................................4-14
ii
Table of Contents
Chapter 5 - DDE Share Security......................... 5-1

Introduction...........................................................................................................5-2 DDE Shares ...................................................................................................5-2 DDE Share Permission Levels.......................................................................5-3 Default DDE Share Security ..........................................................................5-4 DDE Shares for the Windows for Workgroups and Windows 95/98 Operating Systems..........................................................................................................5-4 Defining Default DDE Share Security ..................................................................5-5 Customized DDE Shares.......................................................................................5-7 Connecting to a Secured Windows NT Application ...........................................5-11 Connecting to a Secured WFW or Win95/98 Application ..................................5-13
Chapter 6 - Additional Serial Interface Parameters .............................................................................. 6-1

Introduction...........................................................................................................6-2 Configuring Ports..................................................................................................6-3 Configuring Modem Details ..........................................................................6-5 Modem Initialization String Sequences .........................................................6-6 Defining Connection Information .........................................................................6-7 Adding a Serial Link......................................................................................6-8 Modifying a Serial Link.................................................................................6-9 Deleting a Serial Link ....................................................................................6-9 Viewing Port Status ............................................................................................6-10 Port Status for Direct Connect Ports ............................................................6-13
Chapter 7 - NetDDE Status and Statistics Display .............................................................................. 7-1

Introduction...........................................................................................................7-2 Viewing Status and Statistics Information ............................................................7-3 Viewing Network Interfaces ..........................................................................7-4 Viewing Connections.....................................................................................7-5 Viewing Routes..............................................................................................7-6 Viewing Hops ................................................................................................7-7 Viewing Conversations..................................................................................7-8 Viewing DDE Routes ....................................................................................7-9 Viewing Statistics ........................................................................................7-10 Showing the Wonderware Logger................................................................7-11 Configuring Child Windows ...............................................................................7-12 Tiling ...........................................................................................................7-12 Cascading.....................................................................................................7-13 Tiling Horizontally ......................................................................................7-13 Arranging Icons ...........................................................................................7-14 Adding a Horizontal Scroll Bar ...................................................................7-15 Changing the Display Font...........................................................................7-16 Determining Open Child Windows..............................................................7-16
Chapter 8 - NetDDE Test and Debug Commands .............................................................................. 8-1

Introduction...........................................................................................................8-2 Testing an Open Connection.................................................................................8-3
Table of Contents
iii
Closing an Open Connection.................................................................................8-5 Enabling Debug Menu Commands........................................................................8-6 Control Menu Debug Commands...................................................................8-7 Configuring Additional Interface Parameters......................................................8-11 Dialog Box Options for Additional Parameters ...........................................8-11 Additional NetBIOS Configuration Parameters...........................................8-16 Additional Serial Configuration Parameters ................................................8-17 Additional WinSock Configuration Parameters...........................................8-18 Additional DECnet Configuration Parameters.............................................8-19
Appendix A - WW Logger Messages .................A-1

NetDDE Messages ...............................................................................................A-2 Security Messages..............................................................................................A-11 NetBIOS Messages ............................................................................................A-13 Serial Messages..................................................................................................A-16 WWCOMTSR Messages ...................................................................................A-18 SDDETSR Messages .........................................................................................A-20 WinSock Messages ............................................................................................A-22 DECnet Messages ..............................................................................................A-28
Appendix B - DDEView .......................................B-1

Introduction to DDEView .................................................................................... B-2 Starting DDEView ............................................................................................... B-3 Refreshing the Spreadsheet .................................................................................. B-4 Configuring the Focus.......................................................................................... B-5 Selecting a Focus .......................................................................................... B-6 Adding a Focus Entry ................................................................................... B-7 Deleting a Focus Entry.................................................................................. B-7 Retrieving Data .................................................................................................... B-8 Inserting a Tagname...................................................................................... B-8 Retrieving Current Data .............................................................................. B-10 Retrieving an Array..................................................................................... B-13 Sending Data............................................................................................... B-14 Retrieving Historical Data .......................................................................... B-15 Monitoring Tag Values ............................................................................... B-18 Retrieving Current SPC Data ...................................................................... B-20 Retrieving Selected SPC Data..................................................................... B-21
Appendix C - Special Topics ..............................C-1

Reserving Onboard Memory................................................................................ C-2 Cable Diagrams.................................................................................................... C-3 Modems Tested with NetDDE ............................................................................. C-4 Setting Up a DDE Conversation from Microsoft Excel ....................................... C-5 NetDDE Application Notes.................................................................................. C-8
Index..................................................................... I-1
1-1
C H A P T E R
Introduction
This chapter introduces you to NetDDE and explains how NetDDE is used in the Windows, Windows for Workgroups (WFW), Windows 95 (Win95) and Windows 98 (Win98) environments. The connectivity information for other platforms is also included in this chapter.
Contents n About NetDDE n NetDDE in the Windows 3.1 Environment n NetDDE in the WFW and Win95/98 Environments n NetDDE Connectivity with Windows NT n NetDDE Connectivity with VMS n NetDDE Connectivity with UNIX n NetDDE Connectivity with Macintosh
1-2
Chapter 1
About NetDDE
If you are a new NetDDE for Windows user, we recommend that you read this entire chapter to familiarize yourself with NetDDE for Windows and its role in providing DDE connectivity between various operating environments.
What is DDE?
DDE is the acronym for Dynamic Data Exchange. DDE is a communication protocol designed by Microsoft to allow applications in the Windows environment to send/receive data and instructions to/from each other. It implements a clientserver relationship between two concurrently running applications. The server application provides the data and accepts requests from any other application interested in its data. Requesting applications are called clients. DDE is often used to gather and distribute "live" data such as production measurements from a factory floor, scientific instrument readings, or stock price quotations. Client applications can use DDE for one-time data transfers or for ongoing data exchanges in which updates are sent as soon as new information is available. DDE can be used to dispatch control instructions to process-connected instruments. For example, in a factory automation system, DDE client applications may send control temperature set points to ovens. DDE compliance is a standard feature for Windows applications needing data links to other applications. For example, DDE-compliant applications include, Microsoft Excel, Lotus 1-2-3 for Windows, InTouch, and others. Network extensions are available to allow DDE links between applications running on different computers connected via networks or modems. For example, NetDDE supports DDE between applications running on IBM PCs connected via LAN or modem and DDE-aware applications running on non-PC based platforms under operating environments such as VMS and UNIX. To obtain data from another application, the client program opens a channel to the server application by specifying two things: the servers application name and the topic name of interest. Once a channel is open, items in the topic can be read or written. For example, in the case of Excel, the application name is "Excel." The topic name is the name of the spreadsheet that contains the data. The item name is the specific cell on the spreadsheet containing the data. With InTouch, the application name is "View." When reading or writing a tagname in the InTouch database, the topic name is always the word "Tagname." The item name is the actual tagname defined in the InTouch database.
Introduction
1-3
When a client application sets up a link to another DDE program, it asks the server application to advise the client whenever a specific items value changes. These data links remain active until either the client or server terminates the link or the conversation. This is an efficient means of exchanging data because once the link has been established no communication occurs until the specified item changes. InTouch uses DDE to communicate with I/O device drivers and other DDE application programs.
What is NetDDE?
NetDDE for Windows extends the standard Windows DDE (Dynamic Data Exchange) functionality to include communication over local area networks and through serial ports. To use NetDDE, two or more IBM compatible PCs running Windows (3.1 or later), Windows for Workgroups (3.1 or later), or Windows 95/98 are required. NetDDE must be installed on all network nodes between which DDE data is to be exchanged. The services provided by NetDDE are independent of other available network services such as file sharing, E-mail, terminal emulation, database query, etc. NetDDE does not require a file server to function, but it can be installed to and loaded from a file server if desired. The diagram below illustrates a feasible network configuration utilizing the family of NetDDE products to provide DDE connectivity between applications running on different platforms and operating systems:
DEC VAX NetDDE for VMS
DEC Alpha AXP NetDDE for VMS
Windows 3.1 PC NetDDE for Windows

Modem
DECnet
Modem
UNIX Workstation NetDDE for UNIX
Macintosh NetDDE for MacIntosh
WFW PC NetDDE for Windows
Windows/NT PC NetDDE for NT
TCP/IP
NetBIOS
1-4
Chapter 1
NetDDE in the Windows 3.1 Environment

Microsoft Windows 3.1 does not include built-in networking support. To use NetDDE for Windows in this environment, you must first purchase and install a third-party networking software package. The networking software chosen for installation on the local node will depend on what other PCs and workstations you intend to connect to with NetDDE. If the primary objective is to connect to other PCs running Windows 3.1 (or later), Windows for Workgroups (3.1 or later), Windows 95/98 or Windows NT, networking software with good support for the NetBIOS interface is a common choice. If the primary objective is to connect to DECs VAX workstations running VMS, DECs PATHWORKS software with support for DECnet is the obvious choice. If the primary objective is to connect to UNIX workstations, a good networking software package with a robust TCP/IP protocol stack and support for the WinSock 1.1 standard is required. No networking software package is required for stand-alone remote PCs that dial in to a network. NetDDE includes all of the software necessary to provide access to the PCs communications ports and attached modems. NetDDE for Windows includes an implementation of the DDE Share Security architecture defined by Microsoft and implemented in their WFW and Win95/98 products. With NetDDE for Windows running on a Windows 3.1 PC, you can access secured DDE data on other WFW, Win95/98, and Windows NT nodes as well as secure local DDE data for controlled access by remote nodes.
Introduction
1-5
NetDDE in the WFW and Win95/98 Environments

Microsofts Windows For Workgroups (3.1 or later) and Windows 95/98 include a licensed version of NetDDE and support for the NetBIOS network interface. Both WFW and Win95/98 include built-in support for the NetBIOS/NetBEUI based Microsoft Networking. If you meet all connectivity requirements using the NetBIOS protocol, no other network software package is needed to run NetDDE for Windows. The NetDDE software that is packaged by Microsoft in WFW and Win95/98 only supports the NetBIOS networking interface. It does not offer any user interface to control networking options, view network status or log network events. NetDDE for Windows, when installed on a WFW or Win95/98 node, replaces all of Microsofts NetDDE components while remaining completely compatible with the replaced versions (including providing support for the DDE Share Security architecture).
1-6
Chapter 1
NetDDE Connectivity with Windows NT

Microsofts Windows NT includes a licensed version of NetDDE and support for the NetBIOS network interface. To gain access to DDE data stored on a Windows NT platform, the remote PC must be running either NetDDE for Windows or the NetDDE software included with Microsofts WFW and Win95/98 software packages. The Windows NT implementation of NetDDE enforces a user-based DDE security architecture. All users attempting to access DDE data from remote workstations must be authenticated by NetDDE running on the Windows NT node. The NetDDE for Windows software (installed on the client PC) is capable of engaging the required security protocol with the Windows NT node and attempts to authenticate the logged on user on behalf of the Windows NT node. On PC nodes configured with either the Microsoft Network or LanMan, NetDDE for Windows is able to authenticate the user based on the users logon to the respective network. On PC nodes configured with other "foreign" networks, the user is prompted by the NetDDE for Windows software to enter a valid user name, domain and password when attempting to access DDE data on the Windows NT node. Note When connecting NetDDE for Windows, using the WinSock interface, to NetDDE for NT, the Validation Method must be set to Checksum. For more information, see "Additional WinSock Configuration Parameters" in Chapter 8.
Introduction
1-7
NetDDE Connectivity with VMS

DECs VMS 5.X for the VAX and OpenVMS 6.X for the VAX and AXP workstations does not provide any native support for DDE within the node or with remote nodes. However, applications running in the VMS environment can be endowed with DDE capabilities by using the NetDDE for VMS product. Applications programmed to the NetDDE API (defined in the NetDDE for VMS Software Development Kit) are able to access remote DDE data as well as make data stored at the VMS node accessible via NetDDE by remote nodes. The NetDDE for VMS runtime software provides support for two network interfaces on the VAX or AXP workstation: DECnet and TCP/IP. DECnet is included as a standard option in most VMS environments. However, the only TCP/IP protocol stack currently supported by NetDDE in the VMS environment must be installed from DECs UCX TCP/IP Services software package. On a PC workstation, NetDDE for Windows must be configured to support either the DECnet networking interface or the WinSock 1.1 networking interface in order to access DDE data on the VMS workstation. Since the current shipping version of NetDDE for VMS does not support the DDE Share Security architecture, DDE data at the PC workstation that is to be accessed by NetDDE on a VMS workstation should not be secured. The DDE share for this data must be configured for "Full Access." For more information on DDE Share Security, see Chapter 5, "DDE Share Security." Since none of the DDE data on a VMS workstation is secured by NetDDE, applications from all workstations have full access to it via NetDDE. Note When connecting NetDDE for Windows, using the WinSock interface, to NetDDE for VMS, the Validation Method must be set to Checksum. For more information, see "Additional WinSock Configuration Parameters" in Chapter 8.
1-8
Chapter 1
NetDDE Connectivity with UNIX

UNIX workstations do not provide any native support for DDE within the node or with remote nodes. However, applications running in the UNIX environment can be endowed with DDE capabilities by using the NetDDE for UNIX product. Applications programmed to the NetDDE API (defined in the NetDDE for UNIX Software Development Kit) are able to access remote DDE data as well as make data stored at the UNIX node accessible via NetDDE by remote nodes. Currently the NetDDE for UNIX product supports several UNIX variants: HP-UX, SunOS, AIX, SCO, Interactive UNIX, and OSF/1. The NetDDE for UNIX runtime software supports only one network interface on the UNIX platform: TCP/IP. The TCP/IP protocol stack is a standard feature of most UNIX variants. On a PC workstation, NetDDE for Windows must be configured to support the WinSock 1.1 networking interface in order to access DDE data on the UNIX workstation. Since the current shipping version of NetDDE for UNIX does not support the DDE Share Security architecture, DDE data on the PC node that is to be available for access by NetDDE on a UNIX workstation should not be secured. The DDE share for this data must be configured for "Full Access." For more information on DDE Share Security, see Chapter 5, "DDE Share Security." Since none of the DDE data on a UNIX workstation is secured by NetDDE, applications from all workstations have full access to it via NetDDE. Note When connecting NetDDE for Windows, using the WinSock interface, to NetDDE for UNIX, the Validation Method must be set to Checksum. For more information, see "Additional WinSock Configuration Parameters" in Chapter 8.
Introduction
1-9
NetDDE Connectivity with Macintosh

Macintosh workstations do not provide any native support for DDE within the node or with remote nodes. Microsoft applications, such as Excel and Word, on the Macintosh do support DDE implemented via Apple events. Using NetDDE for Macintosh, users can access remote DDE data from the Microsoft applications running on the Macintosh as well as make the DDE data in those applications accessible to remote nodes via NetDDE. The NetDDE for Macintosh runtime software supports only one network interface on the MacIntosh: TCP/IP. The TCP/IP protocol stack on the Macintosh must first be installed from Apples TCP/IP Connection for the Macintosh software product. On a PC workstation, NetDDE for Windows must be configured to support the WinSock 1.1 networking interface in order to access DDE data on the Macintosh workstation. Since the current version of NetDDE for Macintosh does not support the DDE share security architecture, DDE data on the PC node that is to be available for access by NetDDE on a Macintosh workstation should not be secured. The DDE share for this data must be configured for "Full Access." For more information on DDE Share Security, see Chapter 5, "DDE Share Security." Since none of the DDE data on a Macintosh workstation is secured by NetDDE, applications from all workstations have full access to it via NetDDE.
1-10
Chapter 1
2-1
C H A P T E R
Installation Considerations
This chapter describes any additional installation requirements and considerations for specific network interfaces.
Contents n Installing NetDDE for Windows n General Installation Requirements n Installation Requirements for NetBIOS n Installation Requirements for Serial n Custom Hardware Settings n Installation Requirements for WinSock
2-2
Chapter 2
Installing NetDDE for Windows

NetDDE for Windows is installed by running the SETUP.EXE program on the NetDDE for Windows Program Disk. To install NetDDE for Windows: 1. 2. 3. Start Windows. Insert the NetDDE for Windows Program Disk into the appropriate drive. For Windows 3.1 and Windows for Workgroups, in either Program Manager or File Manager, click Run on the File menu. For Windows 95/98, click Start, and then point to Run. The Run dialog box appears. 4. Enter either x:\setup (where x identifies the drive), and then click OK. The Destination Directory for Wonderware NetDDE for Windows dialog box appears, showing the default installation directory. 5. By default, NetDDE will be installed in your InTouch directory. To change the directory, enter the new path, then click Continue to begin the installation. If the system detects an existing copy of Network DDE or NetDDE for Windows, you will be prompted to rename the existing files. When the installation is complete, the NetDDE Setup Utility dialog box appears, prompting you to restart Windows. Click OK.
6. 7.
Important Note Be sure to restart Windows before using NetDDE.
2-3
General Installation Requirements

The following sections describe general considerations for preparing a PC node for networking. Most of these considerations pertain to all applications using the installed network interfaces, not just for NetDDE.
Avoiding Adapter Memory Conflicts with Windows

If NetDDE is to be used in Windows 386 Enhanced Mode , Windows must be prevented from allocating or attempting to manage the memory that may be on the specific network adapter card. Most local area network adapter cards map their onboard memory in the C000-DFFF range. To prevent Windows from using the onboard adapter memory, modify the SYSTEM.INI file (located in the Windows default directory) to exclude the adapters onboard memory address range from Windows access. Using a text editor program such as SysEdit or Notepad, open the SYSTEM.INI file. Locate the [386Enh] section and enter or modify the memory exclude line. For example:
[386Enh] emmexclude=A000-EFFF
If the exact memory range used by the configured network adapter(s) is known, enter the bounds for that range. Otherwise, exclude the entire range as shown in the above example. Note Windows must be restarted once the SYSTEM.INI has been edited in order for the changes to take effect.
Avoiding Adapter Memory Conflicts with DOS

MS-DOS Version 6.0 and above provide the ability to manage upper memory blocks and sometimes load installed drivers and other programs into that range. Most local area network adapter cards map their onboard memory into the upper memory range. To prevent MS-DOS from using or managing the onboard adapter memory, modify the CONFIG.SYS file (located in the root directory of the boot drive) to exclude the adapter memory from MS-DOS access. Using a text editor program, such as SysEdit or Notepad, open the CONFIG.SYS file and locate the line responsible for loading the EMM386 driver. In this line enter or modify the memory exclude command X=aaaa-bbbb. For example:
DEVICE=C:\WFW311\HIMEM.SYS DEVICE=C:\WFW311\EMM386.EXE NOEMS X=CC00-D3FF
If the exact memory range used by the configured network adapter(s) is known, enter the bounds for that range. Otherwise, exclude the entire range. Note The PC node must be rebooted once the CONFIG.SYS file has been edited in order for the changes to take effect.
2-4
Chapter 2
Installation Requirements for NetBIOS

Ensure that the local node is set up to support the NetBIOS interface and protocol standard. The NetBIOS network interface is supported by various LAN vendors on top of physical networks, such as Ethernet, Token Ring, 10 Base-T, and so on. The NetBIOS interface can usually support up to two network adapters (the Microsoft NetBEUI and NetBIOS implementations are capable of supporting more than two network adapters), with each network adapter addressing up to 255 nodes. In most cases, NetBIOS support is usually in the form of a NetBIOS driver, loaded as part of the network installation procedure. Ensure that such a driver has been properly loaded and configured by referring to the specific network installation instructions. At initialization, the NetBIOS network interface automatically attempts to determine the available LAN adapters supporting the NetBIOS protocol. This can be overridden if, for example, the PC node has two LAN adapters, but NetDDE is restricted to the use of only one of them. It can also be overridden if the underlying network does not support standard LAN adapter configuration query commands and you wish to "manually" identify the specific LAN adapter(s) to be used by NetDDE. The NetBIOS network interface can be configured by adding the following entries to the NETDDE.INI file (located in the Windows directory): [NETBIOS] NumNetBIOS=nnn or, [NETBIOS] LanaNums=nnn,n1,n2,n3... The "NumNetBIOS=nnn" parameter instructs the NetBIOS network interface to use, at most, the first nnn LAN adapters found. If not limited by this parameter, it will attempt to use all configured LAN adapters found at the node. The "LanaNums=nnn,n1,n2,n3" parameter instructs the NetBIOS network interface to use nnn LAN adapters at the node and specifies that the nnn LAN adapters are addressable by LAN numbers n1, n2, and n3. This parameter is used primarily to bypass NetDDEs automatic LAN adapter configuration query. Therefore, you must know beforehand how the NetBIOS LAN adapters are configured.
2-5
Installation Requirements for Serial

When NetDDE is installed, the Wonderware WWCOMTSR.EXE and SDDETSR.EXE TSRs will automatically be copied into the directory where NetDDE was loaded. To select the Serial network interface in the NetDDE program, both TSRs must be loaded prior to starting Windows. This can be done by modifying the AUTOEXEC.BAT file to reference WWCOMTSR and SDDETSR in the installation directory. The WWCOMTSR provides the hardware interface to the serial communication ports on the PC. The SDDETSR provides an interface to the SERIAL.DLL used by NetDDE in the Windows environment. If the serial network interface is to be used, follow the general installation procedure and then exit Windows to load the TSR programs. The procedure for loading TSRs is described in the following section. The TSR must be loaded each time the computer is rebooted. Next, restart Windows, run NetDDE and select the Serial network interface by using the Interface command on the Configure menu. For more information on configuring the serial interface, see Chapter 6, "Additional Serial Interface Parameters."
Loading the Serial TSRs

The serial interface TSRs must be loaded at the DOS prompt. Make sure that the directory into which NetDDE was installed is in your path. To load the TSRs, type the following at the DOS prompt. For example:
C:\INTOUCH.16>WWCOMTSR C:\INTOUCH.16>SDDETSR
Starting these programs with no command arguments reserves PC communication port 1 and 2 for NetDDE use and should satisfy the requirements of most installations.
2-6
Chapter 2
WWCOMTSR Configuration Options

For details on the various options available for loading the WWCOMTSR at the DOS prompt, enter the TSR name followed by a blank space and a question mark. For example:
C:\INTOUCH.16>WWCOMTSR ?
The following will appear:

Usage: WWCOMTSR ? WWCOMTSR ;Displays this usage screen. ;Install at first available vector between 60h and 66h ;with the default COM port configuration. WWCOMTSR [xx] [[[[[COMn:e],tx],rx],io],int]. . . ;Install at soft interrupt vector xx (xx:60h..66h) ;with COM port n (n:1..4) enabled (e=1) or disabled (e=0) ;Tx buffer of size tx and Rx buffer of size rx (tx,rx >= 4). ;at i/o address of io and with interrupt intassigned. ;COM port configuration parameter can be repeated for each port. ;Unspecified or omitted parameters assume default values. Default Configuration: ISA BUS COM1:1,2048,2048,3F8,4 COM2:1,2048,2048,2F8,3 COM3:0,2048,2048,3E8,4 COM4:0,2048,2048,2E8,3 MCA COM1:1,2048,2048,3F8,4 COM2:1,2048,2048,2F8,3 COM3:0,2048,2048,3220,3 COM4:0,2048,2048,3228,3
SDDETSR Configuration Options

For details on the various options available for loading the SDDETSR at the DOS prompt, enter the TSR name followed by a blank space and a question mark. For example:
C:\INTOUCH.16>SDDETSR ?
The following will appear:

Wonderware Serial NetDDE TSR Version 1.02 Copyright (c) 1991 Wonderware Software Development Corp. All rights reserved. Usage: SDDETSR ? SDDETSR ;Displays this usage screen. ;Install at first available vector between 60h and 66h ;with the default COM port configuration. SDDETSR /U ;Unload existing instance of SDDETSR.
SDDETSR [xx] [COMn:e] ... ;Install at soft interrupt vector xx (xx:60h..66h) ;with COM port n (n:1..4) enabled (e=1) or disabled (e=0) ;The COM port enable parameter can be repeated for each ;port. ;Unspecified parameters assume default values. Default port configuration: COM1:1 COM2:1 COM3:0 COM4:0
2-7
Common TSR Configurations

The default settings for the TSRs will enable COM1 and COM2 and provide a transmit and receive buffer of 2048 bytes for each port. To use COM1 only:
C:\INTOUCH.16>WWCOMTSR COM1:1,2048,2048,3F8,4 COM2:0 C:\INTOUCH.16>SDDETSR COM1:1 COM2:0
To use COM2 only:

C:\INTOUCH.16>WWCOMTSR COM1:0 COM2:1,2048,2048,2F8,3 C:\INTOUCH.16>SDDETSR COM1:0 COM2:1
To use COM3 only:

C:\INTOUCH.16>WWCOMTSR COM1:0 COM2:0 COM3:1,2048,2048,3E8,5 C:\INTOUCH.16>SDDETSR COM1:0 COM2:0 COM3:1
Note When enabling COM ports greater than COM2, it may be necessary to provide the specific I/O base address and interrupt level assignment for that port.
2-8
Chapter 2
Custom Hardware Settings

The following sections describe custom hardware settings regarding compatibility with serial I/O Servers, assigning I/O addresses to communication ports, and configuring software interrupts.
Compatibility with Serial I/O Servers

Note WWCOMTSR must be configured with communication ports that are to be used by both the NetDDE Serial interface and by some I/O Servers. The SDDETSR should only be configured with communication ports to be used by NetDDE. Only one instance of each TSR is allowed. To use an I/O server that requires the WWCOMTSR on COM1 and Serial NetDDE on COM2 (with default settings):
C:\INTOUCH.16>WWCOMTSR C:\INTOUCH.16>SDDETSR COM1:0 COM2:1
or, C:\INTOUCH.16> WWCOMTSR COM1:1,2048,2048,3F8,4

COM2:1,2048,2048,2F8,3
C:\INTOUCH.16> SDDETSR COM1:0 COM2:1 To use an I/O server that requires the WWCOMTSR on COM2 and Serial NetDDE on COM1 (with default settings):
C:\INTOUCH.16>WWCOMTSR C:\INTOUCH.16>SDDETSR COM1:1 COM2:0
or, C:\INTOUCH.16> WWCOMTSR COM1:1,2048,2048,3F8,4

COM2:1,2048,2048,2F8,3
C:\INTOUCH.16> SDDETSR COM1:1 COM2:0 After loading WWCOMTSR and SDDETSR, complete the setup procedures required by the serial port based I/O Server.
2-9
Assigning I/O Addresses to Communication Ports

The following defaults are used for assigning I/O addresses and interrupt levels for COM1 through COM4: PC/AT/ISA/EISA PS/2 MCA PORT I/O IRQ I/O IRQ COM1 3F8 4 3F8 4 COM2 2F8 3 2F8 3 COM3 3E8 4 3220 3 COM4 2E8 3 3228 3 If you are enabling a specific communication port when the default values differ from the I/O address base and interrupt level assignment (as configured on the I/O card), change the TSRs defaults by entering the custom I/O address and interrupt level assignment on the command line. For example:
C:\INTOUCH.16>WWCOMTSR COM1:0 COM2:0 COM3:1,2048,2048,2E8,5
This example allows the TSR to be configured for one communication port, COM3, using rx/tx buffer lengths of 2048, an I/O address base of 2E8, and an interrupt level 5. When entering custom I/O and interrupt (IRQ) configurations, ensure that the
2-10
Chapter 2 values entered actually correspond to the hardware configuration and that there are no conflicts with other hardware installed in the system. One way to check for IRQ conflicts is to use the Microsoft Diagnostic (MSD) utility that is included in Windows 3.1. MSD is a character-based DOS application that is best run after exiting Windows. From the DOS prompt, type:
C:\INTOUCH.16>C:\WINDOWS\MSD
From MSDs main menu of options, select IRQ Status to list the current IRQs and the devices currently assigned. Although WWCOMTSR allows interrupt (IRQ) assignments ranging from 2-15, few serial interface adapters or boards support interrupts greater than 7. On an IBM PC/AT compatible system, interrupts cannot be shared between devices. Unique IRQs must be assigned to each of the active communication ports. Warning! If configuring more than two ports, the default will never be adequate and specific IRQ assignments must be made to the selected communication ports.
Note Typically, the first IRQ to consider for configuration of an additional communication port is IRQ5. IRQ5 is the default for LPT2. If two LPT ports are used, select another IRQ, e.g., 10 or 11. Many network cards will also attempt to use IRQ5. Use caution.
2-11
Configuring Software Interrupts

WWCOMTSR and SDDETSR utilize soft interrupts in the range of 0x60 - 0x66 to communicate with NetDDE. As part of the configuration process, these interrupts can be explicitly assigned to each TSR. However, both TSRs are able to find and claim (by default) the next unused software interrupt. We recommend that these TSRs be loaded last so that they can work around less flexible TSRs using fixed software interrupts. If the automatic software interrupt selection used by the TSR is inadequate, assign specific software interrupts to each TSR when they are loaded into memory. For example:
C:\INTOUCH.16>WWCOMTSR 63 C:\INTOUCH.16>SDDETSR 65
In the above example, WWCOMTSR is instructed to use software interrupt 0x63 and SDDETSR is instructed to use software interrupt 0x65.
2-12
Chapter 2
Installation Requirements for WinSock

Prior to installing NetDDE for Windows and enabling its TCP/IP interface, a TCP/IP stack that conforms to the WinSock 1.1 standard must be installed. After installing the TCP/IP protocol stack software, verify that a network name and address have been declared for the local node and for each of the nodes with which you intend to establish NetDDE conversations.
Installation Requirements for DECnet

To successfully configure the DECnet network interface for NetDDE, the DECnet software must first be installed at the local node, either from the DECs PATHWORKS for DOS 4.X, PATHWORKS for DOS 5.X package, or PATHWORKS 1.0 for Windows 95/98. After installing DECs PATHWORKS software, the local node name and the names of remote nodes with which NetDDE will connect must be defined through the PATHWORKs NCP utility on the local node.
DECnet from PATHWORKS 4.X

To use DECnet as a network interface in NetDDE, DEC PATHWORKS software (Version 4.0 or 4.1) is required. Install PATHWORKS on the node by following the installation procedures accompanying the PATHWORKS software. After completing installation of DEC PATHWORKS, the Microsoft Windows network configuration must indicate that the installed software is indeed "PATHWORKS 4.X."
Starting WIN3SETU
A key PATHWORKS support component for Windows is the WIN3SETU program. This utility installs the DEC-specific support components for Windows and allows NetDDE to access DECnet. Note Failure to run the WIN3SETU program before running NetDDE will cause the computer to stall or require you to reboot! WIN3SETU can be started either from the DOS command line or within Windows.
Installation Considerations To start WIN3SETU from the DOS command line: 1.
2-13
Change your directory to the system service where the network files are located. For example, if your files are located on the "J" drive, enter from the root:
\> J:
2.
Change to the Windows directory. For example:

> cd\MSWINV30
3.
Enter the WIN3SETU command. For example:

J:\MSWINV30>WIN3SETU
The utility will display its initial screen. To start WIN3SETU from within Windows 1. 2. In the Windows Program Manager, click the Run command on the File menu. Enter the path where WIN3SETU is located. For example:
J:\MSWINV30\WIN3SETU
Using WIN3SETU
To use WIN3SETU: 1. At the prompt, verify the drive letter of the system service on which PATHWORKS for DOS is located. If it is incorrect, enter the appropriate drive letter. At the second prompt, verify the directory where Windows is installed. If it is incorrect, enter the appropriate directory location.
2.
Based on the response to the second prompt, WIN3SETU determines whether you are a System Administrator, allowed to install all of the support components to the network service, or an End User.
System Administrator
If you are a System Administrator, enter the location of the network service where the Windows files were copied (for example, K:\WINDOWS) at the second prompt. WIN3SETU copies all support components into this directory and then exits.
2-14
Chapter 2
End User
1. If you are an End User, verify the Windows default directory shown at the second prompt. If it is incorrect, enter the correct path. For example, C:\WINDOWS. WIN3SETU will prompt you to answer questions about your particular hardware configuration. After you have responded, WIN3SETU will display all of the entered information. Press RETURN to confirm the information and exit the utility. If the information was entered incorrectly, press the ESCAPE key. The entries will be canceled and WIN3SETU must be restarted.
2.
3.
Once the information is confirmed, WIN3SETU completes the support component installation by modifying the SYSTEM.INI file and copying all DEC-specific support components into the Windows directory.
DECnet from PATHWORKS 5.X

To install and configure PATHWORKS 5.X, install the PATHWORKS 5.X for OpenVMS server software on the OpenVMS server and configure or upgrade the PATHWORKS databases for users, groups, services and access rights to work with PATHWORKS 5.X. Next, install PATHWORKS 5.X for DOS and Windows client software on the network servers file service (for example, \\SRV\PWV50, where SRV is the servers node name, and PWV50 is a directory on that server where the client software resides). Once the file service is installed, each PC client must be configured from that file service to use PATHWORKS 5.X client software. When a PC is configured, files are copied to that PCs local hard disk from the file service. Startup files are also modified and/or created that load the PCs network software. For more information on the PATHWORKS installation and configuration procedures, refer to the PATHWORKS V5 for OpenVMS (LAN Manager) Server Installation and Upgrade Guide , the PATHWORKS V5 for DOS and Windows Client Installation and Configuration Guide , and the release and installation notes distributed with updates and patch kits. Once the PATHWORKS 5.X server and client software are installed, the PC clients must be configured by running the PWSETUP program. This configuration utility allows you to add PATHWORKS services such as DECnet to your PC client.
2-15
Starting PWSETUP
Prior to running PWSETUP, ensure that Microsoft Network is configured on your PC. PWSETUP can be started either from the DOS command line or within Windows. Starting PWSETUP from the DOS command line: 1. Change your directory to the system service where the network files are located. For example, if your files are located on the "J" drive, enter from the root: \> J: 2. Enter the PWSETUP command. For example, \> \PCAPP\PWSETUP
Starting PWSETUP from within Windows: 1. 2. From the Windows Program Manager, click Run on the File menu. Enter the path where PWSETUP is located. For example: J:\PCAPP\PWSETUP
Using PWSETUP
To use PWSETUP: 1. Initially, PWSETUP will prompt you for verification of the software destination directory and drive where it can find PATHWORKS for DOS and Windows. If these are incorrect, enter the appropriate origin and destination directory and drive. To customize a configuration, click Customize in the Select a Configuration Option dialog box. The Customize: Select a Workstation Template dialog box appears. 3. Select a template to represent the basis of your configuration. It is mandatory that you select a template that includes DECnet. For example, select the LAN Manager #1 template for Windows 3.1 or select the WFW v3.11 #1 template for Windows for Workgroups 3.11. The Customize: Modify Workstation Configuration dialog box appears. The default settings should be adequate, but for information on modifying these configurations, click Help. 4. Click OK.
2.
2-16
Chapter 2 5. Once you select a template that approximates your desired configuration, you can modify it. For example, if you want your PC to run SETHOST Terminal Emulation, add PATHWORKS Terminal Emulation to the Run on Workstation box in the Customize: Select PATHWORKS Services for Workstation dialog box. When it appears in this box, select it and click Detail. Double-click on SETHOST for DOS. PWSETUP will ask questions about your particular network configuration. Enter the network connection and network adapter information. Once you have entered the requested information, the Customize: Save Template to Disk dialog box appears. 7. In the Customize: Save Template to Disk dialog box, name your configuration template and enter the description (for example, Template Name: NetDDE; Description: DECnet, Terminal Emulation), and click Save. PWSETUP copies the associated files for the PATHWORKS services you requested, modifies the startup files, and creates a template file (CFGnnnn.TPL, where nnnn is a number) that characterizes the configuration you specified. After the configuration utility completes, reboot the PC to start the network. Note To modify the above configuration, run PWSETUP and select your template (by the name and description given in Step 7). You can now add/delete specific PATHWORKS services to/from your configuration.
6.
8.
Installing PATHWORKS for Windows 95/98

To install the PATHWORKS software for Windows 95/98 platforms, insert the CD-ROM into your CD-ROM drive and follow the instructions on the screen. You can also run the PATHWORKS installation directly from the CD-ROM by entering:
x:\SETUP.EXE
where x: identifies your CD-ROM drive. Note The contents of the CD-ROM can also be shared or copied to a network file service and installed from there. Refer to the Windows 95/98 help for additional information on sharing and using network resources. To start PATHWORKS for Windows 95/98, click the Start menu on the taskbar, point to Programs, and then click PATHWORKS.
2-17
DECnet Node Name/Address Configuration

The network name and address assigned to the local node (and to the remote nodes with which conversations will be established) must be defined before starting NetDDE and selecting the DECnet network interface. After installing PATHWORKS, assign a node name and address to the local node by typing the following at the DOS prompt:
>NCP NCP>DEFINE EXECUTOR NAME node_name ADDRESS area_num.node_num NCP>SET EXECUTOR NAME node_name ADDRESS area_num.node_num NCP>EXIT >
This information is stored in the DECNODE.DAT file and is read by NetDDE on DECnet each time it is started. PATHWORKS restricts node names to a 1 to 6 alphanumeric character sequence. Node addresses are two-decimal, 3-digit numbers separated by a period. Area_num represents an area (network) code and node_num represents the specific node number. All node names and addresses must be unique on a network. If the local node and/or address defined is different from the one defined during PATHWORKS installation, EXECINFO.BAT (in the C:\DECNET subdirectory) will need to be modified to reflect the changes. Note Make note of the node name assigned to the local node. You will need to enter it when NetDDE initially runs. For more information, see "Defining a Local Node Name" in Chapter 3. The node name and address of each remote node with which the local node will communicate (via NetDDE) must be defined by typing the following at the DOS prompt:
>NCP NCP>DEFINE NODE area_num.node_num1 NAME node_name1 ... NCP>DEFINE NODE area_num.node_numN NAME node_nameN NCP>EXIT >
Note All defined nodes a remote machine can automatically be defined on the local node by using the "copy known nodes from X command." Where " X" identifies the name of a node from which to retrieve the DECnet node name definitions.
2-18
Chapter 2
3-1
C H A P T E R
Starting NetDDE
This chapter describes how to start NetDDE and what occurs the first time NetDDE runs after installation.
Contents n Introduction n Starting in Windows 3.1 and Windows 95/98 n Defining a Local Node Name n Selecting Network Interfaces n Viewing Version Information n Closing NetDDE
3-2
Chapter 3
Introduction
NetDDE for Windows supports the Windows (3.1 or later), Windows for Workgroups (WFW) (3.1 or later), and Window 95 operating systems. The method used to start NetDDE in each of these environments is different. During NetDDE startup, the Wonderware Logger (WWLOGGER.EXE) is optionally started to record and display error and diagnostic messages generated by NetDDE. After NetDDE is installed and configured, a NETDDE.INI file is automatically created in the Windows default directory. All operating parameters, routes and connections configured in the NetDDE program are stored in the NETDDE.INI file. NetDDE reads the NETDDE.INI each time it starts. We highly recommend that you do not manually edit NETDDE.INI without consulting Technical Support.
Starting NetDDE
3-3
Starting in Windows 3.1 and Windows 95/98

During Windows 3.1 installation, the NetDDE icon is placed in the InTouch Program Group. During Windows 95/98 installation the NetDDE icon is placed in the StartUp group. By placing the icon in the StartUp group, NetDDE will automatically run each time you restart Windows 3.1 or Windows 95/98.
1. 2.
To manually start NetDDE for Windows: Double-click the NetDDE icon, or Double-click the filename, NETDDE.EXE, in File Manager (Windows 3.1) or in Windows Explorer (Windows 95/98).Starting in Windows For Workgroups
NetDDE automatically runs each time Windows for Workgroups is restarted. Note During installation, NetDDE for Windows terminates and replaces any Network DDE or NetDDE programs. You will be prompted as to whether you want to rename these files during the installation.
3-4
Chapter 3
Defining a Local Node Name

Each node on the network must be identified by a unique node name, for example, Local Node Name or Logical Node Name. The Logical Node Name can be the same as the network node name used for the configured network interface. The Logical Node Name cannot be more than 15 characters in length and cannot contain any embedded spaces or any of the following characters: + * \ / , ? ( ) " . To define a local node name: 1. The first time that NetDDE for Windows is run, the Name for this Node dialog box appears, prompting you to enter a node name:
2.
Initially, the box will be blank. Type a unique name to identify the local node. All nodes on the network must have unique logical node names. Unless the logical node name entered in this dialog box is re-mapped to a network name during network interface selection, the name entered must match the name defined for the node when the network software was installed. Note If you are connecting to a VAX system through DECnet, the node name must be all UPPERCASE letters.
3. 4.
Click OK. The Network Interface Selection dialog box appears. Go to the next section, "Selecting Network Interfaces," to complete the configuration.
In the Windows environment, NetDDE obtains the logical node name from the name that was assigned to the node during Windows configuration. It assumes that the logical node name is equivalent to the network node name used on the Windows network. If this is not satisfactory, you can change the derived logical node name. For more information on changing the derived logical node name, see "Customizing NetDDE Setup" in Chapter 4.
Starting NetDDE
3-5
Selecting Network Interfaces

NetDDE provides connectivity over one or more selected network interface(s). When NetDDE initially runs after being installed on a computer running Windows, you are prompted to select at least one network interface. Before selecting an interface, see Chapter 2, "Installation Considerations," for specific installation instructions and requirements for each supported network interface. To select network interfaces: 1. In the Network Interface Selection dialog box, click Add.
The Add a Network Interface dialog box appears.
2.
Add each network interface that is to be configured for NetDDE.
3-6
Chapter 3 Select the interface to add, enter the network node name to be used on the selected network interface, and click OK. A message box will appear confirming that the interface was successfully added. For example:
3.
After you have added one network interface, the Modify and Delete buttons in the Network Interface Selection dialog box become available. You may now add more network interfaces, modify existing interfaces, or delete interfaces from the list. Click Done. The NetDDE program window will appear displaying any newly configured network interfaces:
4. 5.
By default, when NetDDE initially runs, the NetDDE program window displays information for Network Interfaces , Internode Connections and DDE Conversations. These default settings can be changed by using commands from the View menu. Also, by default, the Terminal font is used for the text in the window. You can changes this font by using the Fonts command on the View menu. For more information, see Chapter 7, "NetDDE Status and Statistics Display."
Starting NetDDE
3-7
Viewing Version Information

Technical Support will usually request version information for the NetDDE program when assisting in troubleshooting. To view the version information: 1. From the Help menu, click About NetDDE. The version information box appears.
3-8
Chapter 3
Closing NetDDE
To close NetDDE: 2. Press Alt+F4. Or, from the Control menu, click Close. (To access the Control menu, click the NetDDE icon in the top left corner of the program window.) Note To close NetDDE in Windows 95/98, either click the "X" button in the upper right corner of the program window, or right-click in the program windows title bar and click Exit from the pop-up menu. 2. The following confirmation dialog box will appear:
3.
Click Yes to end NetDDE or No to continue running NetDDE. If you attempt to close NetDDE while a DDE conversation is in progress, the following warning box will appear:
4.
NetDDE should not be closed during a DDE conversation. If a conversation is in progress, click No, end the DDE conversation, and then close NetDDE.
4-1
C H A P T E R
Customizing NetDDE Setup

This chapter describes how to modify the NetDDE configuration. In most cases, the default configurations will adequately handle standard network configurations. However, to successfully operate in complex network environments, you may need to modify or define some of the configurations options. For more information on security, see Chapter 5, "DDE Share Security."
Contents n Modifying the Local Node Name n Configuring Network Interfaces n Configuring Preferences n Setting Up Network Routes n Mapping Node Connections
4-2
Chapter 4
Modifying the Local Node Name

All nodes on the network must have unique logical node names. Unless mapped to a network node name through the Network Interface Selection dialog box, the logical node name must correspond to the node name assigned by the underlying network interface to that PC. To change the local node name: 1. On the Configure menu, click Local Node Name. The Name for this Node dialog box appears.
2.
In the box, type a logical node name for the local node. The logical node name is limited to a maximum of 15 characters. It cannot contain any embedded spaces or any of the following special characters: + * \ / , ? ( ) " . If an existing logical node name is changed to a new node name, NetDDE must be restarted to recognize the change.
3.
Click OK.
4-3
Configuring Network Interfaces

You can add new network interfaces, delete existing network interfaces, and/or modify the network node name assigned to a network interface. To configure network interfaces: 1. On the Configure menu, click Interfaces. The Network Interface Selection dialog box appears.
2.
To change the node name for a particular interface, select the interface in the Configured Interfaces window, edit the name in the Node Name on Selected Interface box, and then click Modify . By default, the logical node name for the local node will appear in this box. You have the option to modify this box in order to enter the node name used by the PC on the selected network interface. The network node name entered in this box must be valid for the selected network interface. For example, if it is a TCP/IP network interface, the network node name entered here must be either in the local host table or known to the TCP/IP name server. The network node name is limited to 128 characters, but can include any combination of special characters.
3.
To delete a network interface, select the network interface to delete and click Delete. A confirmation dialog box will appear:
4.
To add a network interface, click Add.
4-4
Chapter 4 The Add a Network Interface dialog box appears.
The Available Interfaces list displays all of the available network interfaces that NetDDE is capable of supporting. It does not necessarily represent the network interfaces that are currently installed on the node. 5. Select an interface and then click OK. A confirmation dialog box will appear. For example:
6. 7.
Click OK to return to the Network Interface Selection dialog box. When you are finished configuring interfaces, click Done.
4-5
Configuring Preferences
You can modify miscellaneous NetDDE program control preferences. The preferences chosen will affect all network interfaces and connections. To configure NetDDE preferences: 1. On the Configure menu, click Preferences. The NetDDE Preferences dialog box appears.
2.
To close all network connections when no DDE conversations occur for a specific time period, select the Close when no Conversations option and enter the time period in the seconds box. By default, NetDDE is configured to automatically close all network connections that are "not used" for 30 seconds. "Not used" means that no DDE conversations are actively sending or receiving data over the particular route/connection. You may want to enable this option in a situation where a serial modem is being used. If no data is being transferred, closing the connection would conserve toll charges. The default time can be increased or decreased. Deselecting the checkbox disables the automatic close function.
3.
To configure the local node to use a specific route for all of its connections, type the route name in the Default Route box. For example, the default route can be used when a laptop computer dials into a LAN. If a salesperson dials his/her companys LAN network, this default route establishes the node to which he/she is initially connected. For example, the node on the company LAN with a modem accepting incoming connections.
4-6
Chapter 4 4. Configure preferences for the Wonderware Logger. Start WW Logger on NetDDE Startup By default, the Wonderware Logger is automatically started when NetDDE is run. To prevent the Wonderware Logger from starting automatically, disable this option. You will now need to start the Wonderware Logger manually. Log Permission Violations By default, all occurrences of security violations are logged to the Wonderware Logger. Security violations occur when a remote client attempts to access data at the local node for which adequate permission has not been granted. Log Failures Starting Applications By default, all occurrences of failure to successfully start an application that is not already running are logged to the Wonderware Logger. Unless prohibited by the prevailing security configuration, if a client references an application that is not already running on the local node, NetDDE attempts to start the application first. Log Transmission Retries By default, all data transfers that are re-transmitted due to data errors or timeouts are logged to the Wonderware Logger. It may be desirable to inhibit such logging for noisy serial connections. 5. Configure the times for the time slice and status display update periods. Time Slice Period, XX milliseconds NetDDE is event-driven, however, it uses the time-slice timer to periodically service the protocol layers and configured network interfaces. The time period between services can be modified (minimum value is 55 msec. and maximum value is 32K-1 msec.). The default value of 1000 msec. is used if NetBIOS is the only configured interface. For other network interfaces, we recommend changing the time slice period value to 55 msec. Status Display Update Period, XX milliseconds By default, NetDDE updates the statistic values in the status displays once every 1000 msec. This time period can be modified. It must be equal to or greater than the defined time slice period. Increasing the frequency of status display updates will impact NetDDE performance. 6. Click OK.
4-7
Setting Up Network Routes

This command is used to set up and save the network routes to be used by the local node to access remote nodes not directly connected to the PC. In most cases, routes will not need to be defined. For example, route definition is not required when all nodes reside on a single LAN. Routes are only used to bridge multiple networks and/or provide the capability of dial-in support from remote computers. For example, in the following illustration, the node named "Chet" has a serial port connected to a modem and two network cards installed: one for a TCP/IP network and one for a NetBIOS network. All nodes on the TCP/IP network can communicate with the nodes on the NetBIOS network or communicate with Linda (who is serially linked to Chet), by setting up routes through "Chet."
Note All routes are saved in the [Route] section of the NETDDE.INI file.
4-8
Chapter 4 To configure network routes: 1. On the Configure menu, click Routes. The Network Routes dialog box appears.
2.
Initially, the Network Routes dialog box will be blank. Any routes that you add, along with their configuration information, will appear in this dialog box: Destination Node List Allows you to select a route definition to modify or delete. Route definitions are referenced by the destination logical node name. Route to Destination Node Route to the selected destination node. The last name in this box is the destination node. Any node name before the destination node is the name of a hop node in the link to that destination node. No edits can be made in this box. Using the previous network illustration, if "Phil" wants to communicate with "Linda," the route shown in the Network Routes dialog box above would be defined on Phils machine. The route Chet+Linda tells NetDDE that in order to get to "Linda" from "Phil," a connection must be made first to "Chet" and then a hop through "Chet" to the final destination of "Linda."
3. 4. 5. 6.
To add a route, see "Adding a Route" later in this section. To modify a route, see "Modifying a Route" later in this section. To delete a route, see "Deleting a Route" later in this section. When you are finished configuring routes, click Done.
4-9
Adding a New Route

To define a new route: 1. Click Add. The Add Route dialog box appears.
2. 3.
In the Destination Node Name box, type the name of the destination node. In the Route to Destination Node box, type a route specification. The last node name entered in this field is the destination node. Any node name entered before the destination node name is a hop to the destination node.
4. 5.
Click OK. The new route will be added to the Destination Node List:
4-10
Chapter 4
Modifying a Route
To modify a route: 1. 2. In the Network Routes dialog box, select the destination node from the Destination Node List window. Click Modify . The Modify Route dialog box appears. (This dialog box is the same as the Add Route dialog box.) 3. 4. Make the necessary modifications to the route. Click OK.
All modifications will be reflected in the Network Routes dialog box.
Deleting a Route
To delete a route: 1. 2. In the Network Routes dialog box, select the destination node from the Destination Node List window. Click Delete.
4-11
Mapping Node Connections

To make a connection from one node to another, the logical node name of the remote node is specified by the application initiating the DDE conversation. Unless a connection name mapping for that logical node name is defined through this command, NetDDE first assumes that the logical node name is equivalent to the network node name. It then assumes that in order to reach the remote node, all configured network interfaces will be tried in the order that they were defined. If either of these assumptions is incorrect, you must define a mapping between the logical node name of the remote node and the network interface to be used and/or the network node name to be used on that interface. To configure logical node names: 1. On the Configure menu, click Connections. The Connection Names dialog box appears.
2.
Initially, the Connection Names dialog box will be blank. Any logical node names that you add, along with their configuration information, will appear in this dialog box: Logical Node Names Logical node names of the remote nodes that are normally accessed from this node. Network Network interface to be used in connecting to the selected logical node name. Port Port number on the defined network interface to be used in connecting to the selected logical node name. Not all network interfaces support multiple ports or allow the ports to be addressed.
4-12
Chapter 4 Network Node Name Network node name on the defined network interface to be used in connecting to the selected logical node name. 3. 4. 5. 6. To add a logical node name, see "Adding a Logical Node Name" later in this section. To modify a logical node name, see "Modifying a Logical Node Name" later in this section. To delete a logical node name, see "Deleting a Logical Node Name" later in this section. When you are finished configuring logical node names, click Done.
Adding a Logical Node Name

To add a logical node name: 1. In the Connection Names dialog box, click Add. The Add Connection Name dialog box appears.
2.
In the Logical Node box, type a logical node name for the remote node. The logical node name cannot exceed 15 characters and cannot include embedded spaces or the following special characters: + * \ / , ? ( ) " .
3.
In the Network Interfaces list, select a network interface to be used for connecting to the remote node represented by the logical node name. NetDDE allows you to select network interfaces that are not currently configured. For example, you can select the NetBIOS interface even if you have not added it to the NetDDE configuration using the Network Interface Selection dialog box.
Customizing NetDDE Setup 4.
4-13
If the selected network interface supports multiple ports, a list of possible port selections will appear in the Ports list. Select a port to be used in connecting to the remote node represented by the logical node name. Not all network interfaces support multiple ports and not all ports listed are valid references. NetDDE does not validate the selection. If a network interface does not support a specific port reference or you are not sure of the valid selection, select the Any option. For example, if the NetBIOS network interface is configured to support two network adapters (lana0 and lana1), you may wish to specify that all connections to a specific logical node name be made by going directly to the adapter that services the LAN to which the corresponding remote node is connected. In this case, click on the down arrow in the Ports field and select either Port 0 or Port 1 depending on which adapter is connected to the remote node. Note If you are using the Serial interface, the communication ports map to the following logical ports: COM1: COM2: Port 0 Port 1 COM3: COM4: Port 2 Port 3
5.
In the Network Node box, type a network node name that corresponds to the logical node name of the remote node. The network node name entered in this field must be valid for the selected network interface. For example, if it is a TCP/IP network interface, the network node name entered here must be either in the local host table or known to the TCP/IP name server. The network node name is limited to 128 characters, but can include any combination of special characters.
6.
Click OK to accept the entries and return to the Connection Names dialog box. The added logical node name will appear in the Logical Node Names list.
4-14
Chapter 4
Modifying a Logical Node Name

To modify a logical node name: 1. 2. In the Connection Names dialog box, select the connection name to modify from the Logical Node Names list. Click Modify . The Modify Connection Name dialog box appears. 3. 4. Make any necessary changes to the network interface selection, port selection, and/or network node name mapping. Click OK.
All modifications to the selected connection name will be reflected in the Connection Names dialog box.
Deleting a Logical Node Name

To delete a logical node name: 1. 2. In the Connection Names dialog box, select the connection name to delete from the Logical Node Names list. Click Delete.
5-1
C H A P T E R
DDE Share Security
This chapter describes DDE Share Security and the procedure for creating a DDE Share database.
Contents n Introduction n Defining Default DDE Share Security n Customized DDE Shares n Connecting to a Secured Windows NT Application n Connecting to a Secured WFW or Win95/98 Application
5-2
Chapter 5
Introduction
Because NetDDE enables access by other workstations to DDE data stored on the local node, a security policy has been put into place to prevent unauthorized access to information by remote workstations. With a DDE Share Security policy in place, access must be explicitly granted to shared DDE data available at the local node. Likewise, a remote workstation that wants access to secured DDE data must be able to respond appropriately to the requirements exacted by the DDE Share Security subsystem in NetDDE. NetDDE allows you to configure a DDE Share Security policy and to administer the configured DDE Share Security policy when remote workstations attempt to gain access to DDE data available at the local node. The DDE Share Security architecture implemented by NetDDE was first introduced by Microsoft in its Windows for Workgroups 3.1 product.
DDE Shares
DDE shares correspond to DDE data maintained by DDE-aware server applications. Some applications, such as Wonderware InTouch and Microsoft Excel, can be both DDE clients and DDE servers on the local node. DDE shares are defined in the DDE shares database maintained by NetDDE on each node. The DDE shares database stores the name of each application and topic pair that can be referred by a remote node in a NetDDE conversation. The DDE shares database also identifies the security permission levels for each DDE share that defines the access nodes available to that share. A DDE share can be created for each DDE topic supported by a DDE-aware application. Or, a "wild card" DDE share, specifying "*" as the topic name, can be defined to enable access through NetDDE to all topics supported by the given DDE-aware application. Note The DDE shares database is currently maintained in the Windows SYSTEM.INI file. Future versions of NetDDE may not retain the format or location of the DDE shares database. Do not attempt to edit the DDE share database directly.
DDE Share Security
5-3
DDE Share Permission Levels

A DDE share representing an application and topic pair that has been explicitly defined in the DDE shares database is referred to as a "custom" DDE share. Each "custom" DDE share defined in the DDE shares database has a specific permission level assigned to it. The permission level assigned to the DDE share determines what type of access will be granted by NetDDE to remote workstations. The following permission levels can be assigned to a DDE share:
Full Access
Allows access to the specified application and topic from all remote workstations without any restrictions.
No Access
Allows no access to the specified application and topic from any remote workstation.
Read Only Access

Allows only DDE Request and DDE Advise access to the specified application and topic from any remote workstation. No DDE Poke or DDE Execute access is allowed.
Read Only with Password

Allows DDE Request and DDE Advise access to the specified application and topic only from remote workstations that have the correct password. No DDE Poke or DDE Execute access is allowed.
Full Access with Password, else Read Only

Allows DDE Request and DDE Advise access to the specified application and topic from any remote workstation. DDE Poke and DDE Execute access is allowed only from remote workstations that have the correct password.
Passwords Required to Read and Write

Allows access to the specified application and topic depending on the password supplied by the remote workstation. One password is defined for DDE Request and DDE Advise access and another password is defined for DDE Poke and DDE Execute access.
5-4
Chapter 5
Default DDE Share Security

Default DDE Share Security is applied to all application and topic pairs that are not explicitly itemized in the DDE shares database. When NetDDE receives an initiate to a specific application and topic, it first interrogates the DDE shares database to see if specific security permission levels have been assigned. If a share for the specific application and topic pair has not been defined, NetDDE will use the security permission levels assigned to the default DDE share and apply them to the initiated DDE conversation. The default DDE share can be assigned the same security permission levels as "custom" DDE shares.
DDE Shares for the Windows for Workgroups and Windows 95/98 Operating Systems
DDE shares defined in the DDE shares database by the DDESHARE.EXE utility (distributed with Windows for Workgroups and Windows 95/98) are compatible with NetDDE. NetDDE will enforce the security permission levels assigned to the DDE shares defined by the Windows for Workgroups and Windows 95/98 utilities. The NetDDE security configuration editor (accessed using the Security command on the Configure menu) can only be used to create or modify application and topic pair type DDE shares. To create and modify DDE shares, commonly used by Microsoft ClipBook and other DDE-aware programs, you should run the DDESHARE.EXE utility. Refer to the resource kit for the Windows environment you are using for a complete description of DDE share types and guide to the DDESHARE.EXE utility.
DDE Share Security
5-5
Defining Default DDE Share Security

The default DDE share can be defined and modified from the Custom DDE Security Browser . To define default DDE share security: 1. On the Configure menu, click Security. The Custom DDE Security Browser dialog box appears.
The current security level for the default DDE share is displayed in the Default DDE Security on This Node is box. For example, "Full Access." 2. To modify the default security level, click Configure Default Security . The Default DDE Security dialog box appears.
5-6
Chapter 5
Descriptions for the options you select will appear in the message window at the right of the dialog box. 3. In the Default Access group, select a default access option for the node. By default, NetDDE assumes "Full Access" for the node and creates a corresponding default DDE share when it is activated (unless a DDE share already exists in the DDE shares database). This ensures a smooth transition from the Windows 3.1 environment, allowing you to become gradually accustomed to securing DDE data in this manner. For more information on the available permission levels, see "DDE Share Permission Levels" earlier in this chapter. 4. 5. To start an application that is not already running on connection from the remote node, select the Default Startup option. Click OK to return to the Custom DDE Security Browser dialog box.
DDE Share Security
5-7
Customized DDE Shares

The DDE shares database can be edited through NetDDE. New "custom" DDE shares can be added and existing shares modified. The Custom DDE Security Browser allows you to view existing "custom" DDE shares and initiate actions to add, modify or delete selected DDE shares. The Custom DDE Security Browser also allows you to access the default DDE share editor. To customize DDE shares: 1. On the Configure menu, click Security. The Custom DDE Security Browser dialog box appears.
The default security level for the local node is displayed in the Default DDE Security on This Node is box. For example, "Full Access." 2. To configure the default DDE share security, click Configure Default Security. For more information, see "Defining Default DDE Share Security" earlier in this chapter. 3. To view the security permission level assigned to a custom DDE share, select the application from the Application Name window and then select the topic from the Topic Name window. Once a custom DDE share is selected, the security permission level associated with that share will be displayed in Security for Selected App/Topic window.
5-8
Chapter 5 4. To flush the client password cache, click Flush Client Password Cache . Note If you are using Windows 3.1, the Flush Client Password Cache button will remove all client passwords in the cache without offering a selection. For more information, see "Flushing Cached Passwords" later in this chapter. 5. Click Done.
Adding a DDE Share

To add a DDE share: 1. In the Custom DDE Security Browser dialog box, click Add. The Custom DDE Security Configuration dialog box appears.
Descriptions for the options you select will appear in the message window at the right of the dialog box. 2. 3. In the Application box, type an application name. To specify a particular topic name, select the Topic Name option and type a topic name in this box. To allow access to all topics, select the Any Topic option. If you wish to only allow access to certain topics in an application, security levels can be assigned to each topic. In the example above, SHEET1.XLS of the application EXCEL requires a password to read and write. 4. In the Select Required Access Security group, select the desired security permission level to be assigned to the custom DDE share.
DDE Share Security
5-9
For more information on the available permission levels, see "DDE Share Permission Levels" earlier in this chapter. 5. 6. To start an application that is not already running on connection from the remote node, select Application Startup Option . To specify a read password, type a password in the Enter Read Password box. This box will only appear if the Passwords Required to Read and Write security level is selected. 7. To specify a write password, type a password in the Enter Write Password box. This box will only appear if the Passwords Required to Read and Write security level is selected. 8. Click OK to return to the Custom DDE Security Browser dialog box.
Modifying a DDE Share

To modify a DDE share: 1. In the Custom DDE Security Browser dialog box, click Modify . The Custom DDE Security Configuration dialog box appears. 2. Make any necessary modifications to the configuration. For more information on dialog box options, see "Adding a DDE Share" earlier in this chapter. 3. Click OK to return to the Custom DDE Security Browser dialog box.
Deleting a DDE Share

To delete a DDE share: 1. 2. 3. In the Custom DDE Security Browser dialog box, select the DDE share to delete. Click Delete. Click OK to return to the Custom DDE Security Browser dialog box.
The share will be removed from the DDE shares database and the displays in the Custom DDE Security Browser dialog will be updated.
5-10
Chapter 5
Flushing Cached Passwords

When an application first accesses remote data through NetDDE that has been secured by a password, the application user is prompted to enter the current password(s). When entering the password(s), the user has the option to have NetDDE cache the entered password associated with the DDE share being accessed. This allows future references to the same DDE share to avoid the user prompt for the password. (Occasionally, it is desirable to flush the cached passwords.) You can remove a clients cached password(s) associated with DDE share(s) that have been accessed in the past. To flush cached passwords: 1. In the Custom DDE Security Browser dialog box, click Flush Client Password Cache . The Flush Client DDE Share Password Cache dialog box appears.
2. 3. 4.
To remove a cached password associated with a DDE share, select the DDE share name in the above dialog box and click Flush. To flush all passwords for all cached DDE shares, click Flush All. Click Done to return to the Custom DDE Security Browser dialog box.
If an entered password for a particular share is not removed, NetDDE will use the entered password each time access to that share is attempted.
DDE Share Security
5-11
Connecting to a Secured Windows NT Application

DDE security in the Windows NT operating environment is "user-based" rather than "share-based" as in Windows for Workgroups. This means that a DDE-aware application running in the Windows NT environment secures its DDE data by defining a DDE share associated with the application and topic being secured. It then identifies the user names or groups that can have access to that share and the type of access to be permitted. From the clients perspective, running a DDE-aware application that accesses a secured Windows NT node through NetDDE, the user in whose context the client application is running must be known to the Windows NT node in order to gain access to any shared DDE data. After the client application issues the first DDE Initiate to the remote Windows NT node, the Windows NT node queries NetDDE for the users identity. A users identity is usually established during Windows or Windows for Workgroups startup (when the user logs on to the appropriate domain server). If the users identity has been established at the local node, NetDDE passes it on to the secured Windows NT node for validation. However, if a users identity has not been established through an appropriate logon in the Windows or Windows for Workgroups environment, then, in response to Windows NTs query, NetDDE prompts the user for his/her identity by displaying the Enter Network Access Password dialog box. This dialog box allows the user to establish correct identity in order to gain access to the secured DDE share on the remote Windows NT node:
The User Name box displays the user name. The Domain box displays either the name of the remote Windows NT node to which the connection is being initiated or the name of a domain server that the Windows NT node trusts.
5-12
Chapter 5 To gain access: 1. In the Password box, type the user password that was defined when the users identity was established (either at the remote Windows NT node or at the designated domain server). To save the entered user identity at the local node for future accesses to the same DDE share, select Save Password for Future Access . Click OK.
2. 3.
If the entered information is correct, you will be granted access to the desired DDE share.
DDE Share Security
5-13
Connecting to a Secured WFW or Win95/98 Application

If a DDE-aware client application attempts to initiate a DDE conversation with a secured WFW or Win95/98 node, the user may be prompted to enter a password. When DDE shares are defined, three of the six security permission levels can be set up to require passwords. If a DDE share that requires a password is accessed by remote node, NetDDE will request a password from the accessing client node. This, in turn, prompts the user for the appropriate password with the Enter NetDDE Share Access Password dialog box:
To gain access: 1. In the Password box, type the appropriate password for the desired DDE share. Clients must be informed of valid passwords by the user defining the DDE share. 2. 3. To save the entered user identity at the local node for future accesses to the same DDE share, select Save Password for Future Access . Click OK.
If the entered information is correct, you will be granted access to the desired DDE share.
5-14
Chapter 5
6-1
C H A P T E R
Additional Serial Interface Parameters

This chapter describes the additional operating parameters that need to be configured when the Serial interface is selected.
Contents n Introduction n Configuring Ports n Defining Connection Information n Viewing Port Status
6-2
Chapter 6
Introduction
After the Serial interface has been selected using the Interfaces command on the Configure menu, additional parameters need to be configured for NetDDE to successfully access remote nodes. These parameters include definition of the PC communication port to use, modem configuration, and connection information including dialing instructions. To configure the Serial interface: 1. On the Configure menu, click SERIAL Parameters. The Serial Configuration dialog box appears.
2.
To configure the communication port(s) or modem(s) being used by the local node, click Port Configuration . For information on configuring ports, see "Configuring Ports" later in this chapter.
3.
To set up the connection names that define the serial links between the local node and a specific remote node name, click Define Connection Information. Connection information associated with a defined serial link identifies the port to use for the link and the modem dialing instructions for that link (if that link is a dial-up connection). For information on configuring connections, see "Defining Serial Connections" later in this chapter.
4.
To view the status of ports, to disconnect telephone connections to modems, or to re-initialize modems, click Port Status. For information on port status, see "Configuring Port Status" later in this chapter.
5.
To configure other serial parameters, click General Serial Parameters. This button will appear in the Serial Configuration dialog box only if you have enabled the Enable Debug Menu Items command on the Test menu. For more information, see Chapter 8, "NetDDE Test and Debug Commands."
6.
Once all entries are made, click Done to close the dialog box.
6-3
Configuring Ports
You can change the communication port(s) and/or modem(s) being used by NetDDE at the local node. Note When connecting a PC communication port to a modem or to the remote PCs communication port, you must use a cable that enables full-handshaking capability. For direct PC-to-PC connections (DTE-to-DTE), use a NULL modem cable. For PC-to Modem (DTE-to-DCE), use a "straight cable." For more information, see the "Cable Diagrams" section of Appendix C.
To configure serial ports: 1. In the Serial Configuration dialog box, click Port Configuration . The Port Configuration dialog box appears.
The Port Configuration dialog box allows you to enable PC communication ports for NetDDE use, select the data transfer speed (baud) for each serial port, and configure the port for modem communication (if applicable). Serial character size, parity and stop bit parameters are not configurable. NetDDE uses internal defaults for these parameters. 2. In the Port list, select the communication port to be enabled or configured. The only accessible PC communication ports will be those that were defined for NetDDE use when the "SDDTSR.EXE" TSR was installed. For more information, see "Installation Requirements for Serial Port" in Chapter 2.
6-4
Chapter 6 3. Select the Enabled option to activate the selected PC communication port for NetDDE use. Multiple communication ports may be enabled concurrently by reselecting the port box. 4. In the Com Port Baud Rate list, select the appropriate baud rate to be assigned to the selected PC communication port. If you select Other from the list, you can specify a baud rate. Note The 38,400 baud rate is not supported reliably by all PC communication hardware. If the NetDDE connection is terminated frequently when configured at this rate, reduce the selected baud rate to a value that is more compatible with the PC and communication hardware being used. Otherwise, upgrade PC hardware with support for higher performance UARTs, such as the 16550. 5. In the NetDDE Port Type group, select type of port that NetDDE will use. The following options are available: Direct Connection Nodes are directly connected with a serial cable. Modem The selected PC communication port is attached to a modem. When you select this option, the Modem Configuration group becomes available. For more information on configuring the modem, see "Configuring Modem Details" later in this chapter. Leased Line Modem If two nodes are connected by two modems using a leased or "direct" line, select the Leased Line Modem option. (Such modems must support and be configured for leased line mode.) 6. In the Flow Control group, select a transmit option. RTS/CTS Enables RTS/CTS flow control. DTR/DSR Enables DTR/DSR flow control. 7. Click OK to return to the Serial Configuration dialog box.
6-5
Configuring Modem Details

When you configure modem details, you configure the modem options to be used to initialize the modem attached to the selected PC communication port. To configure modem details: 1. In the Port Configuration dialog box, select Modem in the NetDDE Port Type group. The Modem Configuration options will become available.
In most cases, the default settings for modem parameters provide good performance and do not require modification. However, they can be changed to fine-tune the modem for a specific environment. 2. In the Init String box, verify or change the Hayes-compatible command sequence that is issued to the modem to initialize and configure it appropriately for communications. For more information, see "Modem Initialization String Sequences" later in this chapter. 3. The Dial Prefix string is prefixed to the phone number (specified as part of the Connection Information configuration) each time NetDDE dials the remote node via the modem. Different modems or connected telephone carriers require different options at dial time. (Specific modem requirements for dialing should be found in the manufacturers documentation.) The default prefix specifies the following: D T 4. Tells the modem to dial the appended number. Tells the modem to use the "Tone" mode rather than the "Pulse" mode when dialing.
In the Dial Timeout box, type the number of seconds NetDDE will allow for the modem to connect (after the dial string was issued) before NetDDE times out. In the Dial Retries box, type the number of times NetDDE will redial the remote when the dialing timeout is exceeded. (NetDDE does not detect the busy signal or count rings to determine when to give up.) In the Hangup Timeout box, type long to delay before issuing a hang-up sequence to the modem (after a conversation has terminated). Different modems and telephone carriers may have different requirements for this parameter. Issuing a hang-up command to some modems can prematurely cut off the last control message being sent to the remote modem.
5.
6.
6-6
Chapter 6
Modem Initialization String Sequences

This Init String box in the Modem Details dialog box contains a Hayes compatible command sequence that is issued to the modem to initialize and configure it appropriately for communications. The initialization command string is issued to the modem when the specific communication port is opened for communication or when the modem is reinitialized. The initialization sequence may vary according to the modem being used (initialization sequences will always begin with an AT prefix). To determine the initialization sequence for the modem, see the manufacturers documentation. The default sequence that initially appears specifies the following minimum modem operating characteristics required by NetDDE: Q1 Inhibits the modem from sending responses to commands back to NetDDE. NetDDE does not support symbolic or numeric command responses from the modem. Inhibits the mode from echoing the command strings themselves. This is relevant when dialing and initializing. NetDDE does not support command echoes from the modem. Enables the modem to answer on the first ring if you want to allow the attached modem to receive connections from remote nodes. Otherwise, the command must be changed to S0=0 to disable answering.
E0
S0=1
When changing the initialization command string, you may need to cycle power on the modem or reset the modem before sending it the new initialization string. Modems do not respond to command strings while in data mode. NetDDE uses the DTR signal to reset modems into command mode. If the modem was not initially enabled to respond to the DTR signal, it could ignore DTR and require a manual reset. In some cases, you may need to add the following common parameters to the initialization string: &F &D2 Restores factory default configuration. Configures the modem to respond properly to the DTR signal from NetDDE. For example, to reset the modem into command mode when the DTR signal is toggled by NetDDE. Configures the modem to properly present the Carrier Detect (CD) signal from NetDDE after a connection to the remote modem has been established. NetDDE uses the state of the CD signal to determine when the dialed remote node has answered or when the remote node has hung up.
&C1
Note For NetDDE to connect properly to a modem, the modem must present the DSR (Data Set Ready) signal after initialization. If the DSR signal is low or follows the CD signal, an error will occur. If this occurs, refer to the modem manual for the appropriate DIP switch setting and/or initialization string parameter to use. In general, DSR should NOT follow CD, and should be ON after initialization while the DTR signal from the PC is active. The modem must also respond to the DTR signal and present the CD signal only after a connection has been established.
6-7
Defining Connection Information

You must define the connection information needed to set up the serial links between the local node and the specific remote node. For example, if the serial link to the remote node is direct, you must associate the communication port to be used with the remote node name. If the serial link to the remote node is via a dialup modem, you must associate the communication port and telephone number to be dialed with the remote node name. To define connection information: 1. In the Serial Parameters dialog box, click Define Connection Information. The Connection Information dialog box appears. Initially, the Connection Information dialog box will be blank.
The Connection Information dialog box displays a list of defined serial links and the port and phone number of the selected link. No changes can be entered directly into the text fields of this dialog box. 2. Before defining connection names, verify that the required communication ports have been correctly configured and enabled. The options are described as follows: Connection Name List Contains the remote node names to which serial links can be made from the local node. Added remote nodes will also appear in this list. To add a connection name mapping, see "Adding a Serial Link" later in this chapter. To modify a connection name mapping, see "Modifying a Serial Link" later in this chapter. To delete a connection name mapping, see "Deleting a Serial Link" later in this chapter.
6-8
Chapter 6 Port Port being used to connect to the selected remote node. To select a different port, see "Modifying a Serial Link" later in this chapter. Phone Number Phone number being used to connect to the selected remote node. To enter a different phone number, see "Modifying a Serial Link" later in this chapter. 3. Click Done to return to the Serial Configuration dialog box.
Adding a Serial Link

When you add a serial link, you will define a new serial link to a remote node. To add a serial link: 1. In the Connection Information dialog box, click Add. The Add Serial Connection Information dialog box appears.
2.
In the Connection Node Name box, type the remote node name to which the serial link will be made. This name must match the remote nodes logical node name.
3.
In the Port list, select the PC communication port to be used to connect to the selected remote node. If the serial connection is a direct connection (via RS-232 NULL modem cable) from the local node to the remote node, select the appropriate communication port.
4.
In the Phone Number box, type the telephone number for the modem to be dialed. If the connected modem or telephone carrier supports outside line access or requires pauses during the dialing process, control characters for these functions (for example, commas) can be entered in this box.
5.
Click OK to return to the Connection Information dialog box.
6-9
Modifying a Serial Link

To modify a serial link: 1. 2. In the Connection Information dialog box, select the serial link (represented by the remote node link) to modify. Click Modify . The Modify Serial Connection Information dialog box appears. 3. The options in the Modify Serial Connection Information dialog box are similar to those in the Add Serial Connection Information dialog box. Make any necessary modifications. Click OK.
4.
The revised information will now appear in the Connection Information dialog box.
Deleting a Serial Link

To delete a serial link: 1. 2. In the Connection Information dialog box, select the remote node name associated with the link in the Connection Name List. Click Delete.
6-10
Chapter 6
Viewing Port Status

You can view the status of communication ports, to disconnect active serial connections, or to re-initialize modems. To view port status: 1. Click Port Status In the Serial Configuration dialog box:
The Port Status dialog box appears.
6-11
Port list
Select the communication port for viewing. (Only the ports enabled using the Port Configuration command will be listed.) Note: If the communication port being viewed is directly connected to the remote node (via RS232), the Port Status dialog box will have slightly different options. For more information, see "Port Status for Direct Connect Ports" later in this chapter.
Hang Up
To terminate the telephone connection that has been established via an attached modem, click Hang Up. This option appears only for selected communication ports that have a modem attached. A message box will appear to confirm the termination. Click Yes to terminate or No to cancel.
Initialize Modem
To send the initialization information entered for the modem, click Initialize Modem. Prior to sending the initialization information to the modem, NetDDE toggles the DTR signal to reset the modem and place it into command reception state. This option appears only for selected communication ports that have a modem attached.
Configuration Status
Displays the Configuration settings for the selected communication port. The status area of the dialog box displays the status of the selected communication port and displays one of the following messages reflecting the current status of the selected communication port: Hanging up Waiting Xmt Read to send dial sting Dialed, attempt #N of NNN, waited T of TTT seconds Waiting for connection response from remote node Waiting Xmt Ready to send connect rsp Connected ... no data received Connected Failed Unknown state: NNNN Unassigned
Transmit Ready
Transmit Ready will appear in this
6-12
Chapter 6 field if the line is ready to accept data from NetDDE. If the line is transmitting, Transmitting will appear. Xmit Queue Size In the Xmit Queue Size box, the size of the serial driver queue for transmitting data is displayed.
Rcv Queue Size
In the Rcv Queue Size box, the size of the serial driver queue for receiving data is displayed.
Modem Status
This Modem Status group displays the real-time state of the primary control signals from the connected modem or directly connected PC. If a particular signal is asserted, the corresponding radio button will be highlighted. The following describes each displayed signal: Carrier Detect. Attached modem or PC is successfully connected to the remote node, if set.
CD
DSR
Data Set Ready. Attached modem or PC is powered on and physically connected, if set.
CTS
Clear To Send. Attached modem or PC is ready to accept data from the local node, if set. Ring. Remote modem is ringing, if set. Not all modems support this signal. NetDDE ignores this signal.
RI
When finished click Done to return to the Serial Configuration dialog box.
6-13
Port Status for Direct Connect Ports

If the communication port being viewed is directly connected to the remote node (via RS-232), the Port Status dialog box will appear as follows:
Click Close Port to close the connection to the remote node via the selected PC communication port. The descriptions on the Configuration, Status, Transmit, and Modem Status options are the same for both modem and direct connect ports. For more information on these options, see "Configuring Port Status" earlier in this chapter..
6-14
Chapter 6
7-1
C H A P T E R
NetDDE Status and Statistics Display

This chapter describes the NetDDE status and statistics display commands found on the View menu. It also describes the Window menu commands used to control the display of the status/statistics child windows in the NetDDE program window.
Contents n Introduction n Viewing Status and Statistics Information n Configuring Child Windows
7-2
Chapter 7
Introduction
NetDDE allows you to view the status of ongoing DDE conversations, connections, and routes, as well as the statistics associated with them. Status displays are updated as soon as they happen. Statistics displays (when enabled) are updated at a user-defined poll rate or "manually" when the user requests the update. Use the View menu to choose the type of status and statistics to be displayed. Use the Window menu to control the arrangement and presentation of the status and statistics display windows.
7-3
Viewing Status and Statistics Information

You can select the type of NetDDE status and statistics information to be displayed in the NetDDE program window. You can also activate and show the Wonderware Logger, which is used to display logged error and advisory messages. By default, the status for Network Interfaces , Internode Connections, and DDE Conversations will be displayed when NetDDE is initially started up:
The selected status and statistics (optional) displays appear as child windows with the NetDDE program window.
7-4
Chapter 7
Viewing Network Interfaces

The Network Interfaces child window displays the status and statistics (optional) for each configured network interface and network interface adapter. To view network interfaces, on the View menu, click Networks.
The following table describes the columns for this display. Column Pkts Sent Description Number of network packets that have been transmitted from the local node over the corresponding network interface. Number of network packets that have been received by the local node over the corresponding network interface. Number of bytes that have been transmitted from the local node over the corresponding network interface. Number of network packets that have been received by the local node over the corresponding network interface. Configured network interface. Current state of the connection. "OK" indicates that the network interface is ready and available to establish and conduct internode DDE connections.
Pkts Rcvd Bytes Sent Bytes Rcvd Network Interface Status
Note The Pkts Sent, Pkts Rcvd, Bytes Sent, and Bytes Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
7-5
Viewing Connections
The Internode Connections child window displays status and statistics (optional) on the DDE connections between the local node and all directly connected remote nodes with which NetDDE is actively communicating. To display current DDE connections to remote nodes, on the View menu, click Connections.
The following table describes the columns for this display. Column Pkts Sent Description Number of network packets that have been transmitted from the local node to the corresponding directly connected remote node. Number of network packets that have been received by the local node from the corresponding directly connected remote node. Network interface through which the DDE connection is being made. Name of the remote node to which the local node is connected. Current state of the connection. The following status information may be displayed in this column: "Connected" "Wait Network Connect" "Wait Connect Cmd" "Wait Connect Rsp" "Pause for Memory" "Disconnected" "Unknown (XXXX)" Note The Pkts Sent and Pkts Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
Pkts Rcvd
Layer Node Status
7-6
Chapter 7
Viewing Routes
The Routes child window displays the status and statistics (optional) for all DDE routes originating from the local node or terminating at the local node. A DDE route is defined as a connection between two endpoint nodes irrespective of the number of intermediate hops that are involved in the connection. To display DDE routes, on the View menu, click Routes.
The following table describes the columns for this display. Column Pkts Sent Pkts Rcvd Dest Status Description Number of network packets that have been transmitted from the local node to the corresponding remote node. Number of network packets that have been received by the local node from the corresponding remote node. Name of the remote endpoint to which the connection is being made. Current state of the network connection. The following status information may be displayed in this column: "Wait Network Interface" "Wait Route Response" "Connected" "Disconnected" "Unknown (XXXX)" Note The Pkts Sent and Pkts Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
7-7
Viewing Hops
The Through Node Hops child window displays status and statistics (optional) for all DDE routes on the network that use the local node as a hop node. Although the local node is not an endpoint for any of the DDE traffic displayed in this window, through node traffic does have an impact on available NetDDE resources and performance. To display hop information for the local node, on the View menu, click Hops.
The following table describes the columns for this display. Column Pkts Sent Description Number of network packets that have been transmitted from the local node to the corresponding remote destination node. Number of network packets that have been received by the local node from the corresponding remote source node. Name of the remote node that is using the local node as a hop on its route to the destination remote node. Remote node name to which the hop is being made from the source remote node. Current state of the hop connection. The following status information may be displayed in this column: "Wait Network Interface" "Wait Route Response" "Connected" "Disconnected" "Unknown (XXXX)" Note The Pkts Sent and Pkts Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
Pkts Rcvd
Source
Dest Status
7-8
Chapter 7
Viewing Conversations
The DDE Conversations child window displays the status and statistics (optional) for all DDE conversations originating or terminating at the local node. It identifies the conversing nodes, applications and topics. To display the current DDE conversation information, on the View menu, click Conversations.
The following table describes the columns for this display. Column Pkts Sent Description Number of DDE messages that have been transmitted from the source (client) node\application to the corresponding remote destination (server) node\application|topic . Number of DDE messages that have been received by the source (client) node\application from the corresponding remote destination (server) node\application|topic . Source (client) node\application and the remote destination (server) node\application|topic engaged in a DDE conversation at the local node via NetDDE. Current state of the DDE conversation. The following status information may be displayed in this column: "Wait Init Ack" "OK" "Terminating" "/SN" "/RN" "/SL" "/RL" (Terminate sent on Net) (Terminate received from Net) (Terminate sent locally) (Terminate received locally) "Wait Net Init Ack" "Unknown (XXXX) Note The Pkts Sent and Pkts Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
Pkts Rcvd
Conversation
Status
7-9
Viewing DDE Routes

The DDE Routes child window displays status and statistics (optional) information on DDE conversation routes. This information indicates whether or not DDEaware applications on the local node have established intranode DDE conversation (Local <-> Local) or internode DDE conversations (Local -> Net or Net -> Local). To display DDE route information, on the View menu, click DDE Routes.
The following table describes the columns for this display. Column Pkts Sent Pkts Rcvd Type Description Number of DDE messages that have been transmitted from each DDE route. Number of DDE messages that have been received by each DDE route. Type of DDE route. The following type information may be displayed in this column: "LOCAL->NET" "NET->LOCAL" "LOCAL<->LOCAL" "Unkn:XXXX" Status Current state of the DDE route. The following status on the DDE route may be displayed in this column: "LOCAL->NET" "NET->LOCAL" "LOCAL<->LOCAL" "Unkn:XXXX" Note The Pkts Sent and Pkts Rcvd columns are only displayed if you have enabled the Statistics command on the View menu. (You must also select View Statistics on the Control menu. Access the Control menu by clicking on the NetDDE icon in the top left corner of the program window.)
7-10
Chapter 7
Viewing Statistics
NetDDE allows you to control whether or not statistics are displayed in the enabled child windows. You can enable or disable display of the number of packets (Pkts Sent and Pkts Rcvd) or the number of bytes (Byte Sent and Bytes Rcvd) in open child windows. Byte level statistics are only available for the Network Interfaces display. When you enable statistics, you can choose whether to gather the information "automatically" or "manually." If you choose to display statistics automatically, information is updated in all open child windows periodically by NetDDE (based on the selected poll rate in the NetDDE Preferences dialog box). If you choose to display statistics manually, information is only updated when you position the mouse cursor in the child window and click the left mouse button. To enable statistics, on the View menu, point to Statistics and then click the appropriate command.
Once you have enabled either automatic or manual statistics, you can control the display of statistics for each child window. On the Control menu of child window, click View Statistics.
7-11
Showing the Wonderware Logger

The Wonderware Logger records and displays error, warnings and other advisory messages generated by NetDDE. Although the recorded information can be viewed through the use of a standard text editing tool (for example, Notepad), the Wonderware Logger provides convenient access to the recorded data as well as concurrent viewing of the information being logged in "real time." The logger files generated by NetDDE are named using the date they were created. For example, "19980707.AEH" is the log file for information logged by NetDDE on July 4, 1998. The log file used by NetDDE is shared with other applications, such as InTouch and DDE Servers. Messages logged in the file by NetDDE may be interspersed with messages from other applications, all recorded in chronological order. To bring the Wonderware Logger program display to the forefront of your desktop, on the View menu, click Show WW Logger .
7-12
Chapter 7
Configuring Child Windows

The Window menu contains commands used to arrange information in the NetDDE program window. Since all NetDDE status and statistics information are displayed through specific child windows, you may want to control how the open child windows appear in the NetDDE program window. You can add a horizontal scroll bar to open child windows, or change the font style for the data displayed in the NetDDE program window.
Tiling
To tile information in the program window vertically, click Tile on the Window menu. For example:
7-13
Cascading
To cascade information in the program window, click Cascade on the Window menu. For example:
Tiling Horizontally
To tile information in the program window horizontally, click Tile Horizontally on the Window menu. This display format is the default. For example:
7-14
Chapter 7
Arranging Icons
To arrange child window icons in the NetDDE program window, click Arrange Icons on the Window menu. For example:
Before
After
7-15
Adding a Horizontal Scroll Bar

You can scroll each status and statistics display child window horizontally when the NetDDE program window is too small to display all relevant information. To add a horizontal scroll bar to all open child windows, click Horz Scroll on the Window menu. For example:
7-16
Chapter 7
Changing the Display Font

You can choose the font used to display status and statistics information in the child windows (only fixed pitch fonts are supported). To change the font: 1. On the View menu, click Font. The Font dialog box appears.
2. 3. 4.
Select the desired font from the Font list. Configure the font attributes, such as color, font style, and size. Click OK.
The NetDDE status and statistics information will be displayed using the new font.
Determining Open Child Windows

The lower section of the Window menu lists all open child windows. A checkmark is displayed next to the child window that currently has focus. For example:
In the above example, the Network Interfaces , Connections and Conversations windows are open, with the focus on Network Interfaces .
8-1
C H A P T E R
Testing and Debugging NetDDE

This chapter describes some of the available NetDDE test, trace and debug options.
Contents n Introduction n Testing an Open Connection n Closing an Open Connection n Enabling Debug Menu Commands n Configuring Additional Interface Parameters
8-2
Chapter 8
Introduction
NetDDE provides inter-node connectivity to DDE-aware Windows applications (under most normal circumstances) without testing. However, from within the NetDDE program window, you can: Validate network connections. Enable logging and tracing of DDE messages. Dump the state of NetDDE and configured network interfaces. Modify the additional operating parameters supported by each configured network interface. Warning! Enabling the debug and trace options described in this section significantly impacts NetDDE performance and system resources. Logging should not be enabled unless directed by Wonderware Technical Support. You can verify connectivity between NetDDE programs operating on different nodes of the network or across serial interfaces. You can also enable additional menu items in both the NetDDE Control and Configure menus.
Chapter 8
8-3
Testing an Open Connection

You can open a test connection between the NetDDE program on the local node and a NetDDE program on a specified remote node. You should only verify connectivity between two nodes. After successfully verifying connectivity, be sure to close the test connection. To test an open connection: On the Test menu, click Open Connection. The Name to Connect to... dialog box appears.
In the box, type the logical node name of the remote node to which you want to connect. Click OK. Once the connection is established, information regarding the connection will appear in the Internode Connections window, according to the options enabled in the View menu. For example:
8-4
Chapter 8
If the test connection fails, verify that proper configuration and installation procedures were performed for the local node and the remote node to which you are attempting to connect. Most connection failures are due to improper or incomplete configuration of the underlying network interface. If the connection is serial, ensure that you are using the correct cable and that both nodes are using the same Baud Rate and the same Flow Control protocol. If using modems, make sure that the proper initialization string has been given and the modems are configured properly. Verify that the destination node name is properly mapped to a communication port. If the connection is DECnet or TCP/IP, make sure that the destination node name and address were properly configured when you installed the network interface. Verify that the local node name and address are entered in the remote nodes host table.
Chapter 8
8-5
Closing an Open Connection

Test connections should be closed after successful verification of remote node connectivity. You can also break or terminate connections established through normal conversation initiation procedures, but this is not recommended. To close an open connection: On the Test menu, click Close Connection. The Close Connection With dialog box appears.
To close a single connection, in the Name list, enter the logical node name of the remote node connection to close (or select a remote node name from the list). Then, click Close. In the validation box that appears, click Yes to close the connection or No to return to the Close Connection With dialog box.
To close all open connections, click Close All. In the validation box that appears, click Yes to close all open connections or No to return to the Close Connection With dialog box.
When you are finished closing connections, click Done. The closed connections will no longer appear in the NetDDE program window.
8-6
Chapter 8
Enabling Debug Menu Commands

You can enable access to additional debug configuration parameters for each network interface and access to additional logging and trace options. To enable debug menu commands: On the Test menu, click Enable Debug Menu Items. Debug menus will appear in the Control menu and the Configure menu. To disable debug menu commands: On the Test menu, click Disable Debug Menu Items. Debug menus will be removed from the Control menu and the Configure menu. To access the Control menu in Windows 3.11 or Windows for Workgroups, click button in the top left corner of the NetDDE program window. the To access the Control menu in Windows 95/98, click the corner of the NetDDE program window. icon in the top left
Chapter 8
8-7
Control Menu Debug Commands

If you check the Enable Debug Menu Items command on the Test menu, the following log, trace, and dump options will appear in the Control Menu:
To access the Control menu in Windows 3.11 or Windows for Workgroups, click the control button in the top left corner of the NetDDE program window. To access the Control menu in Windows 95/98, click the NetDDE icon in the top left corner of the NetDDE program window. Warning! Enabling the log, dump, and trace options described in this section significantly impacts NetDDE performance and system resources. Logging should not be enabled unless directed by Wonderware Technical Support.
Log DDE Traffic

Enabling this option causes NetDDE to log all DDE related Windows messages (sent or received by NetDDE on the local node) to the Wonderware Logger. The format of the logged data is similar to the example below:
94/08/29 13:27:54.870/NETDDE C2B2 [s01:TEXT] 0/1 94/08/29 13:27:55.040/NETDDE C2B2 [s01] 94/08/29 13:27:55.090/NETDDE C2B2 [s01:TEXT] "1 INITIALIZED" 0/1 94/08/29 13:27:55.260/NETDDE C2B2 [s01:TEXT] 94/08/29 13:27:55.260/NETDDE C2B2 [s01] /rcvd WM_DDE_REQUEST /rcvd WM_DDE_ACK 51F8 5574 0001 51F8 5574 8000 5574 51F8 4A9E /rcvd WM_DDE_ADVISE /sent WM_DDE_ACK /sent WM_DDE_DATA 51F8 5574 4A9E 5574 51F8 8000 5574 51F8 4A9E
94/08/29 13:27:55.370/NETDDE /sent WM_DDE_DATA C2B2 [s01:TEXT] "2 INITIALIZED" 1/0
8-8
Chapter 8
Log Info
Enabling this option causes NetDDE to log the various internal NetDDE function calls and parameters associated with all DDE data transfers to the Wonderware Logger. This information has no meaning to the general user and is provided only for use by Wonderware Technical Support. The format of the logged data is similar to the example below:
94/08/29 13:30:46.240/NETDDE length 124 94/08/29 13:30:46.300/NETDDE 0CC73546 ) 94/08/29 13:30:46.350/NETDDE 0CC73546 ) 94/08/29 13:30:46.350/NETDDE 0CC73546 ) 94/08/29 13:30:46.350/NETDDE 94/08/29 13:30:46.410/NETDDE 0CC73546 ) 94/08/29 13:30:46.410/NETDDE length 40 ... 94/08/29 13:30:46.460/NETDDE 0CC7356F ) 94/08/29 13:30:46.520/NETDDE 0CC735E3, 0CC7356F ) /PKTZ: Received packet 000000C2 of /RouterPacketFromNet( hPktz:0CC777C8, /RouterProcessDderPacket( 0CC777C8, /DderPacketFromRouter( 0CC7791C, / hDder: 0CC735E3
/IpcXmitPacket( 000051F8, 0CC735E3, /PKTZ: Transmitting packet 00000000 of /DderPacketFromIPC( 0CC735E3, 000051F8, /RouterPacketFromDder( 0CC7791C,
Log DDE Packets

Enabling this option causes NetDDE to log the contents of all DDE messages (received and sent by NetDDE at the local node) to the Wonderware Logger. The format of the logged data is similar to the example below:
94/08/29 13:30:52.670/NETDDE 94/08/29 13:30:53.270/NETDDE 94/08/29 13:30:53.270/NETDDE 94/08/29 13:30:53.330/NETDDE 94/08/29 13:30:53.330/NETDDE 94/08/29 13:30:53.330/NETDDE 94/08/29 13:30:53.380/NETDDE 94/08/29 13:30:53.380/NETDDE 94/08/29 13:30:53.440/NETDDE 94/08/29 13:30:53.490/NETDDE 94/08/29 13:30:53.490/NETDDE 94/08/29 13:30:53.550/NETDDE / /DDEPKT: 0CC7356C / / / / / / / / / / WM_DDE_DATA format: 0001
offsFormat: 0000 fResponse: fAckReq: fRelease: offsItem: item: offsData: sizeData: 00 01 01 0034 "s01" 0038 0000001C
94/08/29 13:30:53.550/NETDDE / 0CC735A4: 32 20 49 4E 49 54 49 41-4C 49 5A 45 44 00 00 00 2 INITIA-LIZED... 94/08/29 13:30:53.600/NETDDE 00 00 00 ........-.... 94/08/29 13:30:53.600/NETDDE / / 0CC735B4: 00 00 00 00 00 00 00 00-00
Chapter 8
8-9
Dump NetDDE State

Enabling this option causes NetDDE to do a one-time dump of its current state to the Wonderware Logger. This information has no meaning to the general user and is provided only for use by Wonderware Technical Support. The format of the logged data is similar to the example below:
94/08/29 13:30:56.680/NETDDE 94/08/29 13:30:59.590/NETDDE 94/08/29 13:30:59.640/NETDDE -> \\LITHIUM\TESTPROT|TOPIC 94/08/29 13:30:59.640/NETDDE 0CC735E3 2 0000 0000 187 187 94/08/29 13:30:59.700/NETDDE 94/08/29 13:30:59.700/NETDDE / /DDEINTF State [Normal Windows]: / / 51F8: 0CC73663 \\PROMETHIUM\WWCLIENT 1 0 1 0 0 0 0 0 0 0 51F8 5574
/DDEINTF State [Terminating Windows]: /DDER State:
94/08/29 13:30:59.750/NETDDE / 0CC735E3: 00000000 00000000 5 1 0013D560 0CC7791C 000051F8 00000000 00000000 00000000 1 1 1 1 0 186 186 94/08/29 13:30:59.750/NETDDE /ROUTER State:
94/08/29 13:30:59.810/NETDDE / 0CC7791C: 00000000 00000000 3 1 "PROMETHIUM" "LITHIUM" "nickel" 188 188 94/08/29 13:30:59.810/NETDDE 0CC735E3 94/08/29 13:30:59.860/NETDDE 00000000 0 1 0 0 94/08/29 13:30:59.860/NETDDE 00000000 0 1 0 0 94/08/29 13:30:59.920/NETDDE / / / 0 30 0 0 100 0 30 "lithium" 0: 0CC777C8 10D7003C 00000000 0 1: 00000000 00000000 00000000 0
/PKTZ State:
94/08/29 13:30:59.920/NETDDE / 0CC777C8: "NETBIOS" 11377E36 1 0 000000D0 000000D0 02 000000CF 000000CF 000000CF 94/08/29 13:30:59.970/NETDDE / 000000D0 0 "NICKEL" "nickel" 1470 10 60000 60000 10000 60000 120000 60000 94/08/29 13:31:00.030/NETDDE / 3 3 3 0 30 413 394 0CC73718 00000000 00000000 00000000 00000000 00000000 94/08/29 13:31:00.080/NETDDE / 00000000 00000000 0CC771EC 0CC73D30 00000000 00000000 00000000 00000000 00000000 00000000 0CC7791C 0 94/08/29 13:31:00.080/NETDDE /
Dump NetDDE Memory

Enabling this option causes NetDDE to do a one-time dump of its global memory usage summary to the Wonderware Logger. This information has no meaning to the general user and is only provided for use by Wonderware Technical Support. The format of the logged data (for the NetBIOS interface) is similar to the example below:
94/08/29 13:31:00.080/NETDDE 94/08/29 13:31:02.060/NETDDE byte Chks, 1024 granules 94/08/29 13:31:02.110/NETDDE FrLs Hg 94/08/29 13:31:02.110/NETDDE 94/08/29 13:31:02.170/NETDDE / /0B470000: "NETDDE" used 1 of 128 32767 / # : hMem Address / / Alloced/BlkSize 19104 7FFF 0
1: 0CC6 p 214368256
Dump "Interface" State
8-10
Chapter 8 Enabling this option causes NetDDE to request a one-time dump of the selected network interfaces state to the Wonderware Logger. The format and content of the data dumped is dependent on the selected network interface. This information has no meaning to the general user and is provided only for use by Wonderware Technical Support. The format of the logged data for the NetBIOS interface is similar to the example below:
94/08/29 13:31:04.310/NETBIOS /NetBIOS State ... 94/08/29 13:31:04.370/NETBIOS /"NICKEL" session: 7E3E state:005F1137 rcvState:0009 xmtState:0000 94/08/29 13:31:04.370/NETBIOS /Receiving NCB 94/08/29 13:31:04.420/NETBIOS /NCB Cmd: 95, RetCode: FF, Lsn: 5F, Num: 00 94/08/29 13:31:04.420/NETBIOS /BufAddr: 113772AE, Length: 1470, CallName: , Name: 94/08/29 13:31:04.480/NETBIOS /Rto: 00, Sto: 00, PostAddr: 0C07005B, LanNum: 00, CmdCplt: FF 94/08/29 13:31:04.480/NETBIOS /
Chapter 8
8-11
Configuring Additional Interface Parameters

When you select the Enable Debug Menu Items command from the Test menu, an additional command for each configured interface will appear at the bottom of the Configure menu. These commands access additional network interface configuration parameters. Any modifications that you make using these parameters will affect all connections using the selected network interface.
Warning! The default parameters used for each network interface are optimal for most network configurations. It is recommended that you consult with Wonderware Technical Support before attempting to change them.
Dialog Box Options for Additional Parameters

The following sections describe all of the options for the network parameter dialog boxes. You can configure a subset of these options for each type of network.
Port Option
For the WinSock network, you can configure the local port number. Option TCP/IP Port Description Local port number used by TCP/IP when attempting to connect to a host. All hosts communicating with each other must have the same port number.
8-12
Chapter 8
Packet Options
Use the packet options to configure the size of the packets and maximum number of unacknowledged packets. Packet options are as follows: Option Packet Size Description Size of network packets to be used over the interface. For the Serial interface, the default value of 512 bytes is optimal for most configurations. Increasing the packet size may improve performance, but it may also make communication susceptible to line-induced data errors. For the WinSock and DECnet interfaces, the default value of 2048 bytes is optimal for most configurations. Max Unacked Pkts Number of unacknowledged packets that NetDDE allows. During normal operation, NetDDE allows several unacknowledged network packets to be outstanding at the interface before pausing to wait for acknowledgment. If the values for this parameter are different at two connecting nodes, the minimum value is used by NetDDE.
Timeout Options
Use the options in the Timeouts group to configure the timeout values (measured in seconds) for the interface. Timeout options are as follows: Option Connect to Remote Low-Level Connect Description Number of seconds that NetDDE will wait before timing out on the connection. Number of seconds NetDDE will wait for a successful low-level connect at the network interface. Low-level connect is command-based rather than packet-based. Number of seconds NetDDE will wait from the time of the initial connect to the time it receives an initial connect packet from the remote node. Number of seconds NetDDE will wait from the time it sends an initial connect packet to the time it receives an initial connect response packet from the remote node. Number of seconds NetDDE will wait to re-transmit a message to the remote node after receiving notification that the remote node is out of memory.
Receive Connect Cmd
Receive Connect Rsp
Out-of-Memory Pause
Chapter 8 (continued) Option No Response Description Number of seconds NetDDE will wait for a transmitted packet to be acknowledged by the remote node before attempting to re-transmit the unacknowledged packet.
8-13
Keep Alive Period
Number of seconds between keep-alive packets that are exchanged between connected NetDDE programs. Keep-alive packets are used as positive acknowledgment that the connection is still functional in the absence of normal DDE message activity. Number of seconds NetDDE will wait for permission from the network interface to transmit an outbound packet before timing out and closing the connection. Number of seconds NetDDE will wait before retransmitting an unsuccessfully transmitted packet.
Xmit Stuck
Partial Xmit Retry Delay
Logging Options
In the Logging group, configure the amount of information that the specific network interface will log to the Wonderware Logger. The following mutually exclusive options are available: Option Log All Problems Log Unusual Problems Dont Log Problems Description Log all problems detected at the network interface. Only log problems that are unusual for the network interface. This is the default option. Disable problem logging.
8-14
Chapter 8
Retry Limits Options

In the Retry Limits group, configure the retry limits enforced by NetDDE after the associated timeout expires. The following options are available: Option Transmission Errors Description Number of times NetDDE will retry transmission of a specific packet to a remote node after that packet has been rejected by the remote node. Number of times NetDDE will retry transmission of a specific packet to a remote node after that node has requested that NetDDE "back off" (due to low memory conditions). Number of times NetDDE will retry transmission of a specific packet to a remote node without receiving any response from the remote node for that packet. Number of times NetDDE will attempt to reestablish a low level connect across the interface to a remote node before terminating the connection. Number of times NetDDE will try to re-transmit an unsuccessfully transmitted packet before closing the connection.
Out-of-Memory Errors
No Response Errors
Low-Level Connect
Partial Xmit Retries
Chapter 8
8-15
Validation Method Options

In the Validation Method group, configure the options to control data authentication performed on NetDDE message packets. For the WinSock network interface, since WinSock uses the TCP/IP transport, providing data authentication, the recommended validation method is None. The other validation methods exist for compatibility with other systems imposing a validation method. For the DECnet network interface, packets transferred over the network interface can be validated for data integrity by computing either a CRC-16 or 32-bit checksum. The following mutually exclusive options are available: Option None Description Disable packet validation. Since TCP/IP guarantees data integrity at the transport layer, this option is the default for the WinSock interface. Enable a Checksum validation method. This method uses a checksum (summing of message contents) to verify data integrity. Note Select this option if you are using the WinSock interface and are connecting NetDDE for Windows to NetDDE for NT, NetDDE for VMS, or NetDDE for UNIX. CRC-16 Enable a CRC-16 validation method. This method uses a 16-bit cyclic redundancy check to verify data integrity. Enable the CRC validation method. This method uses a 16-bit cyclic redundancy check to verify data integrity.
Checksum
CRC
8-16
Chapter 8
Additional NetBIOS Configuration Parameters

To configure additional NetBIOS configuration parameters: On the Configure menu, click NETBIOS Parameters. The NetBIOS Configuration Parameters dialog box appears.
Configure the options for the NetBIOS network. For a list of all dialog box options and their descriptions, see "Dialog Box Options for Additional Parameters" earlier in this chapter. To restore all of the parameters to their original settings, click Restore. To accept all entries, click OK.
Chapter 8
8-17
Additional Serial Configuration Parameters

To configure additional serial configuration parameters: On the Configure menu, click SERIAL Parameters. The Serial Configuration Parameters dialog box appears.
Click General Serial Parameters. (This button appears in the Serial Configuration dialog box only if the Enable Debug Menu Items command is selected on the Test menu.) The General Serial Configuration Parameters dialog box appears.
Configure the options for the Serial network. For a list of all dialog box options and their descriptions, see "Dialog Box Options for Additional Parameters" earlier in this chapter. To restore all of the parameters to their original settings, click Restore. To accept all entries, click OK.
8-18
Chapter 8
Additional WinSock Configuration Parameters

To configure additional WinSock configuration parameters: On the Configure menu, click WWINSOCK Parameters. The WWINSOCK Configuration Parameters dialog box appears.
Configure the options for the WinSock network. For a list of all dialog box options and their descriptions, see "Dialog Box Options for Additional Parameters" earlier in this chapter. To restore all of the parameters to their original settings, click Restore. To accept all entries, click OK.
Chapter 8
8-19
Additional DECnet Configuration Parameters

To configure additional DECnet configuration parameters: On the Configure menu, click DECNET Parameters. The DECNET Configuration Parameters dialog box appears.
Configure the options for the DECnet network. For a list of all dialog box options and their descriptions, see "Dialog Box Options for Additional Parameters" earlier in this chapter. To restore all of the parameters to their original settings, click Restore. To accept all entries, click OK.
8-20
Chapter 8
A-1
A P P E N D I X
Wonderware Logger Messages

This appendix lists and defines the error and warning messages that may appear in the Wonderware Logger for NetDDE and for each network interface. Note Informational messages that may appear in the Wonderware Logger as a result of activating any of the log or dump options (using the Enable Debug Menu Items command on the Test menu) are not included in this appendix.
Contents n NetDDE Messages n Security Messages n NetBIOS Messages n Serial Messages n WWCOMTSR Messages n SDDETSR Messages n WinSock Messages n DECnet Messages
A-2
Appendix A
NetDDE Messages
The following messages may be displayed in the Wonderware Logger for NetDDE: "Adding atom "ITEM_NAME" => NULL" NetDDE needed to add an atom on behalf of client. Client should have done it. Probably a client application error where an atom used in a DDE conversation has been released prematurely. "Cannot load address of "" PROC_NAME"" function from ""DLL_NAME"" DLL" Cannot successfully access the named procedure from the identified network interface DLL. Incorrect DLL version or NetDDE internal error. "Cannot load DLL "DLL_NAME": ERROR_CODE" Cannot load a network interface DLL. Make sure that the named network interface DLL is in the current path. "Couldnt create window for DDE conversation." Could not create a window for the initiated DDE conversation. Insufficient Windows system resources. "DDE_MSG ACK not to an DDE_MSG: [XXXX] ""CLIENT_NAME"" -> ""APP_NAME""" A DDE_MSG acknowledge was addressed by a client to an application that did not have that DDE_MSG outstanding. Application programming error. The following DDE_MSGs could be subject to this error: WM_DDE_ADVISE WM_DDE_DATA WM_DDE_POKE WM_DDE_REQUEST "Data Checksum Error: computed CKS=XXXXXXXX vs. received CKS=XXXXXXXX" "XX XX XX XX ... {a multi-line dump of packet in error}... XX" The computed checksum of a received packet data did not match the checksum value transmitted in the header by the packet source. "Data CKS Err: COMPUTED_CKS vs. DATA_CKS" "XX XX XX XX ... {a multi-line dump of packet in error}... XX" The computed checksum of a received packet data did not match the checksum value transmitted in the header by the packet source. "Data CRC Error: computed CRC=XXXXXXXX vs. received CRC=XXXXXXXX" "XX XX XX XX ... {a multi-line dump of packet in error}... XX" The computed CRC of a received packet data did not match the CRC value transmitted in the header by the packet source. "*** DDEQFree releasing invalid handle XXXX" An invalid handle for a DDE message was passed to be freed. Internal error. "DDER: Detected duplicate node name ""NODE_NAME""" Received a request from another node on the network that has the same node name as the local node. Connection will be aborted. Sort out node naming conventions used on the network. "Error adding atom ""ITEM_NAME"" XXXX ""ATOM_NAME"""
A-3
After attempting to add an atom on behalf of client, the resulting atom name did not match the clients item name. Application programming error where an atom used in a DDE conversation has been pre-maturely freed and re-used. "EXEC of ""COMMAND_LINE"" failed: ""FAILURE_REASON""" Requested DDE_EXEC of the submitted command line failed due to the reason identified by FAILURE_REASON . Verify the command line represented by COMMAND_LINE is correct. "Extraneous WM_DDE_ACK from DDE Client "" CLIENT_NAME"": XXXXXXXX" The client application submitted an unexpected acknowledge message to NetDDE. The lParam value in the acknowledge message is represented by XXXXXXXX. Application programming error. "Extraneous WM_DDE_ACK_EXECUTE from DDE Client ""CLIENT_NAME""" A DDE_ACK_EXECUTE was addressed by a client when there was no outstanding DDE_EXEC message requiring an Ack. Application programming error. "Extraneous ACK apparently to a DDE_MSG "CLIENT_NAME" -> "APP_NAME"" A DDE acknowledge apparently for a DDE_MSG was addressed by a client to an application that did not have anything outstanding requiring an Ack. Application programming error. The following DDE_MSGs can potentially receive extraneous acknowledges: WM_DDE_ADVISE WM_DDE_DATA WM_DDE_POKE WM_DDE_REQUEST WM_DDE_UNADVISE "Extraneous WM_DDE_DATA response from DDE Server ""SERVER_NAME""" The named DDE server sent a data response that was not solicited by the client application. Application programming error at the server. "Failed creating server hPktz." Received a connection request from the low-level network interface but could not create a NetDDE packet server. Insufficient Windows system resources. "GetShareInfo Error: SHARE_NAME" NetDDE was not able to successfully access the identified share name (SHARE_NAME) when attempting to validate a clients credentials for accessing the data represented by the share. Verify that the share name database is not corrupted. "GetShareInfo Size Error: SHARE_NAME" The information associated with the identified share name (SHARE_NAME) is too large for internal NetDDE buffers. Verify that the share name database is not corrupt.
A-4
Appendix A "Header CRC Error: computed CRC=XXXXXXXX vs. received CRC=XXXXXXXX" "XX XX XX XX ... {a multi line dump of packet in error}... XX" The computed CRC of a received packet header did not match the CRC value transmitted in the header by the packet source. "Header Checksum Error: computed CKS=XXXXXXXX vs. received CKS=XXXXXXXX" "XX XX XX XX ... {a multi line dump of packet in error}... XX" The computed checksum of a received packet header did not match the checksum value transmitted in the header by the packet source. "Init of ""DLL_NAME"" failed" Could not successfully initialize the loaded network interface DLL. The network interface DLL may need appropriate network interface drivers to be loaded and network connected. Verify correct installation of the specific network interface. "Invalid application name: ""DST_APP"" from ""SRC_APP""" The destination application name for a DDE conversation submitted by the requesting application is incorrectly formatted. "Invalid network node name: ""NODE_NAME"" from ""SRC_APP""" An incorrectly formatted network node name was submitted by the requesting application. The node name is either greater than the maximum allowed length of 15 characters or it is improperly formatted (contains embedded illegal characters). "IpcInitConversation: null App or Topic atoms" An application attempted to initiate a DDE conversation but supplied a NULL target application or topic name atom. Application programming error. "IpcXmitPacket(%s): null Item atom" An application attempted to transmit a DDE message but supplied a NULL target item name atom. Application programming error. "IpcXmitPkt: UNKNOWN CMD: XXXX" An unknown command was received. Internal error. "Memory alloc failed for RESOURCE" Unable to allocate enough memory for the identified resource. Memory allocation failure can occur during packet data format conversion or copying of DDE messages. The following RESOURCE formats can be affected: metafile bitmap metafilepict WM_DDE_DATA WM_DDE_POKE
Wonderware Logger Messages "Memory lock failed for RESOURCE"
A-5
Unable to lock down memory allocated for the identified resource. Memory lock failure can occur during packet data format conversion or copying of DDE messages. The following RESOURCE formats can be affected: metafile bitmap metafilepict bitmap handle metafile handle WM_DDE_ADVISE WM_DDE_DATA WM_DDE_EXECUTE WM_DDE_POKE "Message: XXXX to non-existent window: XXXX" A message was addressed to a non-existent window. NetDDE internal error. "No application name: ""SRC_APP""" The requesting application did not identify a destination application name in the request. Application programming error. "No metafile in metafilepict" Incorrect metafile request format. "Not enough memory for NNNNNN bytes msg: WM_DDE_EXECUTE" Could not allocate enough memory (NNNNNNNN bytes needed) to perform the DDE_EXECUTE request. "Not enough memory to init heap." Could not allocate sufficient memory to create a private NetDDE heap. "NULL hData from WM_DDE_ADVISE Client: "" CLIENT_NAME""" A DDE_ADVISE request was submitted by a client application for a null data item. Application programming error at the client. "Overflow of queue ( NNN) waiting for initial advise" Depleted internal DDE message queue resources attempting to queue a pending advise request. "PKTZ: Connection wont auto-close ... not enough timers" Unable to terminate a connection due to lack of timers. Too many conversations or NetDDE internal error. "PKTZ: Dest ""NODE_NAME"", Memory error on pktid XXXXXXXX" Receiving node could not accommodate transmitted packet (id XXXXXXXX) due to lack of memory. Packet will be re-transmitted after the "Memory Pause" delay (specified in the configuration parameters of the underlying network interface) has expired. "PKTZ: Dest "" NODE_NAME "", No connect cmd from other side ... closing connection" Results from the "Connect Cmd" timer expiring. The network interface reported a low-level connection with another node but no NetDDE connect command packet was received for a long time (usually 60 seconds).
A-6
Appendix A "PKTZ: Dest "" NODE_NAME "", No connect rsp from other side ... closing connection" Result from the "Response Cmd" timer expiring after establishing a low-level connection with another node and sending a NetDDE connect command packet, no response was received for a long time (usually 60 seconds). "PKTZ: Dest "" NODE_NAME "", No response NNN1/NNN2 for pktid XXXXXXXX" No response for a transmitted packet was received for a time period determined by the "Response" timer configuration value. The packet will be retranslated for the number of "Retries" specified (NNN2) by the configuration parameter (usually 3 retries) before failing the connection. NNN1 represents the current retry number on the specific packet. "PKTZ: Dest "" NODE_NAME "", Out of timers for memory pause ... closing connection" Could not start a "Memory Pause" timer due to lack of timers after receiving a "memory error" on a transmitted packet from the receiving node. Closing connection as a result. "PKTZ: Dest ""NODE_NAME "", Paused for remote side to get memory, retrying ..." The other side of the connection ran out of memory and requested this node to suspend sending data for the time specified by the "Memory Pause" timer configuration value. "PKTZ: Dest "" NODE_NAME "", Rcvd PACKETID1 Expecting PACKETID2, status: XXXXXXXX" Received a packet (PACKETID1) with a sequence number other than the one expected (PACKETID2). One or more packets have been lost in transit between connected nodes. The other node should detect the error and re-transmit the lost packets. Unreliable connections are the usual cause for packet sequence errors. "PKTZ: Dest "" NODE_NAME "", Too many no response retries ( NNN) for packet id XXXXXXXX ... closing connection" No response for a transmitted packet was received after several attempts (NNN retries) at re-transmitting the subject packet (id XXXXXXX). The connection will now be terminated. "PKTZ: Dest "" NODE_NAME "", Too many retries for memory errs (NNN) ... closing connection" Sending node retried too many times (NNN times) transmitting a packet to a node that could not accommodate the packet due to lack of memory. The connection as a result is broken. "PKTZ: Dest ""NODE_NAME"", Too many timeout retries for no response (NNN) ... closing connection" Too many timeout retries (NNN) attempting to reach a connected node (NODE_NAME) without any response from that node. Verify that the two nodes are still physically connected and that the underlying network interface software at both nodes is still functional. "PKTZ: Dest "" NODE_NAME "", Too many xmt error retries (NNN) ... closing connection" Too many retries (NNN) for transmission errors on the same packet. Connection will be broken.
Wonderware Logger Messages "PKTZ: Dest "" NODE_NAME "", Xmt error on pktid PACKETID "
A-7
Errors were detected during packet ( PACKETID) transmission. Packet will be retransmitted. "PKTZ: Dest "" NODE_NAME "", Xmt timeout (NNN secs) ... closing connection" Results from the "Transmit Stuck" timer expiring. The network interface did not respond to the transmit request for a long time (usually after 120 seconds). This is usually an indication that the underlying network interface has failed abnormally. "PKTZ: Node "" NODE_NAME "", does not speak any of our protocols" A NetDDE connection could not be established because the connecting node did not support any common protocol dialects with this node. Different NetDDE implementations may support additional proprietary protocol dialects communicating nodes; however, need to support at least one common "core" dialect. Incompatible NetDDE versions attempting to communicate. "PKTZ: Node "" NODE_NAME "", returned an invalid protocol: NNN" The connected node selected an invalid protocol dialect from the list of supported protocol dialects offered during the session negotiation process. Connection cannot be established. Incompatible NetDDE versions attempting to communicate. "PKTZ: Their name ""THEIR_NAME"" was same as ours "OUR_NAME""" The remote node (THEIR_NAME) reported that its name was the same as ours (OUR_NAME). Connection will be broken. Verify that the assigned network node names are unique and all communicating nodes are properly configured. "PKTZ: Their name was not "" NODE_NAME """ The network interface delivered a NetDDE packet to a node whose NetDDE local node name was not the one addressed by the packet. This can occur when the NetDDE local node name is not the same as the one used by the network interface and it was not declared as an alias at the destination node. Node name mismatch commonly occurs on TCP/IP and DECnet networks. Make sure that appropriate "alias" definitions have been made at the remote node when the network interface was selected. "PKTZ: Unusual connect error with "" NODE_NAME "": XX/XX" An unusual response was returned by the node to which a connection was attempted. Verify proper NetDDE versions on connecting nodes. "PKTZ: Unusual connect name error from "" NODE_NAME "": XX" An unusual name class response was returned by the node to which a connection was attempted. Verify proper network interface node address configuration. "ROUTE ERROR 001: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": no memory" Memory resources required to establish route depleted.
A-8
Appendix A "ROUTE ERROR 002: "SRC_NODE"->"DEST_NODE" @ "HOP_NODE": connection with the next node failed" Unable to connect to the destination node. This is the most common error logged when one node is unable to reach another node . Connection with next node in the route path was broken. Route will be terminated. Check the routes table, underlying network interface or destination node for correct network interface configuration. Check network interface host tables, if relevant. "ROUTE ERROR 003: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": addl info after final destination reached" Route definition improperly formed. Extraneous information in route definition. "ROUTE ERROR 004: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": no addl info and final destination not reached" Route definition improperly formed. Insufficient information in route definition. "ROUTE ERROR 005: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": connection failed during route setup" Unable to establish defined route due to connection failure. "ROUTE ERROR 006: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": route string too long (circular?)" Route definition exceeds maximum length of 512 bytes. Check for circular definitions. "ROUTE ERROR 007: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": node name in route string too long" Route definition improperly formed. Node name string exceeds maximum allowed node name size of 16 bytes. "ROUTE ERROR 008: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": connection table netintf not found" Specified network interface for the route was not found in the connection table. Verify route definition. "ROUTE ERROR 009: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": connection table: no netintf to map name" All network interfaces in the connection table were tried unsuccessfully to establish the defined route. Verify route definition. "ROUTE ERROR 010: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": too many hops ... likely circular route" Detected too many hops in the defined route. Route definition circular. "ROUTE ERROR 011: " SRC_NODE"->"DEST_NODE" @ "HOP_NODE": Circular route ... same node in and out" Route definition is circular. Redundant node specified. "ROUTE ERROR XXX: "SRC_NODE"->"DEST_NODE" @ "HOP_NODE": unknown" Unknown route error code XXX. (NetDDE internal error.) "Route wont auto-close ... not enough timers" Unable to terminate a route due to lack of timers. Too many conversations, hops, or an NetDDE internal error.
Wonderware Logger Messages "RTR: Exceeded 100 expands in routing lookup!"
A-9
A route for connecting to a node must have been defined incorrectly and contained an implied loop. Verify route definition. "RTR: Unexpectedly got a NULL router in ProcessHopBroken!" A node serving as an intermediate node for a connection could not find a Router after detecting the hop broken. NetDDE internal error. "Shutting down NetDDE." NetDDE is being terminated. User selected the Close command from the NetDDE Control menu. "Too many terminates received or wrong window" "hWnd: XXXX, wParam: XXXX, hWnd->localWnd: XXXX" "SL: n, RL: n, SN: n, RN: n" A DDE conversation terminated improperly with either too many terminate messages or mis-addressed messages. The subject window handles are identified along with state information. NetDDE internal error or application programming error. "USERDDE: NOT ENOUGH MEMORY" Not enough memory to do duplicate a DDE message in preparation for transfer. Insufficient system memory resources. "USERDDE: Too many private clipboard formats ( NNN max)" Number of available clipboard format structures exhausted trying to register a new private clipboard format. "VerifyData: Verify method specified in received packet unknown: XXXXXXX " The selected verification method for the packet was invalid. Currently only the vertical 32-bit checksum and CRC-16 methods or no verify method are supported. "VerifyHdr: Verify method specified in received packet unknown: XXXXXXXX " The selected verification method for the packet was invalid. Currently only the vertical 32-bit checksum and CRC-16 methods or no verify method are supported. "WM_COMMAND wParam: XXXX, undefined interface select", or "WM_SYSCOMMAND wParam: XXXX, undefined interface select" An undefined network interface was selected from the Configure or debug menu. NetDDE user interface internal error. "WM_DDE_ACK_EXECUTE from DDE Server "" SERVER_NAME "" not matching DATA: XXXX " The server application submitted a DDE acknowledge message for a DDE Execute command that did not match the DDE data needing an acknowledge. Application programming error. "WM_DDE_ACK from DDE Client "" CLIENT_NAME "" not matching DATA: XXXX " The client application submitted a DDE acknowledge message that does not match the DDE data message requiring an Ack. Application programming error.
A-10
Appendix A "WM_DDE_ACK rcvd, WinInfo Unknown state: NNN " A DDE acknowledge was received while the NetDDE was in an unknown internal state. NetDDE internal error or application programming error. "WM_DDE_DATA from DDE Server " SERVER_NAME" not matching REQUEST: XXXX" The named DDE server sent a data response that does not match the outstanding client data request. Application programming error at the server. "Wrong version of " DLL_NAME": SPEC_VERSION." "Disabling this interface." The network interface DLL supports an incorrect protocol specification version. NetDDE is not able to communicate to it effectively. Check for correct version of the selected network interface DLL. This can happen when old versions of network interface DLLs are kept around.
Internal NetDDE Errors

The following internal NetDDE errors may be logged to Wonderware Logger. If any such error message is found in the logger, please report it to Wonderware Technical Support along with a description of the circumstances under which such an error occurred. "Bad NetDDE child window type: NNN" "Bad paint call: NNN" "Could not create password dialog box" "Unable to add ""NODE_NAME"" alias. Too many declared." "Unable to add to msg queue. Newest: NNN, Oldest: NNN, Entries: NNN" "Unable to delete "" NODE_NAME "" alias. Not declared."
A-11
Security Messages
The following security messages may be displayed in the Wonderware Logger: "AddPasswordToCache: invalid security type: NNN" Unable to cache a password due to an invalid security type code. Internal error. Verify that the correct NDDEAPI.DLL is in the current path. "Domain name buffer too small." Buffer supplied to capture the domain name for an NT connection is too small. Internal error. "GetPasswordFromCache: invalid security type: NNN" Unable to get a password from cache due to an invalid security type code. Internal error. Verify that the correct NDDEAPI.DLL is in the current path. "Invalid share: SHARE_NAME." The share name (SHARE_NAME) used to access security information is improperly formatted. "Loading security information failed." Attempt to load old style security information from the NETDDE.INI file failed. Security information in the NETDDE.INI file was available but improperly formatted. Verify that the NETDDE.INI file is not corrupted and that the security information entered in that file is properly formatted. "NetWkstaGetInfo() returned error: NNN" Call to get workstation information from the Windows for Workgroups operating system returned an error (NNN). Verify that the proper version of the Windows for Workgroups operating system is being used. "PasswordGetFromUserModeless: invalid security type: NNN" Invalid security type returned by dialog used to get password from user. Internal error. "SECURITY VIOLATION: Advise ""ITEM_NAME""" The permissions associated with the addressed item (ITEM_NAME) do not allow "read" access. Verify that security for this node is configured appropriately. "SECURITY VIOLATION: Execute" The permissions associated with the application and topic for this conversation do not allow "execute" access. Verify that security for this node is configured appropriately. "SECURITY VIOLATION: Init \\\\NODE_NAME\\APP_NAME -> APP_NAME|TOPIC_NAME" The permissions associated with application and topic name at this node do not allow initiation of DDE conversations from remote nodes. Verify that security for this node is configured appropriately. "SECURITY VIOLATION: Poke "" ITEM_NAME """ The permissions associated with the addressed item (ITEM_NAME) do not allow "write" access. Verify that security for this node is configured appropriately. "SECURITY VIOLATION: Request "" ITEM_NAME """ The permissions associated with the addressed item (ITEM_NAME) do not allow "read" access. Verify that security for this node is configured appropriately.
A-12
Appendix A "Share name size limit exceeded." The referenced share name formed from the addressed application name and topic name is not valid. It is too long (greater than 64 bytes). "User name buffer too small." The buffer used to get the user name is too small. Internal error. "WNetCachePassword() returns odd status: XXXX" Call to Windows for Workgroups password cache API returned odd status. Verify that proper Windows for Workgroups version is installed. "WNetGetCachedPassword() returns unknown status: XXXX" Call to Windows for Workgroups get password cache API returned odd status. Verify that proper Windows for Workgroups version is installed.
A-13
NetBIOS Messages
The following messages may be displayed in the Wonderware Logger for NetBIOS network interface: "Install check for 2.0 version failed. Version installed: NNN" Checking for a NetBIOS of version 2.0 or greater. Instead, found installed NetBIOS to be version NNN. Informative message under LogAll option. "Lana enum requested failed: 0 size buffer returned ( int21 0x5f80 )" Although a NetBIOS of version 2.0 or greater is installed, the request to enumerate the number of LAN adapters supported by the interfaced failed. NetDDE will assume that at least one adapter is supported and its lananum is 0. "Listen failed: "ERROR_MSG"" Unable to set up a listen for connections on the NetBIOS interface. The error message returned by the NetBIOS network interface is appended in the following list of ERROR_MESSAGES. ""NODE_NAME": Connect failed: " ERROR_MSG"" The low level network interface was unable to connect to the specified node name. The error message returned by the NetBIOS network interface is appended in the following list of ERROR_MESSAGES. ""NODE_NAME": Recv err: "ERROR_MSG"", The low level network interface detected an error while receiving from the specified node name. The error message returned by the NetBIOS network interface is appended in the following list of ERROR_MESSAGES. ""NODE_NAME": Send err: "ERROR_MSG"", The low level network interface encountered an error while sending to the specified node name. The error message returned by the NetBIOS network interface is appended in the following list of ERROR_MESSAGES. "Node Name too long for connect on NetBIOS: " NODE_NAME"" The node name of the destination node to which a connection is attempted is too long for the NetBIOS interface. The destination node name must be 16 characters or less. "Not enough memory for Listen NCB" Depleted memory resources attempting to allocate memory for a listen network control block.
A-14
Appendix A "Unable to delete our name "NODE_NAME", status = XX" While shutting the network interface down, the node name could not be retracted from the NetBIOS interface. The following list of ERROR_MESSAGES can be returned to NetDDE by the low-level NetBIOS network interface implementation: "01: Invalid buffer length" "02: "03: "05: "06: "07: "08: "09: Buffers are full, no receive issued." Invalid command" Command timed out" Incomplete received message - packet size mismatch?" Local No-Ack command failed" Invalid local session number" No resource available in remote session table"
"0A: Session has been closed by remote partner" "0B: Command was canceled" "0C: PC DMA failed" "0D: Duplicate name in local NetBIOS name table" "0E: NetBIOS name table full" "0F: Name has active sessions and is now deregistered" "10: "11: "12: "13: "14: "15: "16: "17: "18: "19: Name was not found or no valid name exists" NetBIOS local session table full" Session open rejected because no remote listen is outstanding" Illegal name number" Cannot find name called or no answer" Name not found" Name in use on remote adapter" Name deleted" Session ended abnormally" Name conflict detected"
"1A: Incompatible remote device" "21: "22: "23: "24: "25: "26: "30: "33: "34: NetBIOS Interface busy" Too many commands outstanding" Invalid LAN Adapter number" Command completed during cancel attempt" Reserved name specified for Add Group Name" Command not valid to cancel" Name defined by another process" Multiple requests were made for the same session" NetBIOS environment not defined"
Wonderware Logger Messages "35: "36: "37: "38: "40: "41: "42: "43: "45: Required O/S resources exhausted" Maximum applications exceeded" No SAPs available for NetBIOS" Requested resources not available" Undocumented system error" Hot carrier from a remote adapter detected" Hot carrier from local adapter detected" No carrier detected" Interface failure occurred"
A-15
"4E: Status bit 12, 14, or 15 on Longer than 1 minute" "4F: One or more of status bits 8-11 on" "50: Network adapter malfunctioned"
"F7: Error on implicit DIR.INITIALIZE" "F8: Error on implicit DIR.OPEN.ADAPTER" "F9: IBM LAN support program NetDDE internal error" "FA: NetDDE internal error on NetBIOS card" "FB: NetBIOS program not loaded in PC" "FC: DIR.OPEN.ADAPTER or DLC.OPEN.SAP Failed" "FD: Unexpected adapter close" "XX: Hardware error on NetBIOS card" "XX: Unknown NetBIOS error"
A-16
Appendix A
Serial Messages
The following messages may be displayed in the Wonderware Logger for the SERIAL network interface: "COMn: already in use" The port selected for making a connection is already in use. Try using another port or close the other connection first. "COMn: No memory for new connection" Depleted memory resources while attempting to start a new connection. "COMn: not enabled" An attempt to connect via COM "n" was made without the selected port being enabled. Enable the port using the "Port Configuration" dialog box before attempting connections. "COMn: restarted" COM port "n" is restarted as a result of receiving a new connection while the preceding one was still active. "COMn: Unknown frame rcvd: XX" Unknown frame type "XX" received over COM "n". ""NODE_NAME": CD never went low after DTR set low" The modem carrier signal did not go low after NetDDE attempted to break the connection to "NODE_NAME" by toggling the DTR signal. ""NODE_NAME" connect failed, no carrier after N dials" The connection attempt to "NODE_NAME" failed when a carrier was not sensed after "N" retries. This characteristic applies only to modem connections. Verify the proper baud rate and phone number. ""NODE_NAME" connect failed, no connect response after N tries" The connection attempt to "NODE_NAME" failed when a response was not received after N retries. ""NODE_NAME": COMn: configured as modem, must specify phone number" The communication part was configured for a modem, so when connecting to "NODE_NAME" via the COM "n" port, a phone number is required. Verify that a phone number is specified for "NODE_NAME" in the Define Connection Name dialog box. ""NODE_NAME": COMn: not a modem " An attempt was made to connect to the specified "NODE_NAME" by dialing a phone number over COM "n" port, however, a modem was not configured on that port. Verify proper configuration of serial ports in the Port Configuration dialog box. ""NODE_NAME": Lost carrier" The modem carrier signal was lost while connected to "NODE_NAME". Connection broken. The communication line link must be broken or was hung up.
Wonderware Logger Messages ""NODE_NAME": New connection - closing existing"
A-17
A new connection was received over the same port. Existing connection is closed. ""NODE_NAME": no modem port available" An attempt was made to connect to the specified "NODE_NAME" by dialing a phone number, however, a modem was not configured for the Serial interface. Verify proper configuration of serial ports in the Port Configuration dialog box. ""NODE_NAME" not enough memory" Not enough memory was available to setup a connection to the named node. ""NODE_NAME": Other side closed connection" A connection to "NODE_NAME" was dropped by the other side. "No ports configured in SDDETSR - failing initialization" The SDDETSR must be configured with at least one port that the Serial interface DLL can use. "SDDETSR Not Loaded - failing initialization" The Serial interface DLL requires the SDDETSR be loaded and resident before invocation of Windows.
A-18
Appendix A
WWCOMTSR Messages
The following are the messages and their definitions which may be displayed on the screen when attempting to load the Wonderware WWCOMTSR: "*** Cannot find parent. Can only be executed as a child." "*** Invoke Serial Comm TSR via WWCOMTSR.EXE" Attempted to execute the distributed file WWCONF.EXE which can only be executed when it is spawned by WWCOMTSR. Do not execute WWCONF.EXE directly. "*** Cannot unload WWCOMTSR. Other users still active." " Unload other users (e.g., SDDETSR) first." The previous two messages appear together when the user attempts to unload the TSR while it is being used by another TSR. " COMx serial port configured."
Acknowledges successful configuration of each specified or defaulted communication port. " Enter any key to exit ..."
Appears after all error messages to bring attention to the preceding error message before it scrolls off. " Installing Serial Comm TSR at interrupt XX"
Acknowledges successful installation of the TSR at the specified or defaulted soft interrupt vector. "*** Invalid parameter: XXXXXX" An invalid parameter was entered on the command line. This message shows the invalid parameter XXXXXXX. "*** No current instance of WWCOMTSR found to unload." " Unload request superfluous." An attempt to unload the TSR was not successful since no current instance exists. "*** No free soft interrupt between 60h and 66h. Installation failed" " Remove one of the drivers or programs using soft interrupts." Unable to automatically find a free soft interrupt vector in the valid interrupt vector range. All interrupts must be occupied by other drivers. "*** Port I/O address assignment "BAD_PARAMETER" parameter error." Incorrect syntax was entered on the command line assigning an I/O address to the COM port. For example, valid syntax is "... COM3:1,4,4,3E8 ...". "*** Port interrupt assignment out of range: NNN." An out of range value was entered on the command line assigning an interrupt level to the COM port. Valid interrupt assignments range between 2 and 7. "*** Receive buffer size of NNNN is out of range" " Acceptable receive buffer size ranges from 4 to 32768." Unsuccessful attempt to assign an out of range buffer size was received. "*** Selected Soft Interrupt XX already occupied."
Wonderware Logger Messages " Try selecting another soft interrupt or use auto mode."
A-19
The specified soft interrupt vector conflicts with an existing driver. "*** Selected Soft Interrupt XX is out of range." Unsuccessful attempt to assign an out of range soft interrupt vector to the TSR. Valid range is 60 to 66. "*** Too many extraneous characters in parameter string: BAD_PARAMETER" Characters entered on the command line do not belong to any acceptable parameter. Please check the syntax. "*** Transmit buffer size of XXXX is out of range" " Acceptable transmit buffer size ranges from 4 to 32768" Unsuccessful attempt to assign an out of range transmit buffer size. "*** TSR parent version PARENT_VER differs from TSR child version CHILD_VER.", " Make sure that WWCOMTSR.EXE and WWCONF.EXE are from same release."); The two files used by the TSR are of different revision levels. Please make sure they are correctly copied from the same release. " Unloading Serial Comm TSR from XX"
Acknowledges successful unloading of the TSR from the interrupt vector XX to which it was previously hooked. Memory occupied by TSR is freed. This is in response to the /U command line switch.
A-20
Appendix A
SDDETSR Messages
The following are the messages and their definitions which may be displayed on the screen when attempting to load the Wonderware SDDETSR: "*** Cannot find parent. Can only be executed as a child." " Invoke Serial NetDDE TSR via SDDETSR.EXE" Attempted to execute the distributed file SDECONF.EXE which can only be executed when it is spawned by SDDETSR. Do not execute SDECONF.EXE directly. " COMx serial port configured." Acknowledges successful configuration of each specified or defaulted communication port. "*** COMx serial port not configured in WWCOMTSR." " To use this port, reload WWCOMTSR specifying all desired ports." The communication ports selected for use by the Serial NetDDE TSR, via the command line or default, was also selected when the Wonderware Serial Comm TSR (WWCOMTSR) was loaded. " Enter any key to exit ..." Message appears after a severe message, allowing the user time to read the error message before proceeding. " Installing Serial NetDDE TSR at interrupt XXh" Acknowledges successful installation of the TSR at the specified or defaulted soft interrupt vector. "*** Invalid parameter: XXXXXX" An invalid parameter was entered on the command line. This message is showing the bad parameter XXXXXXX. "*** No current instance of SDDETSR found to unload." "Unload request superfluous." Unsuccessful attempt to unload the TSR when it was not loaded. "*** No free soft interrupt between 60h and 66h. Installation failed" " Remove one of the drivers or programs using soft interrupts." Unable to automatically find a free soft interrupt vector in the valid interrupt vector range. All interrupts must be occupied by other drivers. "*** Selected Soft Interrupt XX is out of range." Unsuccessful attempt to assign an out of range soft interrupt vector to the TSR. Valid range is between 60 and 66. "*** Selected Soft Interrupt XXh already occupied." " Try selecting another soft interrupt or use auto mode." The specified soft interrupt vector conflicts with an existing driver. Try another one. "*** Serial Comm TSR needs to be loaded first. Load by invoking WWCOMTSR." The low-level Serial Comm TSR (WWCOMTSR) must be loaded first and currently resident, before the Serial NetDDE TSR can be loaded. It is possible that interrupt vector to the WWCOMTSR has been overwritten or re-mapped.
Wonderware Logger Messages "*** Serial Comm TSR already loaded - reboot to reload, or" " Unload by invoking WWCOMTSR with the /U option."
A-21
Only one instance of the TSR can be resident in memory at one time. An attempt was made to load a redundant instance of the TSR. "*** Serial NetDDE TSR already loaded - reboot to reload, or" " unload by invoking SDDETSR with the /U option." Only one instance of the TSR can be resident in memory at one time. An attempted was made to load a redundant instance of the TSR. " Unloading Serial NetDDE TSR from XXh"
Acknowledges successful unloading of the TSR from the interrupt vector XX to which it was previously hooked. Memory occupied by TSR is freed. This is in response to the /U command line switch.
A-22
Appendix A
WinSock Messages
The following messages may be displayed in the Wonderware Logger for the WinSock network interface: "AsyncWindowProc: WINSOCK_EVENT error WSAERRORCODE on socket SOCKET_NUMBER" A WinSock message was received indicating an error has occurred for a specific asynchronous event. "Changing the TCP/IP Port will require you to change on this every node in your system! Are you sure you want to change this?" This warning message states that changing the port number on the local host requires that all hosts which will connect to the local host will need to have matching port numbers to establish a connection. "ConnectToHost: connect() failed, WSAERRORCODE" The connect call to the specified host failed with the error specified by WSAERRORCODE. "Copyright (c) 1993 Wonderware Software Development Corp. All rights reserved." Informational copyright message. "Local host HOST_NAME is not in the host table. Please add HOST_NAME to host table." The local host name was not found in the host table. HOST_NAME is the NetDDE node name and must be entered in the host table for the WinSock interface to initialize properly. "Maxiumum Sockets supported: NNNNNN" Maximum number of sockets supported by the TCP/IP vendors WinSock. "NDDEAddConnection: bind() failed, error: ERROR_CODE" Unable to bind a socket. The error code specifies the reason. "NDDEAddConnection: connect() failed, error: ERROR_CODE" Attempt to connect failed. The error code specifies the reason.
Wonderware Logger Messages "NDDEAddConnection: socket() failed, error: WSAERRORCODE" Unable to create a socket. The error code specifies the reason. "NDDEAddConnection: Unknown host HOST_NAME. error: WSAERRORCODE"
A-23
Host name and address were not in the host table. Enter the host name and Internet address into the host table. "NDDEShutDown: No listen was outstanding at shutdown." No listen socket existed at shutdown. This is an internal anomaly which indicates that the listen socket was destroyed before NetDDE shutdown. "NODE_NAME not in host table. Please configure host table properly." Specified node name was not found in the host table. Enter the host name and Internet address into the host table. "ReceiveAllData: Receive Error = WSAERRORCODE, Socket = NNNNN, BufferSize = NNNNN" A receive error occurred while trying to read data. The most common occurrence of this message is for a WSAEWOULDBLOCK. In this case, there is either inadequate buffer space or no data pending to be read. If the buffer is less than the NetDDE buffer size, then the buffer space for WinSock should be increased. "SendData: Too many partial Tx retries on same packet: NNN/NNN.NNN" Too many attempts were made to transmit the same packet. The connection will be closed. "SetAsyncEvents: socket NN, hwnd NNNN" A bad socket identifier or Async window handle was identified while setting asynchronous socket attributes. Internal application error. "SetupListen: bind() failed. WSAERRORCODE" Unable to bind the listen socket. The creation of listen socket failed during binding. The WSAERRORCODE specifies the WinSock error. "SetupListen: listen() failed. ERROR_CODE" Unable to create the listen socket. The creation of listen socket failed during the initialization. The WSAERRORCODE specifies the WinSock error. "SetupListen: socket() failed. WSAERRORCODE" Unable to create the listen socket. The creation of listen socket failed during the establishment of the socket. The WSAERRORCODE specifies the WinSock error. "Unable to resolve address for host HOST_NAME. error: WSAERRORCODE" WinSock was unable to resolve the hostname. Verify that the host name is in the host table or if a DNS is being used, the DNS is reachable, and the host name exists. "WinSock initialization error: ERROR_CODE" WinSock initialization error in WSAStartup. WinSock internal error. WWinSock initialization will fail. "WSAAsyncGetHostByName failed: WSAERRORCODE"
A-24
Appendix A WinSock was unable to resolve the host name because the function which retrieves the host name reported an error. Verify that the host name is in the host table. Or, if a DNS is being used, verify that the DNS is reachable and the host name exists. "WWINSOCK vN.NN... Node NODE_NAME" Informational message providing WinSock version number and node name.
Log All Problems Option

The following error messages will appear if the Log All Problems option is selected in the WINSOCK Configuration Parameters dialog box. "NDDETimeSlice: Closing Connection to host HOST_NAME on socket NNNNN" Informational message stating that WinSock is closing a connection. "SendData: Connection closed while trying to send" WinSock received a close indication while trying to send data. The connection will be closed. "SendData: NN partial Tx retries on same packet: NN/NN.NN NN" Informational message stating that a packet has been partially transmitted N number of times. "WINSOCK_VENDOR_TEXT" WinSock vendor provided text. WinSock receives this text as part of its WinSock initialization procedure.
Log Unusual Problems Option

The following error messages will appear if the Log Unusual Problems option is selected in the WINSOCK Configuration Parameters dialog box. "AcceptConnection: accept() failed, error: ERROR_CODE" An attempt to accept a connection from another host failed. The error code specifies the reason. "Changes take effect next time NetDDE is run" For the WinSock configuration parameters that were changed to take effect, NetDDE will have to be closed and reopened. "CreateAsyncWindow: CreateAsyncWindow failed" WinSock was unable to create its Async window. WinSock initialization will fail. "CreateAsyncWindow: Register failed." WinSock was unable to register its window class. WinSock initialization will fail. "NODE_NAME: Verify Error, closing connection" A validation error on a packet occurred in the message header or message data. The connection will be closed. "SendData: Retxmt required. WSAERRORCODE" An unusual error occurred which requires retransmission of a packet. The error code specifies the reason. "SendData: send() failed, error: WSAERRORCODE"
A-25
A packet was unsuccessfully sent, with the error code specifying the reason. The packet will be resent. "SetAsyncEvents() Failed" WinSock was unable to properly initialize the new socket with asynchronous attributes. The following ERROR_CODEs are returned by the low-level WinSock interface in response to various commands. WSAEACCES Permission denied. WSAEADDRINUSE The specified address is already in use. (See the SO_REUSEADDR socket option under setsockopt().) WSAEADDRNOTAVAIL The specified address is not available from the local machine. WSAEAFNOSUPPORT The specified address family is not supported by this protocol. WSAEBADF Bad file number. WSAECONNABORTED The virtual circuit was aborted due to timeout or other failure. WSAECONNREFUSED The attempt to connect was forcefully rejected. WSAECONNRESET The virtual circuit was reset by the remote side. WSAEDESTADDRREQ A destination address is required. WSAEFAULT The addrlen argument is too small (less than the size of a struct sockaddr). WSAEHOSTDOWN The host is down. WSAEHOSTUNREACH Unable to connect to specified host. WSAEINPROGRESS A blocking Windows Sockets call is in progress. WSAEINTR The (blocking) call was canceled via WSACancelBlockingCall(). WSAEINVAL listen() was not invoked before an accept(). WSAEISCONN
A-26
Appendix A The socket is already connected. WSAELOOP An illegal loopback operation. WSAEMFILE The queue is empty upon entry to accept() and there are no descriptors available. WSAEMSGSIZE The datagram was too large to fit into the specified buffer and was truncated. WSAENAMETOOLONG The specified name is too long. WSAENETDOWN The Windows Sockets implementation has detected that the network subsystem has failed. WSAENETRESET The connection must be reset because the Windows Sockets implementation dropped it. WSAENETUNREACH The network cant be reached from this host at this time. WSAENOBUFS No buffer space is available. WSAENOPROTOOPT The option is unknown or unsupported. In particular, SO_BROADCAST is not supported on sockets of type SOCK_STREAM, while SO_ACCEPTCONN, SO_DONTLINGER, SO_KEEPALIVE, SO_LINGER and SO_OOBINLINE are not supported on sockets of type SOCK_DGRAM. WSAENOTCONN The socket is not connected (SOCK_STREAM only). WSAENOTSOCK The descriptor is not a socket. WSAEOPNOTSUPP The referenced socket is not a type that supports connection-oriented service. WSAEPFNOSUPPORT Protocol format not available. WSAEPROTONOSUPPORT Protocol not supported. WSAEPROTOTYPE The specified protocol is the wrong type for this socket. WSAESHUTDOWN The socket has been shutdown; it is not possible to sendto() on a socket after shutdown() has been invoked with how set to 1 or 2. WSAESOCKTNOSUPPORT
Wonderware Logger Messages Socket type not supported. WSAETIMEDOUT The attempt to connect timed out without establishing a connection WSAETOOMANYREFS Too many references. WSAEWOULDBLOCK
A-27
The socket is marked as non-blocking and no connections are present to be accepted.
A-28
Appendix A
DECnet Messages
The following messages may be displayed in the Wonderware Logger for the DECnet network interface: "Bind failed: ERROR_CODE" While setting up for a listen on the network, binding of a created socket failed due to ERROR_CODE (listed in the following section). "Listen failed: RETURN_CODE:ERROR_CODE=>ERROR_MSG" Setting up a listen for new connections failed due to the error identified by the ERROR_CODE and ERROR_MSG (listed in the following section). """ NODE_NAME "": connect failed (LL_DISCONNECTING " Logical link is in the process of disconnecting. The attempt to establish a connect to NODE_NAME failed. """ NODE_NAME "": connect failed (LL_INACTIVE)" Logical link is inactive. The attempt to establish a connect to NODE_NAME failed. ""NODE_NAME": Connect failed: RETURN_CODE:ERROR_CODE=>ERROR_MSG" An attempt to add a new connection to NODE_NAME failed due to the error identified by the ERROR_CODE and ERROR_MSG (listed in the following section). ""NODE_NAME": Connect failed ... timed out internally" The attempt to establish a connection to NODE_NAME failed due to an internal timeout. Connections must complete within a predetermined period of time. """ NODE_NAME "": Connection closed (EBADF) while checking data receive" """ NODE_NAME "": Connection closed (EBADF) while checking hdr receive" Connection to NODE_NAME was found closed while checking for a header or data receive packet due to the underlying DECnet network interface receiving a bad frame packet. """ NODE_NAME "": Connection closed (EBADF) while trying to send" The connection to NODE_NAME was closed while trying to send. ""NODE_NAME": Couldnt create new socket: RETURN_CODE:ERROR_CODE=>ERROR_MSG" An attempt to create a socket while establishing a connection to NODE_NAME failed due to the returned ERROR_CODE and ERROR_MSG (listed in the following section). ""NODE_NAME": Data Verify Error, closing connection" A packet was received from NODE_NAME whose data section did not verify properly. Connection will be closed.
A-29
""" NODE_NAME "": EOF on RS_WAITHDR, closing connection, ERROR_CODE =>ERROR_MSG ", or """ NODE_NAME "": EOF) on RS_WAITRESP, closing connection, ERROR_CODE =>ERROR_MSG" An EOF was received on the connection to NODE_NAME. The EOF was either during packet header reception (RS_WAITHDR) or during the data portion (RS_WAITRSP). The Connection is being closed. The returned ERROR_CODE and ERROR_MSG are listed in the following section. ""NODE_NAME": getsockopt() checking connect failed: RETURN_CODE:ERROR_CODE=>ERROR_MSG" An attempt to check on the status of a socket being opened for a connection to NODE_NAME caused an error. The returned ERROR_CODE and ERROR_MSG are listed in the following section. ""NODE_NAME": Hdr Verify Error, closing connection" A packet HEADER received from NODE_NAME did not verify properly. Connection will be closed. """ NODE_NAME "": Unexpected RCV error (RS_WAITHDR): RETURN_CODE ERROR_CODE =>ERROR_MSG" """ NODE_NAME "": Unexpected RCV error (RS_WAITRESP): RETURN_CODE ERROR_CODE =>ERROR_MSG " An unusual receive error was reported by the underlying DECnet interface while receiving either the packet header (RS_WAITHDR) or packet data (RS_WAITRSP). The returned ERROR_CODE and ERROR_MSG are listed in the following section. """ NODE_NAME "": Unexpected XMT error (SS_XMITING): RETURN_CODE :ERROR_CODE =>ERROR_MSG" An unusual transmission error was detected while sending a packet to NODE_NAME. The returned ERROR_CODE and ERROR_MSG are listed in the following section. "sioctl() setting non-blocking mode on socketListen NNN: ERROR_CODE =>ERROR_MSG" A DECnet interface error was detected while attempting to set the listen socket NNN to non-blocking mode. The returned ERROR_CODE and ERROR_MSG are listed in the following section. "sioctl() setting non-blocking mode on connect socket NNN: ERROR_CODE =>ERROR_MSG" A DECnet interface error was detected while attempting to set the connect socket (NNN) for a new connection to non-blocking mode. The returned ERROR_CODE and ERROR_MSG are listed in the following section. "sioctl() setting non-blocking mode on socketAccept NNN: ERROR_CODE =>ERROR_MSG " A DECnet interface error was detected while attempting to set the new socket (NNN) in response to a completed listen to non-blocking mode. The returned ERROR_CODE and ERROR_MSG are listed in the following section. "Socket allocation failed: socketListen=NNN, errno= ERROR_CODE " While setting up for a listen on the network, socket creation failed due to ERROR_CODE listed in the following section.
A-30
Appendix A "Unknown host name "" NODE_NAME """ An attempt to connect to NODE_NAME failed because it is not defined in the DECnet host table. Verify the correct setup of the DECnet host table. The following ERROR_CODEs are returned by the low-level DECnet interface in response to various commands. The codes are included in the message but not the text. 1 2 3 4 5 6 7 8 9 /* Not owner */ /* No such file or directory */ /* No such process */ /* Interrupted system call */ /* I/O error */ /* No such device or address */ /* Arg list too long */ /* Exec format error */ /* Bad file number */
10 /* No children */ 11 /* No more processes */ 12 /* Not enough core */ 13 /* Permission denied */ 14 /* Bad address */ 15 /* Block device required */ 16 /* Mount device busy */ 17 /* File exists */ 18 /* Cross-device link */ 19 /* No such device */ 20 /* Not a directory */ 21 /* Is a directory */ 22 /* Invalid argument */ 23 /* File table overflow */ 24 /* Too many open files */ 25 /* Not a typewriter */ 26 /* Text file busy */ 27 /* File too large */ 28 /* No space left on device */ 29 /* Illegal seek */ 30 /* Read-only file system */ 31 /* Too many links */ 32 /* Broken pipe */ 33 /* Argument too large */
Wonderware Logger Messages 34 /* Result too large */ 35 /* Operation would block */ 36 /* Operation now in progress */ 37 /* Operation already in progress */ 38 /* Socket operation on non-socket */ 39 /* Destination address required */ 40 /* Message too long */ 41 /* Protocol wrong type for socket */ 42 /* Protocol not available */ 43 /* Protocol not supported */ 44 /* Socket type not supported */ 45 /* Operation not supported on socket */ 46 /* Protocol family not supported */ 47 /* Address family not supported by protocol family */ 48 /* Address already in use */ 49 /* Cant assign requested address */ 50 /* Network down */ 51 /* Network unreachable */ 52 /* Network dropped connection on reset */ 53 /* Software caused connection abort */ 54 /* Connection reset by peer */ 55 /* No buffer space available */ 56 /* Socket already connected */ 57 /* Socket not connected */ 58 /* Cannot send after socket shutdown */ 59 /* Too many references: cannot splice */ 60 /* Connection timed out */ 61 /* Connection refused */ 62 /* Too many levels of symbolic links */ 63 /* File name too long; should be rearranged */ 64 /* Host down */ 65 /* No route to host */ 66 /* Directory not empty */ 67 /* Too many processes */ 68 /* Too many users */ 69 /* Disc quota exceeded */ 70 /* Type of socket and protocol do not match */ 71 /* Send diagram, socket not connected */
A-31
A-32
Appendix A
B-1
A P P E N D I X
DDEView
This appendix includes installation and user instructions for DDEView. DDEView is a Microsoft Excel add-in client application designed to make DDE (Dynamic Data Exchange) and NetDDE easy to use and demonstrate.
Contents n Introduction to DDEView n Starting DDEView n Refreshing the Spreadsheet n Configuring the Focus n Retrieving Data
B-2
Appendix B
Introduction to DDEView
In any manufacturing or processing plant there are engineers, managers, and operators who want data from all parts of the manufacturing enterprise. DDEView will access this data from any DDE-aware server running on any computer node accessible through NetDDE. The DDE-aware servers may have been developed with the Wonderware NetDDE SDK. Using DDEView, you can easily and quickly connect simultaneously to several databases and view the data on a single spreadsheet. DDEView users must be able to start Microsoft Excel, open a spreadsheet, enter values into cells, and know how to use the cut-and-paste functions. Users must know the tagnames for data values needed from the plant or process area and the computer network node names where the data resides. Knowledge of DDE message syntax is not required since the correct formulas will be generated automatically from point-and-click choices. The DDEView software package includes the application and two support files: 1. 2. 3. The DDEView application A Microsoft Windows Help File A support DLL DDEVIEW.XLA DDEVIEW.HLP DDEVDLL.DLL
These files are automatically installed into your INTOUCH directory when NetDDE is installed.
DDEView
B-3
Starting DDEView
DDEView executes from an Excel add-in macro file called DDEVIEW.XLA. To load DDEView from Microsoft Excel: 1. 2. 3. Open an existing or new spreadsheet. On the File menu, click Open. Open DDEVIEW.XLA.
Note For DDEView to be fully functional, you should not place in the XLSTART directory. Always open DDEView from within a Microsoft Excel spreadsheet. You will be informed that the add-in is loading, and the percentage of progress message will appear. Once open, the add-in macro adds the DDEView menu on the Microsoft Excel main menu bar.
B-4
Appendix B
Refreshing the Spreadsheet

Use the refresh mode options to update the spreadsheet. You can either manually refresh the DDE links or have the spreadsheet update each time the server sends new data. The default mode is for a manual refresh. To manually refresh the spreadsheet: 1. 2. 3. On the DDEView menu, click Manual Refresh . All DDE links on the current spreadsheet will be updated. The links will only update again when you reselect the Manual Refresh command.
To automatically refresh the spreadsheet: 1. 2. 3. On the DDEView menu, click Auto Refresh. The DDE links on the spreadsheet will update whenever the server application sends new data. To turn the automatic refresh off, click Manual Refresh .
DDEView
B-5
Configuring the Focus

A focus is used to simplify the creation of DDE formulas in spreadsheet cells. Of the four parameters required for NetDDE addressing, three of these are: Node, Application , and Topic. On the DDEView menu, the names that appear next to Node, Application, and Topic indicate the current settings. In combination, the three specify the focus of all operations in DDEView. To access data values, only enter tagnames. Selecting a data function creates DDE message formulas according to the tagname and the current focus. For more information on selecting a data function, see "Retrieving Data" later in this chapter. Note Initially, a worksheet starts up with Node, Application, and Topic all set to NONE. These must be set to "real" entries before any actions can be taken. You can change the focus at any time, and it is retained until changed again. Consequently, you can retrieve data from many DDE-aware servers throughout a network enterprise. The same functions are used, but the focus is changed to redirect their effect.
B-6
Appendix B
Selecting a Focus
To select the focus: 1. Select any one of the three items (Node, Application, or Topic). The Assign Connection dialog box appears.
2.
Select any item from the Node, Application and Topic lists to become the focus. To add an item to the list, see "Adding a Focus Entry" later in this section. To delete an item to the list, see "Deleting a Focus Entry" later in this section. In the example shown in the dialog box, LOCAL is selected for the Node, VIEW is the Application and TAGNAME is the Topic.
3.
Click OK. The DDEView menu will reflect any modifications.
Note DDEView does not check the validity of any entered Node, Application, or Topic names until the user attempts to access data.
DDEView
B-7
Adding a Focus Entry

To add a focus entry: 1. Under the Node, Application, or Topic list, click the corresponding Add button. The Add New dialog box appears. For example, if you click Add under the Node list, the Add New Nodes dialog box appears.
2. 3.
In the Enter New Node box, type the node name to be added. Click OK.
DDEView automatically embeds the name into the spreadsheet, where it is preserved when the file is saved. When a spreadsheet with added names is saved and then later recalled, DDEView will automatically load the embedded names into the Node, Application, and Topic lists. You dont need to retype names each time a spreadsheet is used, allowing you to maintain customized lists.
Deleting a Focus Entry

To delete a focus entry: 1. 2. Select the entry to delete in the Node, Application, or Topic list. Click the corresponding Del button. A confirmation dialog box appears. For example:
3.
Click Yes to delete the entry or No to cancel.
Note You cannot delete the LOCAL node.
B-8
Appendix B
Retrieving Data
After you have set the focus, you can access data using the data retrieval functions on the DDEView menu.
Inserting a Tagname
DDEView provides this special utility for connecting to an InTouch database on a local node. Note WindowMaker must be running in order to retrieve the tagname selection list.
To insert a tagname: 1. 2. Select an empty cell in the spreadsheet. On the DDEView menu, click Insert Tagname. The standard InTouch system Tagname Dictionary selection list appears.
3. 4.
Select the tagnames to insert. Click OK. The selected tagnames will be pasted in a vertical list, starting at the selected cell.
DDEView
B-9
You can also manually type or paste tagnames into a COLUMN of cells manually. After you have entered the tagnames, you can then retrieve data for them.
B-10
Appendix B
Retrieving Current Data

Using the Retrieve Data function is the most straight-forward DDEView method for data access. To retrieve data for tags: 1. Select the cells with the tagnames. If a list of tagnames is typed or pasted into a column, select the whole column. Selecting a single tagname in the middle of a list is not recommended. The selection mechanisms in DDEView accommodate spaces (or blanks) in a vertical list of tagnames and writes the data with appropriate spaces between the resulting data values. 2. On the DDEView menu, click Retrieve Data . DDEView reads the selected tagnames and constructs NetDDE formulas (according to the Node, Application, and Topic specified by the focus) in the appropriate cells to the right of the tagnames. 3. Microsoft Excel then activates the DDE conversations and presents real data. For example:
Where Microsoft Excel does not find data values (due to network unavailability, invalid server names, invalid tagnames, and so on), it presents appropriate messages where the values should be: #N/A #REF Data was not returned from the server. The application or topic may not exist.
DDEView
B-11
Modifying the NetDDE Message Syntax

After you have retrieved data for one or more tagnames, you can edit the NetDDE message syntax. To edit the message syntax: 1. Select the cell containing the current value. The NetDDE message syntax will appear in the Microsoft Excel formula bar. Tip To have the message syntax appear in the value cell, press F2.
2.
Position the mouse cursor in the syntax and manually make the changes.
Once the NetDDE formula has been entered for each tagname, the actual tagnames can be deleted (if desired). By convention, if a tagname is used without a parameter name (.Field), DDEView will fetch the current value of the tag (or process variable). To retrieve other valid parameters from the InTouch database, enter the appropriate .Field name after the tagname, delimited by a period. For example, for FIC101 HiLimit, enter FIC101.HILIMIT.
B-12
Appendix B
Automatically Retrieving a .Field

DDEView allows a simple method for collecting several parameter values .Fields for multiple tags in one operation. DDEView assumes text entries in the row above a tag list are .Fields. DDEView allocates appropriate space on the spreadsheet and constructs the formula for each cell. Microsoft Excel then returns the appropriate parameter values into a block of cells to the right of the tagnames. DDEView will retrieve .Fields (or tag attributes) from any database that uses the tagname.attribute convention. Thus, it is possible to retrieve tag attributes (parameters) from databases other than InTouch. To auto-retrieve .Fields for tags: 1. 2. 3. 4. Type the desired .Fields into the row of cells above and to the right of the first tagname. Select the tagnames. From the DDEView menu, click Retrieve Data . from the DDEView menu. Microsoft Excel then returns the appropriate parameter values into a block of cells to the right of the tagnames. For example:
DDEView
B-13
Retrieving an Array
DDEView can automatically access any DDE source supplying data in the Microsoft Excel Table (XlTable) format. Sources for XlTable format data include some Wonderware I/O Servers, other Microsoft Excel spreadsheets, and many financial programs. To retrieve data from an array: 1. 2. 3. Type an array reference in a cell. Select the cell. On the DDEView menu, click Retrieve Array . The Array Size dialog box appears.
4. 5. 6.
Enter the table array size (in rows and columns). This allows DDEView to select and prepare the destination cells for the data. Press Enter. The array will be returned to the worksheet:
B-14
Appendix B
Sending Data
DDEView can send (or POKE) data to any DDE-aware application that will accept the operation. To send data: 1. 2. 3. In a column of your spreadsheet, type the names of tags for which you want to send data. In the column directly to the right of the tagnames, type the actual data values to send. Select the column of tagnames (not the column of data).
4.
From the DDEView menu, click Send Data. A message box appears, prompting you to confirm that the data values to send are correct:
5.
Click OK. The specified data will be sent to the DDE-aware application.
DDEView
B-15
Retrieving Historical Data

DDEView can retrieve InTouch historical data through the InTouch Historical Data Access Manager (HistData). It is similar to retrieving real-time data. Normally, accessing historical data from Microsoft Excel requires sending many different values to HistData using conventional POKE statements in macros. To retrieve historical values: 1. 2. Select the desired tagnames arranged in a ROW. From the DDEView menu, click Retrieve HISTDATA. The HISTDATA Configuration dialog box appears.
3. 4.
In the Use Node list, enter the node name where the history is stored and where HistData is running. In the Date/Time Range group, enter the time range for the period of history for which you want to retrieve values. You must enter at least two of the three parameters. If you provide all three parameters, the Start Time will be recalculated based on End Time, Number of Values, and the Time Between Values (described below).
5. 6.
In the Value Type list, enter the value type. Instantaneous is currently the only value type available. In the Time Between Values group, enter the time interval between data samples to be returned to the spreadsheet. If you only supplied two parameters in the Date/Time Range group, this time interval is used to calculate the third parameter.
7. 8.
To automatically compute and update the missing parameter in the Date/Time Range box, click Update. To erase the Start Time and place the current time in the End Time box, click Current.
B-16
Appendix B 9. In the Labels group, select the types of labels to be placed in the columns to the left of the resulting historical data. DDEView requires one column for each option selected. 10. In the Tagname Database Dictionary box, type the directory location on the history node where the InTouch database files are located. This directory location is embedded in the spreadsheet and is retained if the spreadsheet is saved and re-opened. 11. In the InTouch History File Directory box, type the directory location on the history node for the historical (.LGH) files. This directory location is embedded in the spreadsheet and is retained if the spreadsheet is saved and re-opened. 12. To perform a summary calculation on the retrieved data, click Summary. If not, click OK. The History Summary dialog box appears.
13. Configure the summary calculation. You can calculate a mean, standard deviation, maximum and/or minimum for none, all, or a selected portion of data. Summary calculations are performed on each tag (or column of data) retrieved from HistData. Calculation results are listed directly below the actual data extracted from the historical log files. 14. Click OK. DDEView will read the historical data for each of the tagnames, place the date and time labels appropriately, and return the values to the spreadsheet. For example:
DDEView
B-17
B-18
Appendix B
Monitoring Tag Values

DDEView can be used as a limited real-time monitor and simple trend service for any of the NetDDE-accessible servers. Note The Monitor function should not be used as a heavy-duty automation trending system and is intended only for light, occasional use. For higher performance trend functions, use the InTouch WindowViewer trend objects. 1. 2. Arrange a number of tagnames in a ROW. From the DDEView menu, click Monitor . The Monitor Configuration dialog box appears.
3.
In the Report On group, select the condition to trigger the NetDDE client to log data. The following options are available: Time-Basis Data will be logged according to the defined interval. Change-Only Data will be logged only when the value changes in the server. Time+Change Data will be logged according to the defined interval and when the value changes in the server.
4.
In the Time Between Values group, enter an integer number (1-100) in the box and select a particular time identifier (seconds or minutes) to determine the interval of time separating logged data entries (reporting on Time-Basis or Time+Change). In the Keep XX Value[s] box, type the maximum number of values (2-25) to be contained in the data table in this field. When the Monitor function starts, DDEView inserts values into the table until it reaches the limit. After this limit is reached, the oldest entry in the table is deleted to allow for the newest. The data table only keeps the last xx values (as defined by the entry in this box.)
5.
DDEView 6.
B-19
In the Log Latest Values group, select whether to log the latest data record at the top of the data table (generating a table with data at descending times) or at the bottom (generating a table with data at ascending times). In the Labels group, select the Date and/or Time options to display date and time markers when the data is logged. Date/Time labels are displayed in the columns directly to the left of the actual data. DDEView requires one column for each option selected. The current (or latest) data values are labeled "Currently."
7.
8.
Click OK.
The following example of the Monitor function shows data reporting on a timebasis of 10 second intervals and retaining 5 values of data at a time.
B-20
Appendix B
Retrieving Current SPC Data

DDEView can retrieve InTouch SPC data and build a table of values representing the current sample of one or more datasets. Using this function is similar to retrieving real-time data using the Retrieve Data function. Normally, accessing SPC data requires the creation of various DDE links for each dataset that you want to get data from. DDEView makes that process easy by building all of the links for you and putting them in a table on your current spreadsheet. To retrieve SPC information from current samples: 1. 2. 3. Select the desired datasets arranged in a ROW. From the DDEView menu, click Retrieve Current SPC . DDEView will set up the DDE links for each of the datasets you have selected and present the values for the current sample in a table.
For example:
The data items that the Retrieve Current SPC command will retrieve are from the current (or last) sample for each dataset in the selection. For information on retrieving data from a particular sample, see "Retrieving Selected SPC Data" later in this chapter.
DDEView
B-21
Retrieving Selected SPC Data

DDEView can retrieve InTouch SPC data for a particular sample of a particular dataset and build a table of values representing this data. Using this function is similar to retrieving real-time data using the Retrieve Data function. Normally, retrieving SPC data for a particular sample requires the user to first send the selected sample number to SPC (using conventional POKE statements in macros) and then create various DDE links for the data that they want to see. DDEView makes that process easy by building all of the links for you and putting them in a table on your current spreadsheet. To retrieve SPC information from a particular sample: 1. 2. Select the desired dataset (only one). From the DDEView menu, click Retrieve Selected SPC . The Desired SPC Sample dialog box appears.
3. 4.
In the SPC Sample to Retrieve box, type the desired sample number. DDEView will first POKE the specified sample number to SPC and then create the required DDE link functions to retrieve the values for the selected sample in a table.
For example:
B-22
Appendix B
You can use the Retrieve Selected SPC command multiple times for one dataset, or after the Retrieve Current SPC command is used for a dataset. Each time you use the command, DDEView will shift the previously retrieved information to the right, effectively building a running log of sample information. The following is an example of requests for samples 50, 36, and 24 (consecutively):
DDEView
B-23
The data items that the Retrieve Selected SPC command will retrieve are from the selected sample for one dataset only. For more information on retrieving current data from one or more datasets, see "Retrieving Current SPC Data" earlier in this chapter.
B-24
Appendix B
C-1
A P P E N D I X
Special Topics
This appendix includes information on various topics related to using NetDDE for Windows.
Contents n Reserving Onboard Memory n Cable Diagrams n Modems Tested with NetDDE n Setting Up a DDE Conversation from Microsoft Excel n NetDDE Application Notes
C-2
Appendix C
Reserving Onboard Memory

A range of memory addresses that are not used by any other devices on the system must be identified in order to successfully configure a network card with onboard memory. The following address ranges are typical for most PC-compatibles. The best candidate for allocating to a network adapter is indicated by an asterisk ( *). Memory Range 0000 A000 A000 B000 B000 B800 B800 C000 C000 C400 C000 C800 C800 D000 *D000 E000 E000 F000 F000 FFFF Typical Use System memory; do not use . Graphic video display memory; do not use . Monochrome display memory; okay to use if using a color only system. Color display memory; okay to use if using a monochrome only system. EGA BIOS; do not use if display controller is EGA. VGA BIOS; do not use if display controller is VGA. Sometimes used by video cards; use with caution . Usually available. Sometimes used by system BIOS; use with caution . System BIOS; do not use . If applicable, the chosen memory address should be set in the switches on the network card. The memory reserved for the network adapter should also be placed off limits for use by Window and MS-DOS. For more information on reserving memory allocated to a network adapter, see Chapter 2, "Installation Considerations."
Special Topics
C-3
Cable Diagrams
Pin-out equivalents for null modem cables used to connect two PCs (over a short distance) with full handshaking are defined below: 25-25 Pin Cable 25-9 Pin Cable
Pin-out equivalents for 9 to 25 pin cables used to connect a PC to an external modem are defined below: 9-Pin 25-Pin
C-4
Appendix C
Modems Tested with NetDDE

The following are modems that have been tested with NetDDE by Wonderware: Hayes Ultra96 Anchor 2400E Telebit T2500 US Robotics Courier HST with ASL Intel Satisfaction Zoom 2400 Intel 2400B MNP Viva 9642e MultiTech MT1432BA MultiModem MultiTech MT932BA MultiModem
Special Topics
C-5
Setting Up a DDE Conversation from Microsoft Excel

The DDE protocol identifies an element of data using a three-part address. The three parts of a DDE address are the a pplication name, topic name and item name. In a network DDE conversation, the application name is simply prefixed with a destination node name. Application Name The name of the Windows program (server) which can access the data element (for example, Microsoft Excel). For NetDDE, when a client application opens a conversation with an application residing on a remote node (server), the name of the remote node must precede the application name in the DDE Address. To distinguish the node name from the application name, it must be preceded by two backslashes and followed by one backslash. For example: \\NodeName\applicationname Note If the remote node resides on a network interface other than the default interface, the node name must have a route set up for it in the local nodes [Routes] section of the NETDDE.INI file. Topic Name An application-specific sub-group of data elements. For example, when conducting a DDE conversation with Excel, the topic name is the name given for the spreadsheet on the remote node, for example, Sheet1.xls. A specific data element within the specified topic. For example, when conducting a DDE conversation with Excel, the item name is the identification of a cell in the row/column format (R1C1). Note If the network node name in the Excel spreadsheet contains any non-alphanumeric characters, the node name reference and the application name must be enclosed in single quotes. For example: =\\cloud-9\thunder|control!volume To set up a DDE conversation between two nodes, NetDDE must be installed and running on each network workstation. The DDE-aware application to be accessed must also be running on the server node while the application requesting the DDE conversation must be running on the client node. The client and server roles are interchangeable for NetDDE purposes. Microsoft Excel and Wonderware InTouch are examples of applications capable of playing both roles.
Item Name
C-6
Appendix C On the server node, the DDE data to be accessed must be identified as "shareable" by defining a "DDE share." This share will represent the data and permission attributes to control access to the data. DDE shares are created by identifying the application name and the topic name controlling the data to be shared. For information on how to define a DDE share on the server node, refer to Chapter 5. "DDE Share Security." In the following example, a DDE share would be created using the application name of "Excel" and the topic name of "sheet.xls" to represent the data that will be accessed by the client Excel application. As an example of DDE addressing from the client node, if Excel on the local node wanted to establish a conversation with Excel running on a remote network workstation, NODE1, the DDE address of the data to be accessed would be entered in a cell as follows:
\\node1\excel sheet1.xls r1c1
The node name of and application name on the server node (application name). The spreadsheet to be accessed on the server node (topic name). Identification of the cell in the spreadsheet containing the data (item name). This can also be a range name.
Note With Excel 5.0, the topic must include a reference to Workbooks. The workbook name must be enclosed in square brackets [ ] and is identified with the .xls extension. The spreadsheet is identified as the name of the sheet without the .xls extension. For example: =\\node1\excel\[Book1.xls]sheet1r1c1
Special Topics
C-7
NetDDE responds to any DDE initiate message with application names beginning with "\\". NetDDE on the local node passes the DDE message to the NetDDE program running on NODE1. NetDDE running on the server NODE1 receives the initiate request and validates whether or not the user on the server node has permitted access to the requested DDE data by defining a DDE share to represent the subject data. If access is permitted, NetDDE on the server node completes the conversation by establishing a connection to the Excel program on NODE1. Except for the extended application name , there is no difference between specifying a local DDE conversation and specifying a network DDE conversation. Once the conversation is established, the NetDDE program window will display the following if Connections command is checked on the View menu.
C-8
Appendix C
NetDDE Application Notes

NetDDE Application Notes are available from Wonderware Technical Support on the following topics: Configuring NetDDE with FTP PC/TCP v2.3 on Windows and Windows for Workgroups Configuring NetDDE with NetManage Chameleon v3.11 on Windows and Windows for Workgroups Configuring NetDDE with Novell NetWare v3.12 and NetWare Lite v1.1 Using the NetBIOS Debug Menu Using DDE Share with Windows for Workgroups Using NetDDE with Multi-Tech Modems NetDDE Frequently Asked Questions Configuring Networked InTouch Applications
If you are interested in any of these topics, please refer to the Wonderware Comprehensive Support CD or call Technical Support at (949) 727-3299 .
I-1
No Access, 5-3 Passwords Required to Read and Write, 5-3 Read Only Access, 5-3 Read Only with Password, 5-3 Windows for Workgroups DDE shares, 5-4 DDE share utility, 5-4 DDEView configuring the focus, B-5 data retrieval arrays, B-13 inserting a tagname, B-8 retrieving current data, B-10 retrieving historical data, B-15 sending data, B-14 dialog boxes Add New Nodes, B-7 Array Size, B-13 Assign Connection, B-6 Choose InTouch Tags, B-8 Desired SPC Sample, B-21 HISTDATA Configuration, B-15 History Summary, B-16 Monitor Configuration, B-18 installation, B-2 introduction, B-2 menu, B-3 refresh mode, B-4 retrieving data current SPC, B-20 monitoring tag values, B-18 selected SPC data, B-21 retrieving data:, B-8 starting, B-3 debugging, 8-6, 8-7 DECnet additional parameters, 8-19 Wonderware Logger messages, A-28 Default DDE Security dialog box, 5-6 destination node, 4-8 dialog boxes Add a Network Interface, 3-5 Add Connection Name, 4-12 Add Route, 4-9 Add Serial Connection Information, 6-8 Close Connection with, 8-5 Connection Information, 6-7 Connection Names, 4-11 Custom DDE Security Browser, 5-5, 5-7 Custom DDE Security Configuration, 5-8 DDEView Add New Nodes, B-7 Array Size, B-13 Assign Connection, B-6 Choose InTouch Tags, B-8 Desired SPC Sample, B-21 HISTDATA Configuration, B-15 History Summary, B-16 Monitor Configuration, B-18 Default DDE Security, 5-6 Enter NetDDE Share Access Password, 5-13 Enter Network Access Password, 5-11 Flush Client DDE Share Password Cache, 5-10 Font, 7-16 Modem Details, 6-5
Index
A
Add a Network Interface dialog box, 3-5 Add Connection Name dialog box, 4-12 Add Route dialog box, 4-9 Add Serial Connection Information Dialog Box, 6-8 authentication, 8-15
C
cable diagrams, C-3 cached passwords, 5-10 cascade, 7-13 child windows adding horizontal scroll bar, 7-15 arranging icons in, 7-14 cascading, 7-13 configuring font for, 7-16 determining open windows, 7-16 tiling, 7-12 tiling horizontally, 7-13 Close Connection with dialog box, 8-5 closing NetDDE, 3-8 communication ports, 4-11, 4-13, 6-8 Direct Connect, 6-13 Connection Information Dialog Box, 6-7 Connection Names dialog box, 4-11 connections testing, 8-3, 8-5 viewing status and statistics, 7-5 conversations viewing status and statistics, 7-8 Custom DDE Security Browser dialog box, 5-5, 5-7 Custom DDE Security Configuration dialog box, 5-8
D
data authentication, 8-15 DDE, 1-2 DDE conversations from Microsoft Excel, C-5 DDE conversations. See also conversations DDE share security adding a DDE share, 5-8 connecting to a secured WFW application, 5-13 connecting to a secured Windows NT application, 5-11 customized DDE shares, 5-7 default DDE share security, 5-4 defining default, 5-5 deleting a DDE share, 5-9 flushing cached passwords, 5-10 introduction, 5-2 modifying a DDE share, 5-9 permission levels Full Access, 5-3 Full Access with Password, else Read Only, 5-3
I-2
Index
additional parameters, 8-16 Wonderware Logger messages, A-13 NetBIOS Configuration Parameters dialog box, 8-16 NetDDE application notes, C-8 closing, 3-8 configuring preferences, 4-5 connectivity Macintosh, 1-9 UNIX, 1-8 VMS, 1-7 Windows NT, 1-6 Windows 3.1 environment, 1-4 Windows for Workgroups environment, 1-5 Wonderware Logger messages, A-2 NetDDE Preferences dialog box, 4-5 NETDDE.INI, 3-2, 4-7, C-5 Network Interface Selection dialog box, 3-5, 4-3 network interfaces adding, 4-3 configuring, 4-3 DECnet additional parameters, 8-19 deleting, 4-3 modifying the network node name, 4-3 NetBIOS additional parameters, 8-16 selecting network interfaces, 3-5 Serial Additional Parameters, 8-17 Serial Parameters/Define Connection Information, 6-7 Serial Parameters/Port Configuration, 6-3 Serial Parameters/Port Status, 6-10 viewing status and statistics, 7-4 WinSock additional parameters, 8-18 network node name, 4-11 Network Routes dialog box, 4-8, 4-9 node connections, 4-11
Modify Route, 4-10 Name for this Node, 3-4 Name to Connect to, 8-3 NetBIOS Configuration Parameters, 8-16 NetDDE Preferences, 4-5 Network Interface Selection, 3-5, 4-3 Network Routes, 4-8, 4-9 Port Configuration, 6-3 Port Status, 6-10, 6-13 Serial Configuration, 6-2, 6-10 WWINSOCK Configuration Parameters, 8-18 Direct Connect Ports, 6-13 Dynamic Data Exchange, 1-2
E
Enter NetDDE Share Access Password dialog box, 513 Enter Network Access Password dialog box, 5-11
F
Flush Client DDE Share Password Cache dialog box, 5-10 font, 7-16 Font dialog box, 7-16
H
hops, 7-6 viewing status and statistics, 7-7 horizontal scroll bar, 7-15
I
icons, 7-14 interfaces. See network interfaces
L
local node name, 3-4 modifying, 4-2 logger files, 7-11 logging errors, 8-13 logical node name, 3-4 adding, 4-12 deleting, 4-14 mapping, 4-11 modifying, 4-14
P
packets, 8-12 password cache, 5-8 passwords, 5-10, 5-11, 5-13 Port Configuration Dialog Box, 6-3 Port Status Dialog Box, 6-10, 6-13 preferences configuring, 4-5
M
Macintosh, 1-9 memory reserving, C-2 Microsoft Excel conversations with NetDDE, C-5 modem cable pin-outs, C-3 Modem Details Dialog Box, 6-5 modems (tested), C-4 Modify Route dialog box, 4-10
R
retry limits, 8-14 routes adding, 4-9 configuring, 4-7 deleting, 4-10 modifying, 4-10 viewing status and statistics, 7-6 routes (DDE) viewing status and statistics, 7-9
N
Name for this Node dialog box, 3-4 Name to Connect to dialog box, 8-3 NetBIOS
Index
I-3
S
SDDETSR Wonderware Logger messages, A-20 security. See DDE share security Wonderware Logger messages, A-11 Serial Additional Parameters, 8-17 Serial Parameters/Define Connection Information, 6-7 Serial Parameters/Port Configuration, 6-3 Serial Parameters/Port Status, 6-10 Direct Connect Ports, 6-13 Wonderware Logger messages, A-16 Serial Configuration Dialog Box, 6-2, 6-10 Serial Parameters Define Connection Information, 6-7 Port Configuration, 6-3 Port Status, 6-10 shares, 5-2 SPC data, B-20 starting NetDDE Windows 3.1 environment, 3-3 Windows for Workgroups (WFW) environment, 3-3 statistics displaying, 7-10 viewing, 7-3 viewing for connections, 7-5 viewing for conversations, 7-8 viewing for DDE routes, 7-9 viewing for hops, 7-7 viewing for network interfaces, 7-4 viewing for routes, 7-6 status viewing, 7-3 viewing for connections, 7-5 viewing for conversations, 7-8 viewing for DDE routes, 7-9 viewing for hops, 7-7 viewing for network interfaces, 7-4 viewing for routes, 7-6
W
windows. See also child windows Windows 3.1, 1-4, 3-3, 1-4 Windows for Workgroups (WFW), 1-5, 5-13, 1-5 Windows NT, 1-6, 5-11, 1-6 WinSock additional parameters, 8-18 Wonderware Logger messages, A-22 Wonderware Logger, 8-7, 8-8, 8-13, A-1 messages DECnet, A-28 NetBIOS, A-13 NetDDE, A-2 SDDETSR, A-20 security, A-11 Serial, A-16 WinSock, A-22 WWCOMTSR, A-18 preferences, 4-6 showing, 7-11 WWCOMTSR Wonderware Logger messages, A-18 WWINSOCK Configuration Parameters dialog box, 8-18
T
TCP/IP port, 8-11 testing closing connections, 8-5 enabling debug menu commands, 8-6 introduction, 8-2 opening connections, 8-3 tile, 7-12, 7-13 timeout values, 8-12
U
UNIX, 1-8
V
validation, 8-15 version information, 3-7 VMS, 1-7
I-4
Index

NetDDE PDF

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

NetDDE PDF

Загружено:

Авторское право:

Доступные форматы

Wonderware FactorySuite NetDDE for the Microsoft Windows Operating System

Chapter 1 - Introduction...................................... 1-1

Chapter 2 - Installation Considerations............. 2-1

Chapter 3 - Starting NetDDE............................... 3-1

Chapter 4 - Customizing NetDDE Setup ............ 4-1

Chapter 5 - DDE Share Security......................... 5-1

Chapter 6 - Additional Serial Interface Parameters .............................................................................. 6-1

Chapter 7 - NetDDE Status and Statistics Display .............................................................................. 7-1

Chapter 8 - NetDDE Test and Debug Commands .............................................................................. 8-1

Appendix A - WW Logger Messages .................A-1

Appendix B - DDEView .......................................B-1

Appendix C - Special Topics ..............................C-1

DEC VAX NetDDE for VMS

DEC Alpha AXP NetDDE for VMS

Windows 3.1 PC NetDDE for Windows

UNIX Workstation NetDDE for UNIX

Macintosh NetDDE for MacIntosh

WFW PC NetDDE for Windows

Windows/NT PC NetDDE for NT

NetDDE in the Windows 3.1 Environment

NetDDE in the WFW and Win95/98 Environments

NetDDE Connectivity with Windows NT

NetDDE Connectivity with VMS

NetDDE Connectivity with UNIX

NetDDE Connectivity with Macintosh

Installing NetDDE for Windows

Important Note Be sure to restart Windows before using NetDDE.

General Installation Requirements

Avoiding Adapter Memory Conflicts with Windows

Avoiding Adapter Memory Conflicts with DOS

Installation Requirements for NetBIOS

Installation Requirements for Serial

Loading the Serial TSRs

WWCOMTSR Configuration Options

The following will appear:

SDDETSR Configuration Options

The following will appear:

Common TSR Configurations

To use COM2 only:

To use COM3 only:

Custom Hardware Settings

Compatibility with Serial I/O Servers

or, C:\INTOUCH.16> WWCOMTSR COM1:1,2048,2048,3F8,4

or, C:\INTOUCH.16> WWCOMTSR COM1:1,2048,2048,3F8,4

Assigning I/O Addresses to Communication Ports

Configuring Software Interrupts

Installation Requirements for WinSock

Installation Requirements for DECnet

DECnet from PATHWORKS 4.X

Installation Considerations To start WIN3SETU from the DOS command line: 1.

Change to the Windows directory. For example:

Enter the WIN3SETU command. For example:

DECnet from PATHWORKS 5.X

Installing PATHWORKS for Windows 95/98

DECnet Node Name/Address Configuration

Starting in Windows 3.1 and Windows 95/98

Defining a Local Node Name

Selecting Network Interfaces

The Add a Network Interface dialog box appears.

Add each network interface that is to be configured for NetDDE.

Viewing Version Information

Customizing NetDDE Setup