Part Number 60-46

Revision A

INSTALLATION AND CONFIGURATION

QuickWITS
&
Wits DDE

Manufacturers of Precision Instruments

Printed in U.S.A. August 27, 1999

 Manual 60-46 contains 26 pages as follows:

Cover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .August 1999

ii thru vi . . . . . . . . . . . . . . . . . . . . . . . . . . . . .August 1999
1 thru 22 . . . . . . . . . . . . . . . . . . . . . . . . . . . .August 1999

All product, brand, or trade names used in this publication are the trademarks or registered trade-
marks of their respective owners.

Information in this manual is subject to change without notice.

 IMPORTANT SAFETY NOTICE

Proper service and repair is important to the safe, reliable operation of all M/D TOTCO equipment.
The service procedures recommended by M/D TOTCO and described in the technical manuals
are recommended methods of performing service operations. When these service operations
require the use of tools specially designed for the purpose, those special tools should be used as
recommended. Warnings against the use of specific service methods that can damage equipment
or render it unsafe are stated in the manuals. These warnings are not exclusive, as M/D TOTCO
could not possibly know, evaluate and advise service people of all conceivable ways in which ser-
vice might be done or of all possible associated hazardous consequences. Accordingly, anyone
who uses service procedures or tools which are not recommended by M/D TOTCO must first sat-
isfy themselves thoroughly that neither personnel safety nor equipment safety will be jeopardized
by the method selected.

August 27, 1999 iii

M/D TOTCO
 LIMITED PRODUCT WARRANTY

THE FOLLOWING WARRANTY IS EXCLUSIVE AND IN LIEU OF ALL OTHER WARRANTIES, WHETHER
EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT BY WAY OF LIMITATION, ANY WARRANTY
OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.

Martin-Decker TOTCO (“Company”) warrants to Buyer (“Purchaser”) of new products manufactured or

supplied by the Company that such products are, at the time of delivery to the Purchaser, free of material and
workmanship defects, subject to the following exceptions:

A. Any product which has been repaired or altered in such a way, in the Company's judgement, as to affect
the product adversely, including any repairs, rebuilding, welding or heat treating outside of Company
authorized facility.

B. Any product which has, in the Company's judgement, been subject to negligence, accident, or improper
storage.

C. Any product which has not been installed, operated and maintained in accordance with normal practice
and within the recommendations of the Company.

D. For all items of special order by Buyer which are not manufactured by Company, Buyer should submit
warranty claims directly to the manufacturer thereof.

The Company's obligation under this warranty is limited to repairing, or at its option, replacing any products
which in its judgement proved not to be as warranted within the applicable warranty period. All costs of
transportation of products claimed not to be as warranted to authorized Company service facility shall be
borne by Buyer. Costs of return transportation to Buyer of products accepted for repair or replacement by
Company under the warranty provisions of the Sales Agreement shall be borne by the Company. Company
may, at its sole option elect to refund the purchase price of the products, and Company shall have no further
obligation under the Sales Agreement.

The cost of labor for installing a repaired or replacement part shall be borne by Buyer. Replacement parts
provided under the terms of this warranty are warranted for the remainder of the warranty period of the
product upon which installed to the same extent as if such parts were original components thereof.

The warranty periods for various products are:

A. Hydraulic, Mechanical, Electronic Equipment: one (1) year from date of installation or fifteen (15) months
from date of shipment from Company, whichever occurs first.

B. All Elastomer Diaphragms: six (6) months from date of shipment from Company.

No deviations from the Company's standard warranty terms or period as stated herein will be honored unless
agreed to in writing by an authorized Company representative prior to acceptance of the order.

EXCLUSIVITY OF REMEDY AND LIMITATION OF LIABILITY. THE REMEDIES PROVIDED FOR IN THIS
WARRANTY SHALL CONSTITUTE THE SOLE RECOURSE OF BUYER AGAINST COMPANY FOR
BREACH OF ANY OF COMPANY'S OBLIGATIONS UNDER THE SALES AGREEMENT WITH BUYER,
WHETHER THE CLAIM IS MADE IN TORT OR IN CONTRACT, INCLUDING CLAIMS BASED ON
WARRANTY, NEGLIGENCE, OR OTHERWISE.

IN NO EVENT SHALL COMPANY BE LIABLE FOR DIRECT, INDIRECT, INCIDENTAL OR

CONSEQUENTIAL DAMAGES, REGARDLESS OF THE FORM OF ACTION, WHETHER IN CONTRACT,
STRICT LIABILITY OR IN TORT (INCLUDING NEGLIGENCE), NOR FOR LOST PROFITS.

iv August 27, 1999

M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

Table of Contents
1 Introduction & Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1-1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1-1-1 About the MDT WITS DDE Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1-1-2 Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1-1-3 MDT WITS DDE Server Key Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1-1-4 About QuickWITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 MDT WITS DDE Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2-1 WITS DDE Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2-2 WITS DDE Server Configuration for Topics/Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2-2-1 Configuration Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2-2-2 WITS DDE ‘Standard’ Item Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2-3 WITS DDE Special Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3 QuickWITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3-1 QuickWITS Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3-2 Using QuickWITS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3-2-1 Defining Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Appendix A: ASCII Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Appendix B: RS-232 Pinouts and Cable Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Appendix C: Ethernet Pinouts and Cross Over Cable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

M/D TOTCO 1
QuickWITS and Wits DDE Connectivity Series

1 Introduction & Overview

It is assumed that as the reader of this manual you are responsible for the installation and configu-
ration of both the MDT WITS DDE driver and QuickWITS. Your goals are as follows:
• Install/configure the MDT WITS DDE server for use by QuickWITS
• For RS232 (serial port) connections, cabling the WITS DDE computer to the WITS
partner and configuring WITS DDE for serial communications.
• For TCP (network) connections, NT configurations for both supporting WITS DDE,
and configuration/connection specifications for the WITS partner.
• Configure QuickWITS to retrieve Data from V-ICIS (WonderWare) or another DDE
Server, and place that Data into WITS records to be exchanged with the WITS partner.
This manual is divided into two sections. Section 1 focuses on the installation and configuration of
MDT’s WITS DDE server. Section 2 focuses on the installation and configuration of QuickWITS.

1-1 General
The WITS level 0 ASCII protocol driver developed for V-ICIS is capable of receiving
WITS level 0 data utilizing serial or network TCP/IP connections. The MDT WITS DDE
server contains a user interface for configuration of data connection information and map-
ping of V-ICIS 'tags' (in the form of Wonderware InTouch tags) to WITS record/item
pairs.
The WITS protocol is a level 0 protocol also know as the 'Intra-Rig Transfer' format. This
widely accepted protocol uses simple ASCII format with data items identified by their
position within pre-defined data records. The pre-defined data records are made up of the
25 standard records defined by WITS and any custom records that have been agreed upon
by the data vendor and data consumer.
A WITS level 0 data stream is made up of a series of data sets, these sets represent groups
of data that is related by group (record) or sample time. Each data set start with a pair of
ampersand followed by a carriage return/line feed (HEX - 26260D0A) and is terminated
by a pair of exclamation marks followed by a carriage return/line feed (HEX -
21210D0A).

2 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

Data within a set is made up of a data identifier and data value followed by a carriage
return/line feed. The data identifier is made up of four charters, the first two charters are
the record number and the last 2 charters are the item within the record. The following
example shows two small data sets:
&&<CR><LF> |- Data set start
01105001.1<CR><LF> |- Record 1 item 10 value 5001.1
011615.6<CR><LF> |- Record 1 item 16 value 15.6
0123110<CR><LF> |- Record 1 item 23 value 110
!! <CR><LF> |- Data set end
&&<CR><LF> |- Data set start
1115100.2<CR><LF> |- Record 11 item 15 value 100.2
1116250<CR><LF> |- Record 11 item 16 value 250
!! <CR><LF> |- Data set end
For full details of the WITS level 0 protocol see the Wellsite Information Transfer Specifi-
cation.
1-1-1 About the MDT WITS DDE Server
The QuickWITS package comes standard with a WITS DDE driver that supports
both the reading and writing of WITS Level 0 packets across the same interface.
This interface may be a serial communications port or a TCP/IP network connec-
tion as shown in Figure 1.

V-ICIS Factory O ffice, V-ICIS & MS Intranet Utilities,

MS Database Utilities/Report tools, m ore...

V-ICIS Operator
V-ICIS Process MS SQL/Excel &
Displays other DDE Appl.
Database

W ITS DDE Driver

TCP/IP Socket
COM Port
1 -8 Ethernet, FDDI, Token
Ring, more...

W ITS Level 0 Packets

WITS Partner(s)

Figure 1. QuickWITS Interface Package

M/D TOTCO 3
QuickWITS and Wits DDE Connectivity Series

1-1-1-1 Serial Port Connection

Since V-ICIS is Microsoft NT-based, any standard Com port may be
used. Thus, RS 232 or RS 422 interfaced may be supported. As an
option, MDT offers an Ethernet fiber-based COM port server for appli-
cations that require long runs over fiber.

1-1-1-2 Advanced TCP/IP Connection

Operating as a socket-based server, the WITS DDE driver manages
each WITS Partner connection across a predetermined TCP/IP port. In
this manner, multiple connections may be used to pass WITS data into
the V-ICIS environment. Be sure to verify that your WITS software
supports a socket client interface.
1-1-2 Application
The WITS interface is typically used to interface V-ICIS to Mud Logging, Wire
Line and other WITS based systems. Additionally, the interface may be used to
support data collection activities by sending WITS data directly into the V-ICIS
Process Database (ISQL) or MS SQL database (note additional configuration is
required). As the driver supports both reading and writing functions, V-ICIS man-
aged data may also be transmitted to WITS partners.
In a ‘stand alone’ environment, the WITS DDE driver may be used to connect
DDE enabled products such as MS Excel directly to WITS partners for custom
reporting applications.

4 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

1-1-3 MDT WITS DDE Server Key Features

Table 1 defines several key features of the WITS interface package.

Table 1. Key Features of the WITS Interface Package

General

Custom WITS As WITS records 1 to 25 are firmly defined, a majority of WITS interfaces use
Acceptance ‘custom’ defined records for specific purposes.

If the driver notices WITS information that is not ‘registered’ for by the parent
Record/Item application, then such unregistered information may be logged to a comma
watch delineated file at the parent application’s discretion. This mechanism allows for
identification of information coming through the channel, and it’s maintenance.

The WITS DDE driver supports a built in performance monitor so that parent
Performance
applications may monitor the amount of information being received and the
Monitor
rate at which it is received.

Serial Port

Baud Rates & Baud rates between 300 and 56kbps are supported. High rates may require
COM Ports additional hardware. Up to 8 COM ports per computer may be supported.

For situations where multiple COM ports are needed in a remote location, the
Ethernet Port Ethernet Port server may be used. This kit comes complete with NT device
Server drivers, Ethernet/COM port multiplexor, and an optional ethernet Fiber trans-
ceiver.
TCP/IP Port

WITS DDE driver acts as a TCP/IP socket server; WITS partners may connect
Socket Server
as WITS clients.

Each WITS partner connection is supported across a pre-defined TCP/IP port.

Private Port Connection limits are based on specific computing and networking hardware
used.

M/D TOTCO 5
QuickWITS and Wits DDE Connectivity Series

1-1-4 About QuickWITS

QuickWITS is a utility application program that may best be classified as “mid-
dle-ware” or a “data pump”. QuickWITS acts as a DDE client that retrieves data
from DDE servers and then forwards it to a WITS port via the DDE WITS server.
Figure 2 shows QuickWITS architecture.

QuickWITS DDE Client Data 0101 QuickWITS then places the data item in
an associated WITS record that is
QuickWITS registers a "request for data
Data 0102 managed by the WITS DDE Driver. The
item" with the DDE servers. Data is then Data 0103 WITS DDE driver then exchanges the
exchanged between the DDE server and WITS packet with it's WITS partner.
the QuickWITS DDE Client. ....
Data 9999

3rd Party DDE W onderW are

PLC DDE Server W ITS DDE Driver
Server DDE Server

- SIMRAD - Siemens S7 & S5 TCP/IP Socket

- ... More... - Simatic TI 505 COM Port
- GE Fanuc
- Allen Bradley
1-8 Ethernet, FDDI, Token
Data
- MDT DAQ Ring, more...
- Modbus
- ... More... W ITS Level 0 Packets

System PLC W ITS Partner(s)

Figure 2. QuickWITS Architecture

QuickWITS addresses the requirements where V-ICIS information needs to be

transmitted to a WITS partner or were a WITS partner needs information from a
generic DDE server. A key benefit of QuickWITS is that an installation engineer
may configure WITS exchanges to meet the specific requirements of the WITS
partner. Thus, the engineer need only know the V-ICIS “tags” or PLC addresses
that represent the data that needs to be exchanged from the V-ICIS environment to
the WITS partner. Additionally, this is all done without the addition of Wonder-
Ware scripts or custom programming (very important).
Simply put, QuickWITS is used to configure the building and transmitting of
generic DDE Server data (V-ICIS or other) to WITS data consumers.

6 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

2 MDT WITS DDE Server

The following is an outline of MDT WITS DDE Installation and Configuration steps. These steps
must be completed in order to utilize the MDT WITS DDE Server.
1. Install the server
2. Define the communications method you will use with the WITS partner
3. Configure the WITS DDE connection topics
The server is now ready for use.

2-1 WITS DDE Server Installation

Installation is quite easy. The WITS DDE Server comes in a self extracting ZIP file named
“MDTwits.exe”. Your installation steps are as follows:
1. Verify use on NT 4.0 platform with minimal of SP3 installed. If not, then
upgrade NT to proper levels.
2. Create a directory folder on the “C:” drive (you may use another, but C is pre-
ferred for standardization purposes). Use the name “C:\WITSDDE”.
3. Copy the file “MDTwits.exe” into the directory, then execute it. This will
cause the executable files to be extracted into the current directory.
You are now ready to configure topic connections.

2-2 WITS DDE Server Configuration for Topics/Connections

The WITS DDE Server requires you to configure “topics” that are to be referenced from a
DDE Server application such as V-ICIS or QuickWITS. In preparation for the configura-
tion of the MDT DDE Server, you must first know how you plan to connect to the target
equipment. The following is a sample questions must be answered prior to the use of the
WITS DDE Server:
• Serial Connection or TCP?
• If TCP –
— Does the WITS partner support TCP client connects? MDT WITS DDE is only a
TCP server, so if the answer is no, then you may have to go serial.
— Define a TCP/IP address and “port” number to be used between the MDT WITS
DDE application and the WITS partner. Example: for Anadrill, port numbers 6001
through 6005 are typically used.
— Are network provisions in place to support the TCP connection between the sys-
tem running MDT WITS and the WITS partner? I.e. can you ‘ping’ each other.
• If serial –
— What communications parameters are supported? Baud, Stop bits, Data bits, par-
ity, flow control, etc...
— Which communications port will you be using?
— Do you have the proper cables and null modem converters in place (if required)?

M/D TOTCO 7
QuickWITS and Wits DDE Connectivity Series

2-2-1 Configuration Procedure

Configure the WITS DDE server as follows:
1. Getting Started
Start the WITS DDE Server and prepare to configure a system topic. This is
done by selecting ‘System’ from the ‘Configure’ menu (Figure 3).

Figure 3. Selecting “System” From the Configure Menu

2. Serial Connection definition (select “Serial Port”)

To begin the Topic configuration process; in the Topic/Port Configuration
window (Figure 4), identify or define the Topic name that the parent DDE
client application is to use. In this example we can see the default of
“TopicName1” is in place in the “topic” field.

NOTE

Spaces are not allowed.

Figure 4. Topic/Port Configuration Window

8 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

For serial connections, you will need to supply the proper information for commu-
nications settings such as Com port, baud rate, parity, and handshaking (if
present). Additionally, you may choose to modify the special operations fields for
Update Methods, Delay Time-out, and Flush Time. For normal operations, you
should have no need to do so.
Table 2 describes the purpose of these special operations fields.

Table 2. Purpose of Special Operations Fields

Field Purpose

Delay Time-out Time to wait while no data is received before setting the Status item to zero (0).

Flush Time How often to reset all UnReg items, Reg items and RecordsPerSecond.

Depending on load of data coming in, there are three different ways to
process the information. As configurations are highly variable, it is in
the user's best interest to experiment with the different methods to select
a method that best suits the application:
• Event/Proc Call is probably the most efficient when the OS is loaded down
Update Method but not to the point where it is sluggish. Instead of relying on the OS to pro-
(for use in WITS cess the messages, a procedure call is implemented to ensure the data is
receive applica- returned in a timely manner
tions) • Round Robin is the most efficient when there are large amounts of data
coming in (the top end capable depending on baud rate). The data is not
updated as soon as it comes in. Instead, there is a 100ms timer that
updates the data in Round Robin fashion. As the data is received at the
port, it is stored and when the timer fires, the data is sent to the client. Data
is then updated ten times a second.

M/D TOTCO 9
QuickWITS and Wits DDE Connectivity Series

3. TCP Connection definition (select “TCP/IP”)

Figure 5 shows the altered Topic/Port Configuration Window after you select
“TCP/IP” as your connection method.

Figure 5. Topic/Port Configuration Window After Selecting TCP/IP

In configuring a TCP connection, you merely need to specify the connection

port to be used by your WITS partner. The special operations fields are han-
dled in the same manner as described for serial ports.
4. Save the Configuration
When your finished entering the Topic configuration details, review them for
accuracy, then save them. When you click on the “Save Topic” button, your
topic name will be moved to the Topic List located on the left hand side of the
window (Figure 6).

Figure 6. Topic/Port Configuration Window With Topic Name in the Topic List

10 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

5. Close and Exit

If you need to add more connection topics, do so now by repeating steps 2 and
3. When finished, simply hit the close button located on the top right section
of the Topic/Port Configuration window.
You will then see a information box indicating that you must restart MDT
WITS DDE in order for the changes to take effect (Figure 7). Simply click on
OK, and exit the driver by clicking on the driver’s top right corner with the X.

Figure 7. Information Box Indicating Restart of MDT WITS DDE

You are now done. To use the driver, simply restart it and minimize it.

M/D TOTCO 11
QuickWITS and Wits DDE Connectivity Series

2-2-2 WITS DDE ‘Standard’ Item Configuration

Once you’ve configured your Topics, you’re now ready to define items that will
be used with your communications exchange to your WITS partner. The WITS I/
O driver supports records 00-99 and within each record, WITS items 00-99. DDE
item names are defined as follows:
Z:XXYY
Where:
Table 3 lists items that will be used with your communications exchange to your
WITS partner.
Table 3. Purpose of Special Operations Fields

Where: Purpose
Is one of the following letters in uppercase?

Z • I (for integer)
• F (for float)
• A (for strings)
Is the WITS record index (00-99) with leading zeroes specified, i.e., 01, 02,
XX
03, 04...99

Is the WITS item index (00-99) with leading zeroes specified, i.e., 01, 02, 03,
YY
04...99

Example: A:0101 <- Record 1, Item 1, and it’s ASCII

12 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

2-3 WITS DDE Special Items

Table 4 lists WITS DDE special items:
Table 4. WITS DDE Special Items

Item value Description/Purpose/Value returned

Status Driver status. 0 = bad, 1 = good

RecordsPerSecond Number of records per second received by driver. I/O Real†.

Number of unregistered record/items (not active but received at the

UnRegCount
port), I/O Integer†.

Tells driver to dump a csv file containing all UnReg points. Goes false
when write it complete. If DumpUnRegFilename is not defined, the
DumpUnRegCommand
poke fails and a message is logged to the WWLogger (for V-ICIS or
WonderWare environments), I/O Discrete, Read/Write†.

Tells driver the csv filename for UnReg points, I/O Message, Read/
DumpUnRegFilename
Write (node dependent)†.

RegCount Number of registered record/items (active), I/O Integer†.

Tells driver to dump a csv file containing all registered points. Goes
false when write it complete. If DumpRegFilename is not defined, the
DumpRegCommand
poke fails and a message is logged to the WWLogger, I/O Discrete,
Read/Write†.

Tells driver the csv filename for Reg points, I/O Message, Read/Write
DumpRegFilename
(node dependent)†.

Where XX is the record to place in Record Sending Mode. When the

RecordMode:XX item is set to 0 (default), all writes are Atomica. When the item is set
to 1, any writes send the entire record at once†.

Where XX is the record to enable or disable writes for. When the item
SendEnabled:XX is set to 0 (default), no writes occur. When the item is set to 1, writes
are enabled as per the RecordMode:XX item†.

†
These items are dependent on the Topic’s “Flush Time” and are reset at the end of it.
a
The WITS standard defines a set of 25 records. The WITS DDE driver can be config-
ured to transmit full records all of the time. This can be inefficient as you are constantly
transmitting data that does not change. Thus, the WITS DDE driver may be placed in
“atomic” or “exception” mode. When in the “atomic” mode, the WITS DDE driver will
only transmit small data packets that contain WITS items whose value has changed. It
must be noted that the WITS partner MUST support the acceptance of these “atomic”
values; otherwise, you should simply configure the WITS DDE driver to support Record
mode for the specific WITS record.

M/D TOTCO 13
QuickWITS and Wits DDE Connectivity Series

3 QuickWITS
The following is an outline of QuickWITS Installation and Configuration steps. These steps must
be completed in order to utilize the QuickWITS application.
1. Install QuickWITS
2. Define the WITS records you will exchange with the WITS partner
3. Configure the QuickWITS records.
4. Start QuickWITS

3-1 QuickWITS Installation

Installation is quite easy. The QuickWITS package comes in a self extracting ZIP file
named “quickwits.exe”. Your installation steps are as follows:
1. Place QuickWITS in the same directory used for MDT WITS DDE.Typically
this is “C:\WITSDDE”.
2. Copy the file “quickwits.exe” into the directory, then execute it.This will
cause the executable files to be extracted into the current directory.
You are now ready run the QuickWITS application.

14 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

3-2 Using QuickWITS

QuickWITS is easy to use and quick to configure. When QuickWITS comes up, you will
need to begin defining the records that QuickWITS is to send to your WITS partner
(associated with a specific WITS DDE Topic name).
Figure 8 shows the only QuickWITS window used.

Figure 8. QuickWITS Window

M/D TOTCO 15
QuickWITS and Wits DDE Connectivity Series

3-2-1 Defining Records

1. Give your format a name by using the “Current Format” field. Later
you’ll hit the save button to save this format to the WITS record list.
At that point your format may be recalled by clicking on the specific
record in the WITS record list box.
2. Next, enter the WITS DDE topic name associated with the partner for
this WITS record.
3. Enter a valid record ID (1 to 99)
4. Indicate the frequency (in milliseconds) that you want the WITS data
to be written to the WITS device. A minimum value of 100 millisec-
onds may be entered.
5. For debugging purposes, you may specify the location for a trace file
to be outputted by QuickWITS. To enable the Trace, you’ll need to
‘check’ the box labeled ‘Trace On’ QuickWITS will then begin fun-
neling trace information that may be useful in tracing data values and
DDE source information.
6. Configure DDE Sources for specific WITS items by entering in the
required DDE request information. This is done in the format of
“node: Application|topic,item” where:
• “node” is the name of the machine running the DDE server application
• Application is the name of the DDE server application
• Topic is the configured DDE server Topic
• Item is in the format required for by the DDE server
You may also ‘hard code’ a value by placing double quotes around it. This
may be useful when hard coding a rig name or other Ascii field. Example
“SFX Cajun Express”
7. Use the Next 20 and Previous 20 buttons to go to specific WITS item
configurations.
The WITS Value fields are read only and represent the current values being
sent to the WITS partner.
8. Save and Delete buttons may be used to save or delete a selected con-
figuration from the WITS record format list.
9. Once you are satisfied with your WITS record format definition,
select “ready for use” to indicate that QuickWITS may process the
record when QuickWITS becomes active.

16 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

10. Once defined, you may start QuickWITS by selecting the Active
check box located on the top left side of the screen. When active,
QuickWITS will begin the process of registering with the DDE Serv-
ers and preparing the WITS values for transmission by the WITS
DDE Server. Values will become visible in the WITS values column,
and updated in real time. To save CPU utilization, you may disable
the monitoring function by selecting the “Monitor Disable” check
box.
If QuickWITS has a problem in registering with the specified DDE servers, the
background color of the DDE source item field and (and its associated format
identifier) will turn red. You may then choose to use the Trace File options to
determine what the problem is. QuickWITS will retry failed DDE connections to
servers at a default value of every 60 seconds (you may change this value in the
“Reconnect Frequency” field). The WITS partner will NOT receive data for
records that are incomplete. QuickWITS only transmits records whose DDE serv-
ers are reachable. In this manner, it is assured that the WITS partner will only
receive valid WITS records.
QuickWITS may be closed by clicking on the close window X or by selecting
File, then exit. If QuickWITS is closed while active, then the next time Quick-
WITS is started, it will start up and become active as soon as the DDE servers are
available.

M/D TOTCO 17
QuickWITS and Wits DDE Connectivity Series

Appendix A: ASCII Tables

The following are class symbols and their meanings:

A alphabetic B alphanumeric C control
D digit L lowercase P punctuation
U uppercase V printable W white space

Table A-1 Numeric and Keyboard Equivalents of ASCII Characters 0 Through 31

Char Key Dec Oct Hex Class Char Dec Oct Hex Class
NUL ^@ 0 \000 \x00 C Space 32 \040 \x20 PVW
SOH ^A 1 \001 \x01 C ! 33 \041 \x21 PV
STX ^B 2 \002 \x02 C “ 34 \042 \x22 PV
ETX ^C 3 \003 \x03 C # 35 \043 \x23 PV
EOT ^D 4 \004 \x04 C $ 36 \044 \x24 PV
ENQ ^E 5 \005 \x05 C % 37 \045 \x25 PV
ACK ^F 6 \006 \x06 C & 38 \046 \x26 PV
BEL ^G 7 \007 \x07 C ‘ 39 \047 \x27 PV
BS ^H 8 \010 \x08 C ( 40 \050 \x28 PV
TAB ^I 9 \011 \x09 CW ) 41 \051 \x29 PV
LF ^J 10 \012 \x0A CW ^ 42 \052 \x2A PV
VT ^K 11 \013 \x0B CW + 43 \053 \x2B PV
FF ^L 12 \014 \x0C CW , 44 \054 \x2C PV
CR ^M 13 \015 \x0D CW - 45 \055 \x2D PV
SO ^N 14 \016 \x0E C . 46 \056 \x2E PV
SI ^O 15 \017 \x0F C / 47 \057 \x2F PV
DLE ^P 16 \020 \x10 C 0 48 \060 \x30 BDV
DC1 ^Q 17 \021 \x11 C 1 49 \061 \x31 BDV
DC2 ^R 18 \022 \x12 C 2 50 \062 \x32 BDV
DC3 ^S 19 \023 \x13 C 3 51 \063 \x33 BDV
DC4 ^T 20 \024 \x14 C 4 52 \064 \x34 BDV
NAK ^U 21 \025 \x15 C 5 53 \065 \x35 BDV
SYN ^V 22 \026 \x16 C 6 54 \066 \x36 BDV
ETB ^W 23 \027 \x17 C 7 55 \067 \x37 BDV
CAN ^X 24 \030 \x18 C 8 56 \070 \x38 BDV
EM ^Y 25 \031 \x19 C 9 57 \071 \x39 BDV
SUB ^Z 26 \032 \x1A C : 58 \072 \x3A PV
ESC ^[ 27 \033 \x1B C ; 59 \073 \x3B PV
FS ^\ 28 \034 \x1C C < 60 \074 \x3C PV
GS ^] 29 \035 \x1D C = 61 \075 \x3D PV
RS ^^ 30 \036 \x1E C > 62 \076 \x3E PV
US ^_ 31 \037 \x1F C ? 63 \077 \x3F PV

18 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

Table A-2 Numeric Equivalents of ASCII Characters 64 Through 95

Char Dec Oct Hex Class Char Dec Oct Hex Class
@ 64 \100 \x40 PV 96 \140 \x60 PV
A 65 \101 \x41 ABUV a 97 \141 \x61 ABLV
B 66 \102 \x42 ABUV b 98 \142 \x62 ABLV
C 67 \103 \x43 ABUV c 99 \143 \x63 ABLV
D 68 \104 \x44 ABUV d 100 \144 \x64 ABLV
E 69 \105 \x45 ABUV e 101 \145 \x65 ABLV
F 70 \106 \x46 ABUV f 102 \146 \x66 ABLV
G 71 \107 \x47 ABUV g 103 \147 \x67 ABLV
H 72 \110 \x48 ABUV h 104 \150 \x68 ABLV
I 73 \111 \x49 ABUV i 105 \151 \x69 ABLV
J 74 \112 \x4A ABUV j 106 \152 \x6A ABLV
K 75 \113 \x4B ABUV k 107 \153 \x6B ABLV
L 76 \114 \x4C ABUV l 108 \154 \x6C ABLV
M 77 \115 \X4D ABUV m 109 \155 \x6D ABLV
N 78 \116 \x4E ABUV n 110 \156 \x6E ABLV
O 79 \117 \x4F ABUV o 111 \157 \x6F ABLV
P 80 \120 \x50 ABUV p 112 \160 \x70 ABLV
Q 81 \121 \x51 ABUV q 113 \161 \x71 ABLV
R 82 \122 \x52 ABUV r 114 \162 \x72 ABLV
S 83 \123 \x53 ABUV s 115 \163 \x73 ABLV
T 84 \124 \x54 ABUV t 116 \164 \x74 ABLV
U 85 \125 \x55 ABUV u 117 \165 \x75 ABLV
V 86 \126 \x56 ABUV v 118 \166 \x76 ABLV
W 87 \127 \x57 ABUV w 119 \167 \x77 ABLV
X 88 \130 \x58 ABUV x 120 \170 \x78 ABLV
Y 89 \131 \x59 ABUV y 121 \171 \x79 ABLV
Z 90 \132 \x5A ABUV z 122 \172 \x7A ABLV
[ 91 \133 \x5B PV { 123 \173 \x7B PV
\ 92 \134 \x5C PV | 124 \174 \x7C PV
] 93 \135 \x5D PV } 125 \175 \x7D PV
^ 94 \136 \x5E PV ~ 126 \176 \x7E PV
_ 95 \137 \x5F PV del 127 \177 \x7F C

M/D TOTCO 19
QuickWITS and Wits DDE Connectivity Series

Appendix B: RS-232 Pinouts and Cable Information

Figures B1 through B-4 show RS-232 pinout and cable information.

Figure B-1 RS-232 DB9 Male Connector

Figure B-2 RS-232 Adapter

20 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

Figure B-3 RS232 DB25 Male Connector

M/D TOTCO 21
QuickWITS and Wits DDE Connectivity Series

Figure B-4 Null Modem Adapters

22 M/D TOTCO
Connectivity Series QuickWITS and Wits DDE

Appendix C: Ethernet Pinouts and Cross Over Cable

Figures C-1 and C-2 show Ethernet pinout and cross-over cable information.

Figure C-1 Ethernet RJ45 Socket 10baseT

Figure C-2 RJ-45 Cross Over Cable

M/D TOTCO 23
QuickWITS and Wits DDE Connectivity Series

24 M/D TOTCO