Synergy XML API: A customer case study Synergy/DE ... - Synergex
Synergy XML API: A customer case study Synergy/DE ... - Synergex
Synergy XML API: A customer case study Synergy/DE ... - Synergex
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Vol 16 Issue 1<br />
Synerg-E-News...a year in review.<br />
CONNECTION<br />
<strong>Synergy</strong>/<strong>DE</strong> extends the reach<br />
of <strong>Synergy</strong> business applications<br />
<strong>Synergex</strong> ® delivered important<br />
new technologies and features in<br />
2003 with <strong>Synergy</strong>/<strong>DE</strong> 8.1,<br />
8.1.3, and 8.1.5. These versions<br />
introduced an <strong>API</strong> for <strong>XML</strong> and<br />
support for HTTPS (8.1), Java<br />
connection pooling (8.1.3),<br />
xfServerPlus performance improvements<br />
(8.1.3), and client/server<br />
debugging capabilities (8.1.5),<br />
enabling developers worldwide to<br />
create dynamic, high-performing<br />
solutions to fit their vertical<br />
application needs.<br />
Version 8.1: <strong>XML</strong> <strong>API</strong>, HTTPS,<br />
and more<br />
In February 2003, <strong>Synergex</strong><br />
released <strong>Synergy</strong>/<strong>DE</strong> 8.1 with an<br />
<strong>Synergy</strong> <strong>XML</strong> <strong>API</strong>: A <strong>customer</strong> <strong>case</strong> <strong>study</strong><br />
Forward Computers Limited<br />
(Forward), located in Nottingham,<br />
United Kingdom, provides management<br />
information and e-<br />
commerce solutions to the international<br />
freight industry. Recently,<br />
Forward needed a solution for one<br />
of their <strong>customer</strong>s, The Elite Group<br />
of Leeds, UK, an international<br />
freight agent that manages the<br />
import of goods on behalf of many<br />
major clothing retailers in the<br />
United Kingdom. These retailers,<br />
in turn, source the merchandise<br />
from a variety of manufacturers<br />
around the world. For each<br />
purchase order (PO) given to a<br />
supplier, the retailer needs to be<br />
kept up-to-date on shipping<br />
<strong>XML</strong> <strong>API</strong> and support for<br />
HTTPS, features that enable<br />
<strong>customer</strong>s to interface with more<br />
third-party applications and to<br />
enhance communication between<br />
their <strong>Synergy</strong> ® application<br />
components.<br />
<strong>XML</strong> <strong>API</strong> and HTTPS Support<br />
The new <strong>XML</strong> <strong>API</strong> enables<br />
<strong>Synergy</strong> developers to parse and<br />
assemble <strong>XML</strong> documents. HTTPS<br />
support enables secure communications<br />
via Secure Socket Layer<br />
(SSL).<br />
“With version 8.1’s new <strong>XML</strong><br />
and HTTPS features, our <strong>customer</strong>s<br />
will find it even easier to build<br />
open solutions that interact with<br />
information, expected arrival dates,<br />
shipped quantities, customs<br />
clearance details, and so forth.<br />
Forward’s business requirement<br />
was to support a bi-directional<br />
electronic interface,<br />
allowing retailers<br />
and freight agents to<br />
update and exchange<br />
PO information as<br />
each PO moves<br />
through the supply<br />
chain. Forward<br />
made the decision to<br />
represent PO data<br />
within <strong>XML</strong> documents, which are<br />
physically transferred between<br />
systems using File Transfer<br />
Protocol (FTP).<br />
“With the <strong>XML</strong> <strong>API</strong>, we<br />
were able to implement an<br />
application that does<br />
exactly what we want it to,<br />
and which more than<br />
adequately covers our<br />
<strong>customer</strong>’s requirements.”<br />
<strong>Synergy</strong>/<strong>DE</strong> to support<br />
Microsoft .NET<br />
Framework and Visual<br />
Studio .NET<br />
(See page 3 for details...)<br />
(See page<br />
28 for<br />
details).<br />
other industry-standard applications<br />
and services,” said Cindy Limburg,<br />
<strong>Synergy</strong>/<strong>DE</strong> product manager at<br />
<strong>Synergex</strong>.<br />
“This is the best <strong>Synergy</strong>/<strong>DE</strong><br />
upgrade I’ve seen so far,” said Deborah<br />
Dube, Software Engineer at C.H.<br />
Continued on page 4<br />
Forward decided to use the <strong>Synergy</strong><br />
<strong>XML</strong> <strong>API</strong> routines to generate <strong>XML</strong><br />
output for this business requirement.<br />
“The <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> routines are<br />
extremely useful and easy to use,” said<br />
Ken Stewart, director at<br />
Forward Computers<br />
Limited. “With the<br />
<strong>XML</strong> <strong>API</strong>, we were able<br />
to implement an<br />
application that does<br />
exactly what we want it<br />
to, and which more than<br />
adequately covers our<br />
<strong>customer</strong>’s requirements.”<br />
With the new application,<br />
ForwardVision, The Elite Group can<br />
now define and configure specific<br />
<strong>XML</strong>-based electronic interfaces to<br />
Continued on page 5<br />
A Publication for Professional Developers and Users
from the<br />
EDITOR…<br />
2003 was a productive year—for<br />
<strong>Synergex</strong> and for our <strong>customer</strong>s. The<br />
release of <strong>Synergy</strong>/<strong>DE</strong> version 8 delivered<br />
important new technologies and<br />
features, such as <strong>XML</strong> and HTTPS<br />
support, Java connection pooling,<br />
xfServerPlus performance improvements<br />
and client/server debugging capabilities.<br />
And our <strong>customer</strong>s were busy implementing<br />
the latest technologies into their<br />
<strong>Synergy</strong> applications. Read on page 1<br />
how Forward Computers used the<br />
<strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> to support a bidirectional<br />
electronic interface in their<br />
application. On page 15, see how Webbased<br />
systems from Radley Corporation<br />
are streamlining ordering and shipping<br />
tasks for automotive and heavy equipment<br />
suppliers. Go to page 20 to read<br />
about how The Pepsi Bottling Group has<br />
selected <strong>Synergy</strong>/<strong>DE</strong>-based SDMS from<br />
Global Beverage Group as its “route<br />
accounting” solution for its Canadian<br />
business. And more…<br />
In 2003, we also introduced a new<br />
multiple-location regional format for the<br />
SPC. Read about the conference on page<br />
28, and find out how to unleash the<br />
power of your <strong>Synergy</strong> applications at<br />
SPC 2004.<br />
Recapping a year’s worth of<br />
information-packed articles from our biweekly<br />
newsletter, Synerg-E-News, this<br />
issue of Connection includes <strong>customer</strong><br />
successes, valuable tech tips, comprehensive<br />
product information, and more. We<br />
look forward to a productive 2004, and<br />
are here to help you as you extend the<br />
reach of your <strong>Synergy</strong> applications.<br />
Elizabeth Marmins, Editor<br />
THE CONNECTION STAFF<br />
Editor: Elizabeth Marmins<br />
Managing Editor: Ingrid Sides<br />
Contributors: Rosanne Brill, William Hawkins,<br />
Linda Kelley, Cindy Limburg, Matt Linder,<br />
Penelope Perkins, and Mary Ribacchi<br />
<strong>Synergex</strong> Connection is published for professional developers,<br />
resellers, consultants, vendors, and corporate users. Copyright<br />
2004 <strong>Synergex</strong>. All rights reserved.<br />
Trademarks: DBL, <strong>Synergy</strong>, <strong>Synergy</strong> Development Environment,<br />
xfSeries, and <strong>Synergy</strong>/<strong>DE</strong> are trademarks of <strong>Synergex</strong>. All other<br />
product and company names in this newsletter are trademarks of<br />
their respective holders.<br />
Where in the World Is<br />
SYNERGY/<strong>DE</strong>?<br />
Managing operations for a<br />
dialysis service provider<br />
DaVita Laboratory Services is<br />
a wholly owned subsidiary of<br />
DaVita, Inc., the second largest<br />
provider of dialysis services in the<br />
United States for patients suffering<br />
from chronic kidney failure, also<br />
known as end stage renal disease<br />
(ESRD). The laboratory, located in<br />
DeLand, Florida, uses a customdesigned<br />
<strong>Synergy</strong>/<strong>DE</strong> suite of<br />
applications to manage its day-today<br />
operations. The laboratory<br />
information system, Ref-Lab, is<br />
implemented on OpenVMS Alpha.<br />
Ref-Lab addresses all activities<br />
related to operating a major ESRD<br />
laboratory, including electronic<br />
remote order entry, barcode driven<br />
accessioning, specimen inventory,<br />
instrument interfaces, remote<br />
transmission of lab results, and a<br />
complete accounts receivable,<br />
billing, and collections system. The<br />
system also maintains several WAN<br />
interfaces to corporate Microsoft<br />
SQL databases using <strong>Synergy</strong>/<strong>DE</strong><br />
SQL Connection. The laboratory<br />
was recently awarded the College of<br />
American Pathologists (CAP)<br />
certification, the highest level of<br />
accreditation that can be achieved by<br />
a medical laboratory.<br />
For more information, visit<br />
DaVita’s Web site at<br />
http://www.davita.com/.<br />
Strike a pose! <strong>Synergy</strong>/<strong>DE</strong> is in<br />
the world of photography.<br />
Based in Newton Abbot in<br />
Devon, England, Harrier LLC is the<br />
leading mail order film development<br />
company in the United Kingdom<br />
with a <strong>customer</strong> base of approximately<br />
four million. With workers<br />
ranging in number from 200-400<br />
throughout the year, Harrier is one of<br />
the larger employers in the Devon<br />
area.<br />
Harrier uses the <strong>Synergy</strong>/<strong>DE</strong>-built<br />
Abbots application to process orders<br />
for the company’s mail order photo<br />
developing and printing business. All<br />
orders received are logged into the<br />
system, which is then updated with<br />
<strong>customer</strong> details. The Abbots system<br />
then produces dispatch documentation<br />
and sorting information. “The<br />
Abbots system collects all of the data<br />
necessary to help us analyze marketing<br />
trends and organize <strong>customer</strong><br />
enquiries,” said Andrew Bascombe,<br />
IT Manager at Harrier. “We are glad<br />
that we have created a system that is<br />
backed by reliable software development<br />
tools.”<br />
Harrier processes mostly 35mm<br />
film, although Advanced Photo<br />
System (APS) film currently constitutes<br />
almost 20 percent of Harrier’s<br />
business. In addition, Harrier makes<br />
photo CDs and is looking into<br />
forming alliances with e-commerce<br />
companies to offer printing services<br />
for <strong>customer</strong>s who use digital<br />
cameras. Although Harrier continues<br />
to see 35mm processing as the<br />
mainstay of their business, the<br />
company is also starting to do limited<br />
trials on Internet uploads.<br />
http://www.truprint.co.uk<br />
<strong>Synergy</strong>/<strong>DE</strong> brings home the<br />
bacon!<br />
Smithfield Foods, Inc., is the<br />
largest hog producer and pork<br />
processor in the world. Throughout<br />
the United States and Canada, in<br />
Continued on page 29<br />
ACCURACY IS OUR GOAL<br />
Delivering accurate technical and business information is a <strong>Synergex</strong> priority. Although<br />
we do our best to publish quality, accurate, timely information, sometimes information<br />
is incorrect or causes confusion.<br />
If you find any published <strong>Synergex</strong> information that you think may be incorrect or<br />
needs clarification, please send an e-mail message to mailto:synergy@synergex.com.<br />
2
<strong>customer</strong> success<br />
APPS IN ACTION<br />
<strong>Synergy</strong>/<strong>DE</strong> xfODBC enhances AgTrax Software 7.0<br />
AgTrax users can now produce reports with third-party tools, such as Crystal Reports and Microsoft<br />
Excel.<br />
AgTrax Technologies (AgTrax), a leading developer of accounting software for agricultural businesses throughout<br />
the Midwest, announced the release of version 7.0 of their core product, AgTrax Software.<br />
The new version, featuring <strong>Synergy</strong>/<strong>DE</strong> xfODBC, enables AgTrax’s users to access<br />
their accounting data from Crystal Reports ® , Microsoft Excel, and any other ODBCcompliant<br />
application.<br />
<strong>Synergy</strong>/<strong>DE</strong>-based AgTrax Software helps manage the food production process in<br />
rural America from the planted seed all the way to food processing companies. The new<br />
version enables AgTrax’s <strong>customer</strong>s to receive customized managerial reports that were<br />
previously not available or that required special programming. In addition, AgTrax has<br />
created a section on their Web site where <strong>customer</strong>s can download and use sample<br />
reports in Crystal Reports or Microsoft Excel.<br />
“Not only does <strong>Synergy</strong>/<strong>DE</strong> xfODBC enable our end users to obtain custom reports,<br />
but it also allows us—as the developers—to free up valuable development resources by<br />
outsourcing reporting to third-party tools,” says Jeff Jackson, general manager at<br />
AgTrax. “We really like the freedom that xfODBC gives us as a standard ODBC data source.”<br />
“<strong>Synergy</strong>/<strong>DE</strong> provides<br />
the foundation that we<br />
require, the portability<br />
we need, and continues<br />
to demonstrate the<br />
future vision and<br />
direction we want to<br />
follow.”<br />
--Gayle Lewis, AgTrax<br />
Jackson’s top choice for a third-party reporting tool is Crystal Reports. “It’s the most powerful ODBC-compliant<br />
tool we’ve seen. The ability to access multiple data sources makes it very usable and unique.”<br />
AgTrax has been a <strong>Synergex</strong> <strong>customer</strong> since September 1996. Gayle Lewis, development manager at AgTrax,<br />
comments, “<strong>Synergy</strong>/<strong>DE</strong> provides the foundation that we require, the portability we need, and continues to demonstrate<br />
the future vision and direction we want to follow.”<br />
About AgTrax Technologies<br />
A part of Integrated Solutions Group (ISG), AgTrax Technologies is a technology provider to agribusinesses<br />
throughout the Midwest. Based in Hutchinson, Kansas, AgTrax has the fastest growing <strong>customer</strong> base in the market,<br />
and offers state-of-the-art conversions, seamless third-party interfacing, VPN technology, and wireless technology<br />
experience. Future developments at AgTrax include Palm Computing and Web-enabled applications, vendor service<br />
bundling, and e-commerce.<br />
http://www.agtrax.com<br />
See how <strong>Synergy</strong>/<strong>DE</strong>-based AgTrax software enables online grain grading and certification, which dramatically<br />
reduces shipping-to-payment cycle for grain shippers.<br />
http://www.synergex.com/news/Articledetail.asp?id=2454<br />
<strong>Synergy</strong>/<strong>DE</strong> to support Microsoft .NET Framework and<br />
Visual Studio .NET<br />
<strong>Synergex</strong> plans to support the Microsoft .NET Framework and Visual Studio .NET with <strong>Synergy</strong>/<strong>DE</strong>.<br />
<strong>Synergex</strong> will develop a compiler that will enable <strong>Synergy</strong> developers to migrate their existing <strong>Synergy</strong> applications<br />
to the Microsoft .NET Framework. <strong>Synergex</strong> will also integrate <strong>Synergy</strong>/<strong>DE</strong> with Visual Studio .NET, enabling developers<br />
to edit, build, run, and debug their <strong>Synergy</strong> applications within the powerful Visual Studio .NET environment.<br />
With <strong>Synergy</strong>/<strong>DE</strong>’s support for the Microsoft .NET Framework and Visual Studio .NET, <strong>Synergy</strong> developers will be<br />
able to take advantage of Microsoft’s latest technologies, including tools for creating and deploying <strong>XML</strong> Web services.<br />
“We see a lot of excitement surrounding the Microsoft .NET Framework and Visual Studio .NET in the industry and<br />
in our <strong>customer</strong> base, and we are pleased to inform our <strong>customer</strong>s that we will offer them a migration path to these<br />
important new technologies,” said William Mooney, General Manager of the <strong>Synergy</strong>/<strong>DE</strong> Business Unit.<br />
Continued on page 23<br />
3
<strong>Synergy</strong>/<strong>DE</strong> 8.1<br />
Continued from page 1<br />
developer productivity<br />
WORKING SMART<br />
“This is the best <strong>Synergy</strong>/<strong>DE</strong><br />
upgrade I’ve seen so far. Most<br />
of our system is written using<br />
<strong>Synergy</strong>/<strong>DE</strong> UI Toolkit on<br />
OpenVMS Alpha, and the<br />
upgrade to version 8.1 worked<br />
wonderfully! With <strong>Synergy</strong>/<br />
<strong>DE</strong> 8.1, I will be able to<br />
work with <strong>XML</strong> data more<br />
easily. I am now in the<br />
process of modifying my <strong>XML</strong><br />
data converter to use the<br />
<strong>Synergy</strong> <strong>XML</strong> <strong>API</strong>.”<br />
--Deborah Dube, Software<br />
Engineer at C.H. Powell<br />
Company<br />
Powell Company. “Most of our<br />
system is written using <strong>Synergy</strong>/<strong>DE</strong><br />
UI Toolkit on OpenVMS Alpha,<br />
and the upgrade to version 8.1<br />
worked wonderfully! With<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1, I will be able to<br />
work with <strong>XML</strong> data more easily. I<br />
am now in the process of modifying<br />
my <strong>XML</strong> data converter to use<br />
the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong>.”<br />
Other Product Enhancements<br />
In addition to an <strong>XML</strong> <strong>API</strong> and<br />
HTTPS support, <strong>Synergy</strong>/<strong>DE</strong> 8.1<br />
delivers many other enhancements<br />
with which developers can add<br />
value to their <strong>Synergy</strong> applications:<br />
• <strong>Synergy</strong>/<strong>DE</strong> xfODBC<br />
enhancements, such as system<br />
catalog caching<br />
• New UI Toolkit features, such<br />
as scrolling input fields<br />
• <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus<br />
support for arguments larger than<br />
64K<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.3: Java connection<br />
pooling dramatically<br />
speeds up Web applications.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.3, released in<br />
May 2003, show<strong>case</strong>s a new<br />
feature, Java connection pooling,<br />
which can improve the performance<br />
of Java applications and<br />
JavaServer Pages (JSP).<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.3 also delivers<br />
Microsoft ® Windows Server<br />
2003 support, in addition to<br />
product enhancements and quality<br />
improvements throughout the<br />
<strong>Synergy</strong>/<strong>DE</strong> product suite.<br />
Java Connection Pooling<br />
Java connection pooling<br />
dramatically reduces the response<br />
time required to execute <strong>Synergy</strong><br />
methods with <strong>Synergy</strong>/<strong>DE</strong><br />
xfNetLink Java Edition. Java<br />
connection pooling enables you to<br />
create a pool of connections to<br />
<strong>Synergy</strong>/<strong>DE</strong> xfServerPlus, connections<br />
which are active and ready to<br />
use when your xfNetLink Java<br />
client makes a request. Depending<br />
on your application, pooling<br />
connections can greatly speed up<br />
Web applications by reducing the<br />
amount of time required to make<br />
the Java-to-<strong>Synergy</strong> connection.<br />
Pooling is of most benefit in JSP<br />
applications and in other Java<br />
applications, such as J2EE<br />
applications, in which multiple<br />
users access a single Java Virtual<br />
Machine running on a server.<br />
Windows Server 2003 Support<br />
With version 8.1.3, <strong>Synergy</strong>/<strong>DE</strong><br />
is certified for use with Windows<br />
Server 2003, which Microsoft says<br />
“takes the best of Windows 2000<br />
Server technology and makes it<br />
easier to deploy, manage, and use.”<br />
Windows Server 2003 also<br />
incorporates .NET functionality,<br />
including<br />
• The Microsoft .NET Framework<br />
• The Microsoft <strong>XML</strong> Web<br />
services platform<br />
• Deep integration of Microsoft<br />
.NET Passport with Active Directory<br />
® service<br />
• Native support for SOAPbased<br />
<strong>XML</strong> Web services<br />
• Full integration of the COM+<br />
component architecture with <strong>XML</strong><br />
Web services through the .NET<br />
Framework<br />
Other Product Enhancements<br />
In addition to Java connection<br />
pooling and Windows Server 2003<br />
support, <strong>Synergy</strong>/<strong>DE</strong> 8.1.3 includes<br />
new <strong>XML</strong> routines, significant<br />
enhancements to <strong>Synergy</strong>/<strong>DE</strong><br />
xfODBC performance, a new<br />
information advisor in isutl,<br />
support for up to 1024 channels<br />
(requires Operating System<br />
parameter changes), and support<br />
for Unix job control. This release<br />
also incorporates a number of<br />
quality improvements, including<br />
fixes to the ActiveX list display,<br />
<strong>Synergy</strong>/<strong>DE</strong> UI Toolkit radio<br />
button positioning, isutl, and<br />
<strong>Synergy</strong>/<strong>DE</strong> xfSeries temp file<br />
processing on Windows XP.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.5: New features<br />
speed up distributed<br />
applications and facilitate<br />
remote debugging<br />
In October 2003, <strong>Synergex</strong><br />
released version 8.1.5, which<br />
includes xfServerPlus performance<br />
improvements and client/server<br />
debugging capabilities, enabling<br />
<strong>customer</strong>s to speed up their<br />
distributed applications and to<br />
debug their distributed (and other)<br />
Continued on page 5<br />
4
KNOWLEDGE TRANSFER<br />
“The <strong>Synergy</strong>/<strong>DE</strong> 8.1.5 debug<br />
capabilities provide a much better<br />
way to interactively debug remote<br />
routines.”<br />
--Bret Tenny, Datatrac<br />
Corporation’s Director of<br />
Engineering<br />
“I performed a timing test of<br />
xfNetlink.NET/xfServerPlus,<br />
transferring a very large <strong>XML</strong><br />
document as an argument.<br />
With the new xfServerPlus<br />
compression on, we’re at 12.5<br />
seconds. Prior to this, the time<br />
was two minutes and 30<br />
seconds. I LIKE IT!”<br />
--Chip Camden, owner of<br />
Camden Software Consulting.<br />
applications more effectively.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.5 also delivers<br />
product enhancements and quality<br />
improvements throughout the<br />
<strong>Synergy</strong>/<strong>DE</strong> product suite.<br />
xfServerPlus Performance Improvements<br />
Optimizations to internal<br />
xfServerPlus processing, a new<br />
xfServerPlus compression feature,<br />
and improved xfNetLink performance<br />
with arrays of structures<br />
enable <strong>customer</strong>s to improve the<br />
performance of their distributed<br />
<strong>Synergy</strong> applications. One <strong>customer</strong><br />
already benefiting from<br />
these improvements is Chip<br />
Camden, owner of Camden<br />
Software Consulting. “I performed<br />
a timing test of xfNetlink .NET/<br />
xfServerPlus, transferring a very<br />
large <strong>XML</strong> document as an<br />
argument. With the new<br />
xfServerPlus compression on,<br />
we’re at 12.5 seconds,” states<br />
Camden. “Prior to this, the time<br />
was two minutes and 30 seconds. I<br />
LIKE IT!”<br />
Client/Server Debugging Capabilities<br />
The <strong>Synergy</strong> Language<br />
debugger can now be used in a<br />
client/server configuration on<br />
Windows and Unix, making it<br />
easier for <strong>customer</strong>s to debug<br />
distributed applications, applications<br />
running as detached processes<br />
on Unix or as services or scheduled<br />
tasks on Windows, HTTP server<br />
applications, and other applications<br />
where it would be helpful to debug<br />
from a separate client system. “We<br />
like the new 8.1.5 client/server<br />
debugger feature very much,”<br />
states Bret Tenny, Datatrac<br />
Corporation’s Director of Engineering.<br />
“Our previous methods of<br />
debugging the routines that we<br />
access remotely with xfServerPlus<br />
were time-consuming and cumbersome.<br />
The <strong>Synergy</strong>/<strong>DE</strong> 8.1.5 debug<br />
capabilities provide a much better<br />
way to interactively debug remote<br />
routines.”<br />
Other Product Enhancements<br />
In addition to xfServerPlus<br />
performance improvements and<br />
client/server debugging capabilities,<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1.5 includes an<br />
OPENELB debugger command to<br />
facilitate debugging of ELB<br />
routines, a new database driver to<br />
enable more effective SQL Server<br />
access, xfODBC join performance<br />
improvements, Servstat enhancements<br />
on OpenVMS, improved<br />
installation of Microsoft Data<br />
Access Components (MDAC), new<br />
ISUTL options, a new version of the<br />
FarPoint Spread control, and<br />
numerous fixes throughout the<br />
<strong>Synergy</strong>/<strong>DE</strong> product suite.<br />
<strong>XML</strong> <strong>API</strong><br />
Continued from page 1<br />
each of their <strong>customer</strong>’s individual<br />
requirements.<br />
Forward previously developed their<br />
own <strong>XML</strong> parser for an earlier project<br />
(before the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> was<br />
available). They now have plans in<br />
place to modify their <strong>XML</strong> parser so<br />
they can make use of the <strong>XML</strong> <strong>API</strong><br />
routines to retrieve the data contained<br />
in each inbound <strong>XML</strong> document.<br />
Stewart continues, “Once again, we<br />
leave it to <strong>Synergex</strong> to do the difficult<br />
work while we reduce our own code<br />
commitment—that’s just the way we<br />
like it!”<br />
For more information about Forward,<br />
visit their Web site at<br />
http://www.forward-comp.co.uk.<br />
5
UP & RUNNING<br />
The <strong>Synergy</strong> Configuration Program:<br />
Making Your Job Easier<br />
Save time and reduce errors<br />
when configuring <strong>Synergy</strong>/<strong>DE</strong>!<br />
Introduced with <strong>Synergy</strong>/<strong>DE</strong><br />
7.3.1, the <strong>Synergy</strong> Configuration<br />
Program (synconfig) simplifies<br />
your <strong>Synergy</strong>/<strong>DE</strong> configuration<br />
tasks on Windows. Tasks that you<br />
previously completed from the<br />
command line or by editing the<br />
registry can now be accomplished<br />
easily with this GUI utility. And<br />
synconfig centralizes all of your<br />
<strong>Synergy</strong>/<strong>DE</strong> configuration and<br />
management tasks, so you’ll know<br />
where to go when you need to<br />
review or update your <strong>Synergy</strong>/<strong>DE</strong><br />
configuration.<br />
“We wanted to simplify the<br />
effort required to manage the<br />
multiple <strong>Synergy</strong>/<strong>DE</strong> products and<br />
servers that are deployed in a<br />
typical <strong>Synergy</strong> environment,” said<br />
Cindy Limburg, <strong>Synergy</strong>/<strong>DE</strong><br />
Product Manager. “With synconfig,<br />
we have accomplished this.”<br />
Experience the following<br />
benefits with the <strong>Synergy</strong> Configuration<br />
Program:<br />
Obtain product keys online.<br />
HelpDesk Support <strong>customer</strong>s<br />
can use synconfig to quickly obtain<br />
product keys. After placing a<br />
product order (with a <strong>Synergy</strong>/<strong>DE</strong><br />
Account Manager), you can easily<br />
obtain product keys for the<br />
machine on which you are running<br />
synconfig. When you select the<br />
“Obtain Keys Online” option in<br />
synconfig, it will link to the<br />
<strong>Synergy</strong>/<strong>DE</strong> Resource Center on<br />
the <strong>Synergex</strong> Web site, passing<br />
along the licensee name and<br />
registration string from your<br />
machine. You can then either<br />
download your keys or have them<br />
e-mailed to you. (If you prefer not<br />
to use the <strong>Synergy</strong>/<strong>DE</strong> Resource<br />
Center, you can use synconfig<br />
either to send an e-mail message<br />
with your registration information to<br />
a <strong>Synergy</strong>/<strong>DE</strong> Account Manager, or<br />
to print your registration information.<br />
You can then fax or mail this<br />
information to <strong>Synergex</strong>.)<br />
Install your product keys.<br />
When you download your<br />
product keys or have them e-mailed<br />
to you, they are delivered in the<br />
form of a <strong>Synergy</strong> key file. You can<br />
use the <strong>Synergy</strong> Configuration<br />
Program to view the contents of this<br />
file and to install the keys on your<br />
system. If the key file includes keys<br />
for multiple machines, synconfig<br />
will install just the keys for the<br />
system on which it is running.<br />
(When accessed from synconfig, the<br />
<strong>Synergy</strong>/<strong>DE</strong> Resource Center<br />
generates keys only for the machine<br />
on which synconfig is running.<br />
However, you can also access the<br />
<strong>Synergy</strong>/<strong>DE</strong> Resource Center<br />
directly from the <strong>Synergex</strong> Web site<br />
(i.e., without synconfig) to create<br />
key files containing keys for<br />
multiple machines.)<br />
View your license information<br />
and manage your license<br />
configuration.<br />
License management is easy with<br />
the <strong>Synergy</strong> Configuration Program.<br />
Synconfig allows you to easily view<br />
your machine’s current license<br />
information, including licensee<br />
name, registration string, and<br />
installed keys. And it allows you to<br />
view and update your license<br />
configuration—stand-alone, client,<br />
or server.<br />
View and update your SQL<br />
Connection configuration.<br />
If <strong>Synergy</strong>/<strong>DE</strong> Connectivity<br />
Series is installed, synconfig will<br />
display the version of Oracle or<br />
SQL Server currently in use, and<br />
the versions supported by SQL<br />
Connection. If you update a<br />
database, you can add the proper<br />
database drivers simply by selecting<br />
the new version of the database<br />
in the synconfig dialog. This<br />
eliminates the need to copy and<br />
rename the driver files manually.<br />
Starting with <strong>Synergy</strong>/<strong>DE</strong> 7.3.3,<br />
you can also start and stop SQL<br />
OpenNet Server from synconfig.<br />
Update <strong>Synergy</strong>/<strong>DE</strong> xfServer<br />
and xfServerPlus services<br />
easily.<br />
You can view a list of the<br />
current xfServer and xfServerPlus<br />
services on your machine. The<br />
<strong>Synergy</strong> Configuration Program<br />
will show the service name, port<br />
number, and status of xfServer /<br />
xfServerPlus services. Using this<br />
dialog, a service can be added or<br />
removed, started or stopped; and<br />
the properties of a service can be<br />
modified. When a service is added,<br />
you can specify whether data<br />
access will be secure or nonsecure,<br />
and whether event logging<br />
will be enabled. In addition,<br />
environment variables for the<br />
service can be defined, either as<br />
local to a specific service or as<br />
available to all services. Synconfig<br />
will update the registry with all of<br />
the new information.<br />
Install your Professional Series<br />
Workbench Visual SlickEdit<br />
key.<br />
Starting with <strong>Synergy</strong>/<strong>DE</strong> 7.3.3,<br />
you can enter your SlickEdit key<br />
via the <strong>Synergy</strong> Configuration<br />
Program, instead of during<br />
installation. This enables you to<br />
complete your <strong>Synergy</strong>/<strong>DE</strong><br />
installation without having your<br />
Continued on page 27<br />
6
Resolving Your Database Problems with Fcompare<br />
KNOWLEDGE TRANSFER<br />
by Mary Ribacchi, <strong>Synergex</strong> Software Test Engineer<br />
Are you experiencing problems<br />
with your <strong>Synergy</strong> database?<br />
Getting erroneous data in your<br />
reports? Not getting the expected<br />
performance from <strong>Synergy</strong>/<strong>DE</strong><br />
xfODBC? These are all symptoms<br />
of synchronization problems within<br />
the database. Any discrepancy<br />
between how database elements are<br />
defined and how they are being<br />
used can have a big impact on<br />
database performance. The<br />
alignment of the data files with the<br />
database definition files (i.e.,<br />
repository or system catalog files)<br />
is crucial to the performance of<br />
<strong>Synergy</strong> programs that function<br />
from these definitions (such as<br />
<strong>Synergy</strong>/<strong>DE</strong> ReportWriter and<br />
xfODBC). The <strong>Synergy</strong>/<strong>DE</strong> file<br />
compare utility (fcompare) is a tool<br />
that points out such synchronization<br />
problems. Often used by<br />
<strong>Synergex</strong> developers and support<br />
representatives to debug database<br />
problems, fcompare is easy to use<br />
and comes bundled as a core<br />
component with <strong>Synergy</strong>/<strong>DE</strong> 7.3<br />
and higher. Fcompare identifies<br />
synchronization problems so that<br />
you can resolve them. When the<br />
synchronization problems are<br />
resolved, your database will show<br />
improved efficiency and added<br />
performance.<br />
What can fcompare do?<br />
Fcompare can perform two<br />
basic functions: it can compare a<br />
<strong>Synergy</strong> DBMS (formerly ISAMxf)<br />
file definition against repository<br />
definitions, or it can compare a<br />
<strong>Synergy</strong> DBMS file definition<br />
against a system catalog. Fcompare<br />
uses the physical data file as the<br />
standard by which to measure<br />
whether or not the repository or<br />
system catalog is correctly defined.<br />
It examines the record and key<br />
information from the data file and<br />
compares it to the corresponding<br />
repository or system catalog<br />
definitions.<br />
Sending the message<br />
When discrepancies are found,<br />
fcompare outputs an error or a<br />
warning, as well as some informational<br />
messages. The output can be<br />
written to the screen or to a file. An<br />
error indicates a problem that must<br />
be resolved to get accurate data<br />
retrieval. One example of an error<br />
is a key whose defined offset in the<br />
data file does not match the offset<br />
as defined in the repository. A<br />
warning suggests a problem that<br />
should be resolved, as it is most<br />
likely reducing performance or<br />
making further debugging more<br />
difficult. An example of a warning<br />
is a key that is longer than it is<br />
defined to be. An informational<br />
message is just useful information<br />
about the database, such as record<br />
size or number of keys defined.<br />
The volume of messages<br />
generated by fcompare can be<br />
large, but you can use command<br />
line options to control the number<br />
of messages output. You can elect<br />
to see only errors, both errors and<br />
warnings, or all messages. For a<br />
large database, it is best to use<br />
fcompare in an iterative manner:<br />
identify and clean up the errors<br />
first, then move on to the lesser<br />
issues, the warnings.<br />
Fcompare is easy to use<br />
You can run it from the command<br />
line or launch it from either<br />
the DBA utility or the Repository<br />
program. When launched from the<br />
DBA, fcompare performs a system<br />
catalog comparison, and when<br />
launched from Repository, it<br />
performs a repository comparison.<br />
From the command line, you can<br />
request either type of comparison.<br />
You supply either a path to the<br />
repository files for a repository<br />
comparison or the name of a connect<br />
file for a system catalog comparison.<br />
For the most part, the checks<br />
performed for the two options are the<br />
same, except that the repository option<br />
does a little more. It performs a number<br />
of checks on key definitions that are not<br />
performed for the system catalog<br />
option. Some examples include<br />
checking key segments for offset and<br />
length, checking that the data types of<br />
key segments match, and checking that<br />
the key segments have a matching sort<br />
order. For this reason, we recommend<br />
that you run the repository option<br />
before creating the system catalogs so<br />
that you can check and correct key<br />
definitions in the repository before<br />
generating system catalogs. For those<br />
who use a conversion setup file to<br />
specify filenames during generation of<br />
system catalogs (via the<br />
SODBC_CNVFIL environment<br />
variable), fcompare can still be used.<br />
When a repository comparison is<br />
performed, fcompare reads the conversion<br />
setup file to retrieve the filenames.<br />
You can choose to compare all table/<br />
file definitions in the database, or you<br />
can limit the comparison to a specific<br />
table or file. When a single table or file<br />
is selected, a data validation check can<br />
also be requested. During data validation,<br />
fcompare reads through all the<br />
records in the data file and verifies that<br />
date and decimal fields contain valid<br />
values for their field types (for example,<br />
that date fields contain valid<br />
dates and decimal fields contain only<br />
digits). The number of records in the<br />
file is reported, and any invalid dates or<br />
invalid decimal data are identified by<br />
outputting the record ID, column name,<br />
and value of the offending data. The<br />
data validation option can significantly<br />
increase the amount of time it takes to<br />
run fcompare, which is why its usage is<br />
limited to one file or table at a time.<br />
Continued on page 27<br />
7
questions answered<br />
SUPPORT CENTER<br />
Support Center Questions and Answers by Topic<br />
• <strong>Synergy</strong>/<strong>DE</strong> Resource Center<br />
• <strong>Synergy</strong>/<strong>DE</strong> 8.1 upgrade<br />
• Microsoft Windows<br />
• <strong>Synergy</strong>/<strong>DE</strong> UI Toolkit<br />
• Error Messages<br />
• General Tips from the Support Team<br />
• Client / Server<br />
• License Manager<br />
• <strong>Synergy</strong>/<strong>DE</strong> xfNetLink Java<br />
?<br />
My ActiveX control<br />
no longer fits on<br />
the screen...<br />
Q<br />
A<br />
Q<br />
A<br />
Q<br />
A<br />
<strong>Synergy</strong>/<strong>DE</strong> Resource Center<br />
How do I access the Resource Center?<br />
The login fields for the Resource Center are located in the top right corner of the<br />
<strong>Synergex</strong> Web site. To access the Resource Center you must have a current subscription<br />
to <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support. You will also need a valid user name<br />
(generally your company e-mail address) and password, which are set up for you by<br />
one of the two administrators at your company. Contact <strong>Synergy</strong>/<strong>DE</strong> HelpDesk<br />
Support if you require the names of your company administrators. To obtain your<br />
password, enter your user name in the login field, and then click on the “Forgot<br />
Password?” link. Your password will be sent to you via e-mail.<br />
I don’t have <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support but I would like to visit the Resource Center. How<br />
can I do this?<br />
You may view the Resource Center as a guest by clicking on “Guest User” in the<br />
upper right corner of the <strong>Synergy</strong>/<strong>DE</strong> Solutions page of the <strong>Synergex</strong> Web site. As a<br />
guest user, you will be able to tour some of the areas of the Resource Center, and<br />
find out all of the resources that are available with a HelpDesk subscription.<br />
I recently tried to login to the Resource Center and I don’t seem to have full access. What’s the<br />
problem?<br />
It could be a few things…<br />
1. You may be logged in as an administrator. Some options are not available to<br />
administrative logins, which are intended for user administration purposes only. For<br />
full access, login to the Resource Center as a “non-administrator.”<br />
2. You may not have a subscription to <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support. If this is<br />
the <strong>case</strong>, you will not have access to the Resource Center, unless you log in as a<br />
guest.<br />
3. Your <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support may have expired. To renew your<br />
subscription, contact a Customer Service representative today.<br />
mailto:<strong>Synergy</strong>@synergex.com<br />
Continued on pages 9- 13<br />
8
Q<br />
A<br />
I’m a <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support <strong>customer</strong>; however, after logging in to the <strong>Synergy</strong>/<strong>DE</strong> Resource Center, I noticed<br />
that some of the Online Services links were disabled. How can I access this portion of the Resource Center?<br />
To generate configuration keys or to order products online, you need to sign up for Online Services.<br />
Contact your <strong>Synergy</strong>/<strong>DE</strong> Account Manager for more details.<br />
If you have any questions about accessing the Resource Center, contact <strong>Synergy</strong>/<strong>DE</strong> HelpDesk Support.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1<br />
Q<br />
A<br />
Q<br />
A<br />
I just upgraded my PC to use <strong>Synergy</strong>/<strong>DE</strong> 8.1 and my font size has changed. I also noticed that my ActiveX control no<br />
longer fits on the screen. What is causing this and how can I fix it?<br />
Font and screen sizes are settings that can be specified in the synergy.ini file. In <strong>Synergy</strong>/<strong>DE</strong> 8.1, the<br />
default location for synergy.ini is DBLDIR, rather than the Windows system directory (Windows or<br />
Winnt) as it was in previous versions. You are now probably using the default synergy.ini and therefore not<br />
seeing the customizations that you had made previously.<br />
We recommend that you move your customized synergy.ini file from the old default location to another<br />
directory and set SFWINIPATH to point to it. For deployment at <strong>customer</strong>s’ sites, we recommend that you<br />
put synergy.ini in a directory that is part of your application. (In newer versions of Microsoft Windows<br />
[such as XP], the Windows system directory is protected, which means that some users are not able to see<br />
it. This makes it an undesirable location for an ini file.) We do not recommend using the synergy.ini file in<br />
DBLDIR, as this is just a sample file and may be overwritten the next time you upgrade <strong>Synergy</strong>/<strong>DE</strong>.<br />
I just upgraded to Connectivity Series 8.1. Why do I get the error “Invalid connect syntax (uid/pwd/datasource)” when I<br />
try to connect to my SQL OpenNet server? (Note: This issue affects <strong>customer</strong>s using <strong>Synergy</strong>/<strong>DE</strong> 8.1.)<br />
This error is generated by the encryption used by SQL OpenNet. In Connectivity Series version 8.1,<br />
user and password information passed in connect strings through SQL OpenNet is encrypted. When you<br />
update both your clients and server to version 8.1, encryption is implemented by default.<br />
However, if either the client or the server is not updated, you may see an “invalid connect syntax (uid/<br />
pwd/datasource)” error. To correct this problem, make sure all clients and servers are running Connectivity<br />
Series version 8.1.<br />
This error can also be caused by a mismatch in encryption settings on the client and server or by a<br />
corrupted net.ini file. For more information, including how to turn encryption off, refer to the Connectivity<br />
Series release notes (REL_CONN.TXT) and the SQL Connection Reference Manual. If you are running<br />
<strong>Synergy</strong>/<strong>DE</strong> Client, see information on VORTEX_HOME in the Installation section of the Language<br />
release notes (REL_DBL.TXT).<br />
(For HelpDesk Supported <strong>customer</strong> only.)<br />
Q<br />
A<br />
Microsoft Windows<br />
How do I conditionally compile code for Microsoft Windows?<br />
If you are building your application to run on both Windows and another platform (Unix or<br />
OpenVMS), you may want to conditionally compile your code so that some sections of code are included<br />
while others are excluded when you build your application for Windows.<br />
The DBLDIR:dbl.def file (installed with <strong>Synergy</strong>/<strong>DE</strong>) includes identifiers that enable you to do this.<br />
We recommend that you use D_GUI. (There are also ten OS_WINDOWSxxx identifiers, plus the<br />
OS_MSDOS identifier that you could use. However, we no longer recommend these because some of<br />
them will become obsolete with the introduction of 64-bit Windows—for example, OS_MSDOS and<br />
OS_WINDOWSNT).<br />
9
Q<br />
A<br />
Q<br />
A<br />
How can I invoke the Windows color palette to enable the user to select a new color from within my <strong>Synergy</strong> application?<br />
Use the following statement:<br />
newcolor = %u_wincolor(D_CHOOSECOLOR, oldcolor)<br />
Where old color is the RGB value of the current color. This invokes the Windows color palette. After the<br />
user selects a new color, newcolor is assigned the RGB value of the color selected. If the user selects Cancel,<br />
newcolor is returned as oldcolor.<br />
Our Windows NT client has two IP addresses. The wrong address is being used when returning from <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus.<br />
What can we do?<br />
The xfNetLink client passes its IP address to xfServerPlus at connection time. This is not a value that you<br />
explicitly set in xfServerPlus or xfNetLink. Rather, xfNetLink uses the address of the primary network card as<br />
defined on your system. If you have multiple network cards, verify that the IP address you want xfServerPlus<br />
to use is the address of the primary card.<br />
<strong>Synergy</strong>/<strong>DE</strong> UI Toolkit<br />
Q<br />
A<br />
Q<br />
A<br />
Q<br />
A<br />
Q<br />
A<br />
How can I change the title bar and therefore the name of the button on the Windows task bar of the <strong>Synergy</strong> container<br />
window?<br />
Use xcall E_SECT(“string”,D_CAPTION). The D_CAPTION option sets the Microsoft Windows Application<br />
Window Caption.<br />
We would like our application to emulate the Windows prompt change for hyperlinks in a cell-based environment. Can we<br />
change the prompt’s renditions without changing the color?<br />
You can use the WF_ATTR function (and WF_COLOR function) of the W_FLDS subroutine to modify the<br />
field’s renditions, but you’ll need the low-level field number for the prompt. Use I_FLDINF to get the field<br />
information, including the prompt’s field number, which will be in gs_promptfld in the fldinf.def file.<br />
I have a program with an input screen that has 16 tabs. Is there a way to present these in 2 rows of 8, rather than 1 row of<br />
16?<br />
Yes. If you are using <strong>Synergy</strong>/<strong>DE</strong> version 7 or later, use the DTS_MULTILINE option that is passed to the<br />
style argument of TS_TABSET(DTs_CREATE). With DTs_MULTILINE, the tabs will display on multiple<br />
rows if they cannot fit on one row.<br />
For more information refer to the Tab Set Processing section of the <strong>Synergy</strong>/<strong>DE</strong> UI Toolkit Reference<br />
Manual.<br />
How do I capture the close event on the application window?<br />
Register an application close method routine either after calling U_START, or as part of your start_method<br />
subroutine specified with U_START. For example:<br />
xcall e_method(D_METH_APPCLOSE, “myappclose” )<br />
In the close method, test to see if the “cancel” argument is passed. If it is, set the argument to TRUE, signal<br />
a menu event that will cause the application to exit, and then return. If the “cancel” argument is not passed, do<br />
not do any of the above. In that <strong>case</strong>, the method is being called as part of an unconditional shutdown.<br />
For more information, refer to the “application close method” index entry in the UI Toolkit Reference<br />
Manual.<br />
10
Q<br />
A<br />
Q<br />
A<br />
Error Messsages<br />
In the xfNetLink COM log file, the following error occurs:<br />
typelib:Iinterface:Did not receive expected interface for<br />
parameter x<br />
Why is this happening?<br />
This error occurs because the interface is attempting to use a parameter that has not been initialized<br />
correctly.<br />
Usually, this occurs when an array of structures is being passed, and the first element of the array<br />
(element 0) has not been initialized. For example, Dim struct(3) actually creates a four element array,<br />
referenced as elements 0, 1, 2 and 3.<br />
Another possible cause is that there is more than one interface being used, and not all of the interfaces<br />
are being initialized.<br />
Why am I getting the error “Cannot set default value for VT_DISPATCH type” when I run my ASP page? The error occurs<br />
on the method call.<br />
This error occurs when the object being called has not been set. Make sure the object has been instantiated<br />
correctly. If using an array of structures, remember that an instance of the object must be created for<br />
each element of the array. So if you have an array variable that is dimensioned for two elements, your FOR<br />
loop must be dimensioned from 0 to 2.<br />
General Tips from the Support Team<br />
Q<br />
A<br />
Q<br />
A<br />
Q<br />
A<br />
When I compile the source file opened in Workbench, the compiler results appear in the upper window instead of the<br />
lower window. Why is this and how can I change it?<br />
You may have the “Capture output” box checked. To uncheck this box, follow these steps:<br />
1). Go to the Tools menu and select Configuration > File Extension Setup.<br />
2). Click on the Project button.<br />
3). Select the Tools tab and make sure the “Capture output” box is unchecked.<br />
Is there a way to connect to a database using <strong>Synergy</strong>/<strong>DE</strong> xfODBC without creating a Data Source Name (DSN)?<br />
(Note: This article is applicable to <strong>Synergy</strong>/<strong>DE</strong> versions 7.2.7a and later. )<br />
Yes. xfODBC is capable of connecting with or without a DSN. How xfODBC connects depends upon<br />
the connection string. If you are using an ActiveX Data Objects (ADO) application, use the following<br />
connection string format to connect without creating a DSN:<br />
DRIVER=xfODBC;UID=DBADMIN;PWD=MANAGER;DBQ=sodbc_sa;<br />
The key is the DRIVER=xfODBC portion of the string. When connecting this way, all the necessary<br />
connection information must be provided. This includes the user id (UID), password (PWD), and connect<br />
file (DBQ).<br />
What is the best way to remove compression from an ISAM file?<br />
1). Create a par (parameter) file by running the ipar utility with the -g option.<br />
2). Remove the compression attribute “,compress” from the par file. NOTE: the comma character must<br />
be removed as well.<br />
3). Use the fconvert utility with the par file to create a new file without compression. Specify the<br />
compressed file as input and use a new filename as output.<br />
4). Rename the new file, both index (.ism) and data (.is1), to the original name.<br />
Refer to the <strong>Synergy</strong> Language Reference Manual for more information on using the ipar utility.<br />
11
Q<br />
A<br />
Q<br />
A<br />
Q<br />
A<br />
I would like to center each input window in my application window. I know the size of my application window, but<br />
how can I retrieve the size (rows and columns) of the input window?<br />
Use %W_INFO(WIF_ROWS,WIF_COLS) to retrieve the row and column values.<br />
How do we display a .JPEG file as the background in our main <strong>Synergy</strong>/<strong>DE</strong> Windows application?<br />
Create an ActiveX control using Visual Basic with an embedded image control, or use a DLL<br />
routine written in C. Although this approach gives greater performance and control over how the<br />
image is displayed, support for each image format must be programmed independently.<br />
How do I determine the ID of the initial window created by U_START? I would like to set the position of the window<br />
during the USTART_METHOD. To do this, I need the ID of the window to move or position it.<br />
Although that window does not really have an ID, some functions can access it via<br />
WID_CONTAINER. In your <strong>case</strong>:<br />
xcall w_proc(WP_POSITION, WID_CONTAINER, x_POs, y_POs)<br />
Note: The position of this window can also be specified by setting the APP_X and APP_Y environment<br />
variables.<br />
Client / Server<br />
Q<br />
A<br />
Can I use an older <strong>Synergy</strong>/<strong>DE</strong> server product with a newer <strong>Synergy</strong>/<strong>DE</strong> client product? For example, can I access<br />
<strong>Synergy</strong>/<strong>DE</strong> xfServer 7.1 with my <strong>Synergy</strong>/<strong>DE</strong> 7.5-built application?<br />
For all <strong>Synergy</strong>/<strong>DE</strong> client/server products, the major revision of the server must be equal to or<br />
higher than the major revision of the client. (The major revision is the second number in a <strong>Synergy</strong>/<br />
<strong>DE</strong> version, so “1” and “5” in the above question.) For instance, a <strong>Synergy</strong>/<strong>DE</strong> 7.5.3 client can run<br />
with a 7.5.1 server, but a 7.5.3 client cannot run with a 7.1 server. This rule applies to all <strong>Synergy</strong>/<strong>DE</strong><br />
client/server products, which include:<br />
• <strong>Synergy</strong> application clients with xfServer<br />
• xfODBC or SQL Connection clients with the SQL OpenNet server<br />
• xfNetLink clients with xfServerPlus<br />
• <strong>Synergy</strong> application clients with the License Manager server<br />
Q<br />
A<br />
10<br />
Is there a way to create a new xfServerPlus logfile (xfpl.log) without shutting down the server?<br />
Yes.<br />
On Windows and Unix, as long as you are not currently connected to xfServerPlus, you can simply<br />
delete the existing xfpl.log file. Or, if you want to save the existing file for reference, you can edit the<br />
XFPL_LOGFILE variable in the xfpl.ini file to point to a new file. Either way, a new file will be<br />
created when the next connection to xfServerPlus occurs.<br />
On VMS, you can edit the XFPL_LOGFILE variable in xfpl.ini as described above, but because<br />
VMS uses a pool of connections, the change will not take effect until a new process is created. This<br />
means that you will probably have to connect twice to ensure that the new log file is being used. (Note<br />
that you do not have to “use up” all the existing connections in the pool before the new log file setting<br />
takes effect. When a new process is started, the xfpl.ini file is read, and the log file setting is communicated<br />
to rsynd. From that point on, all processes in the pool will use the new log file. This does not,<br />
however, apply to other settings in the xfpl.ini file. If you change anything else, such as the logging<br />
level, those changes will apply only to newly created processes.)<br />
10<br />
12
Q<br />
A<br />
License Manager<br />
If you install the License Manager on a Windows or Unix computer, and you misspell the licensee name, can you reset<br />
the name without having to reinitialize the License Manager with a “-k” string?<br />
Yes. To reset the licensee name (before you install configuration keys for <strong>Synergy</strong>/<strong>DE</strong> products):<br />
For a license server (Windows NT/2000/XP), type:<br />
lmu -r -ns <br />
For a standalone license (Windows 98/Me or Unix), type:<br />
lmu -r<br />
Note: If you have already installed product configuration keys, you will need a “-k” string to<br />
reinitialize the License Manager.<br />
<strong>Synergy</strong>/<strong>DE</strong> xfNetLink Java<br />
Q<br />
A<br />
From Java, I want to call a <strong>Synergy</strong> routine that has different behavior depending on whether an argument is passed.<br />
However, when I generate the xfNetLink Java class wrappers, I get a message that states that the argument has been<br />
converted to a required parameter.<br />
The Java language does not support optional parameters in the same manner that <strong>Synergy</strong> Language<br />
does. Consequently, if you mark a parameter as “not required” in the Method Definition Utility, it will be<br />
converted to a required parameter when you generate Java class wrappers. You can work around this<br />
limitation by editing the generated code (the .java source files) to overload the method. That is, you can<br />
create multiple instances of the method using the same name but a different method signature. Use the<br />
synNull class in the xfNetLink Java <strong>API</strong> to create a “placeholder” object, which you will then pass as the<br />
optional parameter.<br />
For example,<br />
synNull null01 = new synNull();<br />
obj.xcall(“methodid01”, arg1, arg2, null01, arg4);<br />
Note that if you edit the Java source files, your changes will be lost if you regenerate class wrappers.<br />
For more information about using the synNull class and additional examples, refer to the documentation<br />
for synNull in the “xfNetLink Java Class Reference” chapter of the Developing Distributed <strong>Synergy</strong><br />
Applications Manual.<br />
A recipe for adding <strong>Synergy</strong> resources to your development staff:<br />
Ingredients:<br />
• General application programmers<br />
• 1 <strong>Synergy</strong> Language Essentials class<br />
• 1 week<br />
Preparation:<br />
After hiring competent application programmers, call your <strong>Synergy</strong>/<strong>DE</strong> Account Manager to schedule a<br />
week at the location of your choosing (at <strong>Synergex</strong> headquarters or at your facility) to attend the <strong>Synergy</strong><br />
Language Essentials class. After completing this week-long class, your new <strong>Synergy</strong>-savvy developer will<br />
be “ready” (to productively develop and/or maintain your <strong>Synergy</strong> applications). And he or she can<br />
continue learning by attending one or more of the following <strong>Synergex</strong> classes:<br />
• <strong>Synergy</strong>/<strong>DE</strong> UI Toolkit Essentials<br />
• Advanced <strong>Synergy</strong>/<strong>DE</strong> class<br />
• Custom Classes<br />
Yield:<br />
Several valuable <strong>Synergy</strong> resources!<br />
“Since coming back from the <strong>Synergy</strong> Language<br />
Essentials class, I was able to eliminate the<br />
‘random features’ I seemed to add to my code.<br />
Instead, I’m finding some coding shortcuts and<br />
many things I’d like to improve in our existing<br />
code.”<br />
-- Joseph Leech, Norman G. Jensen, Inc.<br />
13
<strong>Synergy</strong>/<strong>DE</strong> <strong>customer</strong>, Vasco BVBA, launches<br />
e-commerce site<br />
Web site eases <strong>customer</strong> transactions, reduces ordering errors, and more.<br />
Vasco ® BVBA of Dilsen, Belgium, a leading manufacturer of designer<br />
radiators, announced that they have launched a fully-functional e-commerce<br />
Web site that reduces ordering mistakes, eases the workload of their service and<br />
sales teams, and saves the company money in international telephone costs.<br />
Vasco constructed their Web site using <strong>Synergex</strong> <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus,<br />
xfNetLink COM, Microsoft Commerce Server 2000, and a Perl CGI interface to<br />
their <strong>Synergy</strong> routines. The Web site automates the entire order entry process:<br />
completes and tracks orders online; retrieves stock level, articles, and delivery<br />
times information; retrieves reports and statistics via e-mail; and fulfills<br />
documentation requests.<br />
The site also features an online catalog that offers a wide range of radiators<br />
for each individual taste and interior design. Customers can click through the<br />
catalog for advice about radiators, as well as find suggestions for making their<br />
living environments more comfortable. The online catalog also has extensive<br />
searching capabilities. Customers can search for new products, search by<br />
feature (shape, color, power, size, appearance, etc.), or narrow their search to<br />
radiators that are currently in stock.<br />
“Getting to the Web was a rather simple process,” said Frank Hoedemakers,<br />
software developer for Vasco. “We decided to stay with <strong>Synergy</strong>/<strong>DE</strong> because of<br />
the straightforward interface to our existing <strong>Synergy</strong> software.” Hoedemakers<br />
continues, “By using xfServerPlus, we could concentrate on the essence of the<br />
matter; namely, the development of our Web application, Vasco On-Line<br />
Services.”<br />
To migrate to the Web, Vasco wrote some new <strong>Synergy</strong> routines and<br />
extracted the user interface elements out of their existing routines. They created<br />
a Web interface using Microsoft FrontPage ® for the static content and Microsoft<br />
Visual InterDev ® for the ASP portion of the site. Vasco then connected the<br />
interface to their <strong>Synergy</strong> business logic with xfServerPlus and xfNetLink COM<br />
products.<br />
Previously, Vasco’s orders came in by fax, telephone, and e-mail, requiring<br />
their internal service sales department to manually re-enter the orders in the<br />
<strong>Synergy</strong>/<strong>DE</strong>-built order program. Clients would then be contacted for any<br />
additional information needed about the configuration of their order. Now,<br />
<strong>customer</strong>s can complete their orders online, 24 hours a day, seven days a week.<br />
The online application forces the client to enter a correct product configuration,<br />
which eliminates ordering mistakes and the need for the service sales team to<br />
contact the client. Once an order is entered on the Web site, the online application<br />
automatically sends the client a message, via <strong>XML</strong>, confirming the order.<br />
The application then automatically enters the order in the system, avoiding<br />
double entries.<br />
“Customer demand was part of the reason we moved to the Web,” says<br />
Hoedemakers. “However, we also wanted to be a progressive company and<br />
gain an advantage over our competitors, which we can do now through our<br />
12 Web services.”<br />
One of Vasco’s competitors—Thermic BVBA—is also located in Dilsen.<br />
Not only do both companies use the same production plant for manufacturing<br />
designer radiators, but their <strong>Synergy</strong>/<strong>DE</strong>-built Web sites also use the same<br />
applications. Visit Thermic’s Web site, http://www.thermic.be, for more<br />
information.<br />
http://www.vasco.be<br />
Vasco bathroom radiator<br />
When Will You Get Your<br />
<strong>Synergy</strong> Applications to the<br />
Web in a Real-Time Interactive<br />
Environment?<br />
Let <strong>Synergex</strong> give you a<br />
jumpstart. Within 5 days, with<br />
<strong>Synergex</strong>’s Passport to the Web,<br />
you will be well on your way to<br />
a Web-enabled application.<br />
What is <strong>Synergex</strong>’s<br />
Passport to the Web?<br />
<strong>Synergex</strong>’s Passport to the<br />
Web is designed specifically to<br />
help you get your <strong>Synergy</strong><br />
applications to the Web. Our<br />
program offers a unique<br />
integration of products and<br />
services that can help you<br />
transform your legacy applications<br />
to e-business applications<br />
with ease. The Passport to the<br />
Web includes the <strong>Synergy</strong>/<strong>DE</strong><br />
products you’ll need, as well as<br />
on-site customized training from<br />
an experienced <strong>Synergex</strong><br />
consultant to help you efficiently<br />
establish your Web<br />
project and lay the groundwork<br />
for you to successfully complete<br />
the job.<br />
Discover how it works<br />
today!<br />
Already have a Web solution<br />
in place? Thinking about<br />
implementing a Web solution?<br />
Tell us about it:<br />
mailto:<strong>Synergy</strong>@<strong>Synergex</strong>.com.<br />
14
Web-Based systems from Radley Corporation streamline<br />
ordering and shipping tasks for automotive and<br />
heavy equipment suppliers<br />
Located in Southfield, Mich.,<br />
Radley Corporation (Radley), is a<br />
software development firm focused<br />
exclusively on EDI (Electronic<br />
Data Interchange) and barcode data<br />
collection solutions for the automotive<br />
and retail manufacturing<br />
industries. In 2002, they released<br />
two Web products that reduce<br />
overhead and manpower requirements<br />
for automotive, appliance,<br />
off-road and heavy equipment<br />
suppliers. Both SCM (Supply<br />
Chain Messenger) for handling<br />
Supply Chain orders online, and<br />
iCARaS, Radley’s enhanced<br />
flagship, <strong>customer</strong>-facing product<br />
use the ERP (Enterprise Resource<br />
Planning) partner’s existing <strong>API</strong>s to<br />
get data in and out of their systems,<br />
minimizing the cost of installing<br />
and implementing their systems.<br />
SCM<br />
The SCM product enables<br />
Radley’s <strong>customer</strong>s to bring their<br />
suppliers online, so that forecasts,<br />
schedules and shipments can be<br />
processed real-time through Web<br />
forms. In addition, the Internetenabled<br />
software lets Radley’s<br />
suppliers communicate with their<br />
suppliers further down the chain,<br />
while preserving the <strong>customer</strong>supplier<br />
relationship. SCM is based<br />
on <strong>Synergy</strong>/<strong>DE</strong>.<br />
With Radley’s SCM product, all<br />
the smallest supplier needs to<br />
retrieve orders and enter shipments<br />
back into SCM is Microsoft ®<br />
Internet Explorer and a printer.<br />
“The benefit to the <strong>customer</strong> is that<br />
they can work on exceptions and let<br />
the data flow between <strong>customer</strong> and<br />
supplier with minimal human<br />
intervention,” explains Will Soutar,<br />
EDI product manager at Radley.<br />
The SCM product also supports flat<br />
file, <strong>XML</strong> (Extensible Markup<br />
Language) or EDI standards for<br />
gateway integration to ERP<br />
applications.<br />
“Another significant benefit of<br />
the SCM product is that it provides<br />
our <strong>customer</strong>s with several options<br />
on how to collaborate with their<br />
supply chains,” says Mark Farneth,<br />
president of Radley. “Larger<br />
suppliers can leverage their<br />
existing EDI gateways by exchanging<br />
EDI documents with<br />
SCM. Small suppliers, who may<br />
not have extensive EDI translators<br />
or EDI expertise on staff, can use<br />
Web forms to view shipping<br />
schedules and provide <strong>customer</strong>s<br />
with notification of shipments.”<br />
“Our point solution sets us<br />
apart from the competition,” states<br />
Soutar. “Our SCM software<br />
leverages the content already<br />
available within our <strong>customer</strong>’s<br />
legacy order management and<br />
purchasing systems without the<br />
associated costs of a major<br />
customization project.” According<br />
to Soutar, Radley’s point solution<br />
keeps it as simple as possible by<br />
conforming to the way their<br />
<strong>customer</strong>s’ applications currently<br />
present data. By using Radley’s<br />
pre-built plug-ins to the specific<br />
ERP partner’s <strong>API</strong>, this data can<br />
now be available as a<br />
downloadable <strong>XML</strong> document,<br />
EDI, or as a printable form. The<br />
<strong>customer</strong> is then notified immediately<br />
when this occurs; or if the<br />
supplier has not logged in for a<br />
specified time period, the buyer<br />
and supplier get e-mail messages<br />
alerting them of the need to take<br />
action.<br />
“To take it one step further, the<br />
<strong>customer</strong> can update our SCM<br />
product with periodic inventory<br />
quantities so that the supplier can<br />
manage their inventory on a<br />
‘virtual’ basis,” Soutar explains.<br />
“As an additional benefit, SCM<br />
has the ability to sort the Web<br />
At SPC 2004 in Cleveland...<br />
Radley Corporation will demonstrate<br />
how they are using <strong>Synergy</strong>/<strong>DE</strong><br />
xfServerPlus, <strong>XML</strong>/XSL, and Web<br />
services to provide automotive suppliers<br />
with a complete solution for their<br />
OEM and supply chain requirements.<br />
Radley’s <strong>Synergy</strong>/<strong>DE</strong>-based Web<br />
product handles EDI, release accounting,<br />
process scheduling, printing and<br />
scanning of bar-code labels, generation<br />
of reports in PDF format, and ERP<br />
(Enterprise Resource Planning)<br />
integration.<br />
Register today on the SPC 2004<br />
Web site.<br />
http://spc.synergex.com<br />
suppliers from the EDI suppliers and<br />
provides complete EDI processing and<br />
auditing. Most of our competitors have<br />
six or more zeros in their price schedule—not<br />
including implementation—<br />
whereas we can come in without the<br />
high price tag and minimal<br />
customizations.”<br />
iCARaS<br />
Radley’s <strong>customer</strong>-facing application—iCARaS—now<br />
has an enhanced<br />
user interface and reduced processing<br />
time. These updates enable automotive<br />
and heavy equipment suppliers to<br />
process orders and shipments with their<br />
<strong>customer</strong>s in real-time, and simplifies<br />
job automation with a new scheduler.<br />
iCARaS is also based on <strong>Synergy</strong>/<strong>DE</strong>.<br />
“With iCARaS, major OEMs tell<br />
Radley’s <strong>customer</strong>s, via EDI and the<br />
Internet, what they want, where they<br />
want it, how to containerize it, and how<br />
to label it,” comments Soutar. “Different<br />
plants within the same <strong>customer</strong> ask<br />
the supplier to do things in a different<br />
manner. iCARaS boils down all of the<br />
differences and presents it to the<br />
supplier in a standardized ‘vanilla’<br />
format, which eliminates costly custom<br />
coding on a <strong>customer</strong>-by-<strong>customer</strong><br />
Continued on page 17<br />
15
16<br />
LADSnet’s iCAD dispatch tool increases productivity<br />
and revenue<br />
LADS Network Solutions, Inc. (LADSnet) of St. Louis, Mo., a provider of information management solutions for<br />
the delivery service industry announced the release of iCAD (intelligent Computer Aided Dispatch) for their<br />
<strong>Synergy</strong>/<strong>DE</strong>-built LADS (Local Area Delivery System) software solution.<br />
iCAD is a Windows-based dispatching system that uses <strong>Synergy</strong>/<strong>DE</strong>’s xfODBC technology. It is designed to keep<br />
dispatchers up-to-date and informed 24 hours a day. For each job, iCAD performs such calculations as the best route<br />
to minimize mileage and stay on schedule, and the most qualified driver for each job—all displayed via six windows<br />
of information on iCAD’s screen.<br />
Sunny Express in California, a Bay area leader in the same day priority delivery industry, has been running iCAD<br />
for one year as a beta tester. “iCAD goes well beyond all other standard dispatch systems,” says John Slaughter,<br />
President of Sunny Express. “The iCAD software recalculates the ETA for each uncompleted stop every 20 seconds<br />
while producing the best possible list of suggested drivers for new jobs.” Slaughter continues, “iCAD has changed<br />
our business dramatically, increasing productivity and saving hard dollars while allowing us to be more resourceful<br />
in how we run our business. Other delivery companies can’t compete with us on service or cost because they simply<br />
don’t have our level of technology.”<br />
“With iCAD, dispatchers handle at least 30 percent more drivers with greater accuracy, jobs are completed with<br />
higher on-time percentages, and drivers handle at least 10 percent more jobs per day with sometimes no additional<br />
miles,” says Dan Huber, President of LADSnet. “Our <strong>customer</strong>s are now able to offer the highest levels of service to<br />
their <strong>customer</strong>s by providing prompt and accurate estimated times of arrival for their packages.”<br />
For more information on iCAD please call LADSnet at 800-542-2115 or visit the company’s Web site at<br />
http://www.ladsnet.com.<br />
CareCentric listed as one of the top 100 Healthcare<br />
IT companies in the nation<br />
Atlanta, Georgia-based CareCentric, Inc. (OTC Bulletin Board: CURA), a leading provider of management<br />
information systems to the home healthcare community, recently announced their inclusion in Healthcare<br />
Informatics’ annual list of top United States healthcare IT providers. Ranked by healthcare IT revenue, the financial<br />
information provided by these top 100 companies is considered a barometer for the direction of the industry and<br />
healthcare IT future.<br />
“Selection into the Healthcare Informatics 100 is a great honor,” stated John R. Festa, President and CEO of<br />
CareCentric. “It reaffirms that our employee efforts are being rewarded, as witnessed by new revenue growth, new<br />
product initiatives, and enhanced <strong>customer</strong> service.” Festa added, “CareCentric has been in the home care business<br />
for over 30 years. Our <strong>customer</strong>s and partners know they can count on us to provide the performance, service, and<br />
the kind of relationship they want from a long-term partner. This award is a wonderful recognition of the very best<br />
software organizations in the industry today.”<br />
CareCentric was also recently recognized by the Atlanta Journal-Constitution as one of Georgia’s top 100<br />
publicly traded companies, based on overall business performance including stock market assessment and executive<br />
management of resources.<br />
CareCentric’s <strong>Synergy</strong>/<strong>DE</strong>-based billing, management, and clinical software solutions have helped thousands of<br />
home care providers more fully automate their business processes. One of CareCentric’s newest products,<br />
PharmMed, is a GUI-based application that uses Crystal Reports and <strong>Synergy</strong>/<strong>DE</strong> xfODBC to generate prescription<br />
forms.<br />
About CareCentric, Inc.<br />
CareCentric provides freestanding, hospital-based, and multi-office home healthcare, home medical equipment<br />
and home care pharmacy providers with complete information solutions, enabling them to generate and utilize<br />
comprehensive and integrated financial, operational, and clinical information.<br />
http://www.carecentric.com
After a smooth upgrade to <strong>Synergy</strong>/<strong>DE</strong> 8.1, Jack Henry<br />
& Associates, Inc., takes advantage of features<br />
Jack Henry & Associates, Inc., (Nasdaq: JKHY) is a leading provider of integrated technology solutions for financial<br />
institutions throughout the United States. To take advantage of enhancements including the <strong>XML</strong> <strong>API</strong> and improvements<br />
to Professional Series Workbench, Jack Henry decided to migrate their Core Director product to <strong>Synergy</strong>/<strong>DE</strong> 8.1.<br />
The <strong>XML</strong> <strong>API</strong> and support for HTTPS in <strong>Synergy</strong>/<strong>DE</strong> 8.1 enables <strong>customer</strong>s like Jack Henry to communicate with more<br />
third-party applications, and to implement enhanced communication between their own application components.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1 also provides enhancements to xfODBC, <strong>Synergy</strong> Language, UI Toolkit, and many other <strong>Synergy</strong>/<strong>DE</strong><br />
tools.<br />
“Overall, upgrading our application to <strong>Synergy</strong>/<strong>DE</strong> 8.1 was a smooth process—we had no issues at all,” commented<br />
Tom Head, Programmer and Analyst Team Leader at Jack Henry, “We were very impressed with 8.1’s quality; it looks<br />
great and runs very smoothly.”<br />
Following the smooth upgrade to 8.1, Jack Henry plans to add<br />
a browser interface to their existing application using ASP.NET<br />
and <strong>Synergy</strong>/<strong>DE</strong>’s xfNetLink .NET and xfServerPlus products.<br />
The company will use version 8.1’s <strong>XML</strong> <strong>API</strong> to communicate<br />
between the <strong>Synergy</strong> side of their application and the browser<br />
side. “We think that this will allow us more flexibility as our<br />
structures change, and will position us to more easily utilize<br />
emerging technologies,” said Erik Read, lead developer at Jack<br />
Henry.<br />
Head and his team are particularly pleased with the improvements<br />
to version 8.1’s Professional Series Workbench: “I noticed<br />
“Overall, upgrading our application to<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1 was a smooth process—we had<br />
no issues at all. We were very impressed with<br />
8.1’s quality; it looks great and runs very<br />
smoothly.”<br />
--Tom Head, Programmer and Analyst Team<br />
Leader at Jack Henry<br />
a vast improvement in how well it functions and the ease with which you can upgrade Workbench now.”<br />
Jack Henry plans to support the following platforms with their <strong>Synergy</strong>/<strong>DE</strong> 8.1 application:<br />
• Windows Server 2003<br />
• Windows 2000 Professional and Server SP3<br />
• Windows NT 4.0 SP6a Workstation and Server<br />
• Compaq Tru64 Unix<br />
• IBM AIX 4.3 or higher<br />
• NCR 3000<br />
About Jack Henry & Associates, Inc.<br />
Jack Henry & Associates, Inc., based in Monett, Missouri, provides integrated computer systems and processes ATM<br />
and debit card transactions for banks and credit unions. Jack Henry markets and supports its systems throughout the<br />
United States and has over 3,000 <strong>customer</strong>s nationwide.<br />
http://www.jackhenry.com<br />
Radley<br />
Continued from page 15<br />
basis.” Radley’s iCARaS <strong>customer</strong>s face the same issues regardless of their size, from the small fastener manufacturer<br />
to the Tier 1, Tier 2, and so forth. Suppliers such as Cummins, Texas Instruments, and American Axle rely on Radley’s<br />
application to keep them in sync with their <strong>customer</strong>s’ requirements.<br />
iCARaS also has a full function shipping system that complies with the <strong>customer</strong>s’ demands, including scanning<br />
options to automatically create shipments and the associated shipping documentation.<br />
For more information about Radley, visit the company Web site at<br />
http://www.radley.com.<br />
17
RCC: Using <strong>XML</strong> to electronically process insurance<br />
policy premiums<br />
About Rural Computer<br />
Consultants<br />
Rural Computer Consultants<br />
(RCC) specializes in developing<br />
applications for propane retailers<br />
and mutual insurance companies.<br />
Started in 1979 by the Sheehan<br />
brothers, Brian and Kevin, the<br />
company has continued to grow in<br />
the fuel and mutual insurance<br />
markets by selling their applications<br />
at the national and international<br />
levels.<br />
RCC’s Mutual Insurance<br />
Processing System (MIPS) is a<br />
complete software/hardware<br />
package specifically built for the<br />
mutual insurance industry. MIPS<br />
includes policy issuance/printing,<br />
integrated rating with user maintainable<br />
rates, agent and/or direct<br />
billing, ACH and/or credit card<br />
processing, agent statement/<br />
reporting, unearned premium<br />
reporting, claims management,<br />
premium/loss ratio analysis,<br />
optional G/L and A/P, and much<br />
more.<br />
RCC uses <strong>XML</strong> to electronically<br />
process insurance policy<br />
premiums<br />
Mutual insurance companies<br />
use MIPS to manage their <strong>customer</strong>s’<br />
insurance policies. On a daily<br />
basis, an insurance company can<br />
run a menu option in MIPS that<br />
determines which premiums are<br />
due and what each <strong>customer</strong>’s<br />
preferred payment method is,<br />
creates <strong>XML</strong> files with this<br />
information, and then sends the<br />
<strong>XML</strong> files to one of two payment<br />
vendor Web services. One vendor’s<br />
Web service handles credit card<br />
payments, communicating with the<br />
appropriate credit card company<br />
and obtaining verification of the<br />
charges. The second vendor<br />
handles ACH, or automatic bank<br />
account withdrawal. The ACH<br />
vendor’s Web service withdraws<br />
the appropriate funds from the<br />
policyholder’s bank account and<br />
deposits them into the insurance<br />
company’s account. If an<br />
account is rejected, the insurance<br />
company is notified and<br />
can then either re-bill the<br />
<strong>customer</strong> with a new account or<br />
credit card number or print the<br />
bill to mail.<br />
“All of this occurs behind the<br />
scenes,” states Kevin Sheehan,<br />
Executive Vice-President of RCC.<br />
“All the insurance company has to<br />
do is receive the money.” The<br />
automation provides a number of<br />
benefits to both policyholder and<br />
insurance company. “It’s one less<br />
bill for the policyholder to worry<br />
about,” adds Sheehan. “Not to<br />
mention the time and money saved<br />
for both sides when you eliminate<br />
check writing and processing, the<br />
manual collecting and processing<br />
of premiums, and the revenue lost<br />
from late or lapsed notices.” The<br />
cost savings don’t end there. Prior<br />
to <strong>XML</strong>, insurance ISVs and their<br />
<strong>customer</strong>s had to pay to use a<br />
proprietary data syntax from<br />
ACORD, a non-profit agency that<br />
develops and maintains various<br />
electronic standards for the<br />
insurance, reinsurance, and related<br />
financial services industries. With<br />
the advent of <strong>XML</strong>, this syntax is<br />
no longer required, eliminating this<br />
surcharge to insurance companies.<br />
Now, the only fees paid to ACORD<br />
are by insurance company ISVs<br />
who rely on the agency to develop<br />
and support the industry’s standards<br />
for sharing data electronically.<br />
ACORD defines naming<br />
conventions and specifies what<br />
data needs to be captured and how<br />
to interpret it—enabling vendors to<br />
easily exchange information.<br />
ACORD has recently released<br />
new standards for the farm<br />
insurance industry, and RCC plans<br />
“<strong>XML</strong> really opens up our<br />
applications to a number of<br />
technologies and alliances. The<br />
opportunities for communication<br />
are truly endless.”<br />
--Kevin Sheehan, Executive Vice-<br />
President of RCC<br />
to take advantage of this new market.<br />
“We will definitely use the <strong>Synergy</strong><br />
<strong>XML</strong> <strong>API</strong> in this next phase of development,”<br />
states RCC’s Senior <strong>Synergy</strong><br />
Developer, Brian Fagerstrom. Future<br />
development will also accommodate the<br />
reinsurance industry, which covers the<br />
insurance companies themselves. And,<br />
RCC plans to incorporate <strong>XML</strong> into<br />
their propane application.<br />
“<strong>XML</strong> really opens up our applications<br />
to a number of technologies and<br />
alliances,” concludes Sheehan. “The<br />
opportunities for communication are<br />
truly endless.”<br />
18
Turnkey’s tkEDGE system uses <strong>Synergy</strong>/<strong>DE</strong> xfODBC to<br />
increase reporting flexibility<br />
<strong>Synergy</strong>/<strong>DE</strong> xfODBC enables Turnkey <strong>customer</strong>s to create sophisticated on-demand reports using a<br />
variety of popular third-party tools<br />
Turnkey Computer Systems<br />
(Turnkey), a premier provider of<br />
software solutions to the feedyard<br />
industry, recently announced the<br />
release of their xfODBC-enabled<br />
reporting system, which is run by<br />
the <strong>Synergy</strong>/<strong>DE</strong>-based tkEDGE<br />
application. <strong>Synergy</strong>/<strong>DE</strong>’s data<br />
connectivity technology (xfODBC)<br />
enables Turnkey’s <strong>customer</strong>s to<br />
create their own on-demand,<br />
customized reports using popular<br />
third-party tools such as Crystal<br />
Reports, Microsoft Query,<br />
Microsoft Excel, and Microsoft<br />
Access.<br />
Terry Jones, programmer and<br />
analyst at Turnkey elaborates:<br />
“One <strong>customer</strong> is maintaining the<br />
data warehouse through ODBC and<br />
is combining data from our<br />
production system with other<br />
sources within his company. He’s<br />
now able to do some very sophisticated<br />
analysis. <strong>Synergy</strong>/<strong>DE</strong><br />
xfODBC is the tool that allows this<br />
to happen.”<br />
Servicing over 200 commercial<br />
feedyards and tracking over 10<br />
million head of cattle per year,<br />
Turnkey was previously inundated<br />
with reporting requests from their<br />
<strong>customer</strong>s. By integrating their<br />
tkEDGE application with xfODBC,<br />
Turnkey has empowered <strong>customer</strong>s<br />
to create their own sophisticated<br />
reports at will. “Customers<br />
appreciate the flexibility, and we<br />
are able to free up development<br />
resources previously devoted to<br />
report creation,” states Steve<br />
Myers, President of Turnkey.<br />
Another product introduced by<br />
Turnkey is the Web Reporting<br />
System. Turnkey uses xfODBC to<br />
extract <strong>customer</strong> data for access via<br />
the Internet. This allows feedyards<br />
to maintain secure online accounts<br />
for each <strong>customer</strong>. Customers can<br />
log onto their online accounts to<br />
view predefined feedyard data such<br />
as shipping and receiving transactions,<br />
and comprehensive yard<br />
sheets that include cattle health<br />
records and feed consumption. The<br />
data can then be downloaded directly<br />
from the Internet into Microsoft Excel<br />
or Microsoft Access. The reporting<br />
functionality aids the feedyard’s<br />
<strong>customer</strong>s in their future planning, as<br />
they can now more effectively analyze<br />
and interpret their data.<br />
Turnkey <strong>customer</strong> Andrew Keller of<br />
Northside Hay Mills in Arizona<br />
comments: “Turnkey’s Web Reporting<br />
System has made getting—and using—<br />
our data easy by making it accessible to<br />
virtually any ODBC-enabled software<br />
package.”<br />
About Turnkey Computer Systems,<br />
Inc.<br />
Turnkey Computer Systems is the<br />
premier provider of software solutions<br />
to the commercial feedyard industry.<br />
Located in Amarillo, Texas, they serve<br />
over 200 clients in North America.<br />
http://www.turnkeynet.com/about.html<br />
<strong>Synergy</strong>/<strong>DE</strong>-built RDS Advantage © offers VoIP<br />
technology<br />
Telephone messaging capabilities help RDS <strong>customer</strong>s improve network use and save money.<br />
In May, RDS Publishing (RDS), a provider of choice software tools and services to churches of all denominations<br />
across the United States, announced that their core application, RDS Advantage, now offers VoIP (Voice over Internet<br />
Protocol). The VoIP technology enables RDS clients to send voice messages via the Internet to thousands of people in<br />
just minutes.<br />
The <strong>Synergy</strong>/<strong>DE</strong>-built RDS Advantage application includes VoIP “Phone Messaging” options on the Member and<br />
Activity Records print menus. Users can employ these options to deliver a customized recorded message to 1000s of<br />
people within just three minutes. After selecting the appropriate target audience, the user clicks on the “WebPhone”<br />
button, which generates a file of those names and phone numbers and sends it to the phone messaging center. The<br />
software then directs the user to a Web page of the phone messaging center, where he enters a password and then<br />
determines how the calls should be made (for example, time of day, whether or not to reply, whether or not to speak the<br />
names of those being called, and so forth).<br />
“A major advantage of VoIP is that it greatly reduces the cost of telephone messaging by using Internet Protocol<br />
instead of typical telephone company lines,” said Dick Webber, President of RDS. “There is no equipment to purchase,<br />
Continued on page 28<br />
19
The Pepsi Bottling Group selects GBG’s <strong>Synergy</strong>/<strong>DE</strong>based<br />
supply chain solution<br />
The Pepsi Bottling Group has<br />
selected Global Beverage Group’s<br />
(GBG) <strong>Synergy</strong>/<strong>DE</strong>-based Sales &<br />
Delivery Management System<br />
(SDMS) as its “route accounting”<br />
solution for its Canadian business.<br />
The Pepsi Bottling Group<br />
produces and distributes more than<br />
85 percent of all Pepsi-Cola<br />
beverages sold in Canada.<br />
“We are very excited to welcome<br />
Pepsi Bottling Group –<br />
Canada to Global Beverage Group.<br />
GBG’s mission is to provide<br />
leading edge software and services<br />
that are specifically designed for<br />
the direct store delivery - route<br />
accounting segment of the supply<br />
chain for the beverage industry. We<br />
look forward to providing that<br />
superior service to The Pepsi<br />
Bottling Group,” said Ted<br />
Hastings, CEO of GBG.<br />
Based on <strong>Synergy</strong>/<strong>DE</strong>, SDMS<br />
is a comprehensive route accounting<br />
application that helps beverage<br />
distributors efficiently manage<br />
every step of the order-to-delivery<br />
cycle, from order entry<br />
and fulfillment to vehicle<br />
loading, delivery, route<br />
settlement, and financials.<br />
SDMS also supports a<br />
range of sales and delivery<br />
methods, including presales,<br />
call-in, and conventional<br />
off-truck sales<br />
operations. SDMS can be integrated<br />
with other value-added<br />
mobile, warehouse and logistics,<br />
asset management, and business<br />
applications from GBG and thirdparty<br />
suppliers.<br />
System implementation was<br />
planned at The Pepsi Bottling<br />
Group for the fourth quarter of<br />
2003.<br />
About The Pepsi Bottling<br />
Group<br />
The Pepsi Bottling Group, Inc.<br />
(http://www.pbg.com) is the<br />
world’s largest manufacturer, seller,<br />
and distributor of Pepsi-Cola<br />
beverages with operations in the<br />
United States, Canada, Greece,<br />
Russia, Spain, and Turkey.<br />
Based on <strong>Synergy</strong>/<strong>DE</strong>, SDMS is a<br />
comprehensive route accounting application<br />
that helps beverage distributors efficiently<br />
manage every step of the order-to-delivery<br />
cycle, from order entry and fulfillment to<br />
vehicle loading, delivery, route settlement,<br />
and financials.<br />
About Global Beverage Group<br />
Global Beverage Group (GBG)<br />
provides direct-store-delivery (DSD)<br />
software solutions for consumer<br />
packaged goods companies. GBG’s<br />
applications integrate DSD processes in<br />
the supply chain for distributors of soft<br />
drinks, beer, wine, spirits, water,<br />
snacks, candy, and tobacco. GBG<br />
<strong>customer</strong>s have the tools they need to<br />
more effectively manage their inventory,<br />
mobile resources, and assets to<br />
enhance revenue, reduce operating<br />
costs, and improve <strong>customer</strong> service.<br />
GBG is headquartered in Waterloo,<br />
Ontario with operations in Austin, Tex.,<br />
Charlotte, N.C., Durham, N.C., Denver,<br />
Colo., Lancaster, Pa. and West Palm<br />
Beach, Fla. For more information, visit<br />
http://www.globalbeveragegroup.com.<br />
ASI releases Internet module for Insite Banking System<br />
Automated Systems, Inc. (ASI)<br />
of Lincoln, Neb., one of the<br />
Midwest’s largest networking<br />
services companies, announced<br />
that it has released an<br />
Internet module of their<br />
Insite Banking System<br />
software. The system adds a<br />
Web interface, enabling<br />
<strong>customer</strong>s to access their<br />
accounts online 24 hours a<br />
day, seven days a week. It<br />
relies on <strong>Synergex</strong>’s<br />
<strong>Synergy</strong>/<strong>DE</strong> xfServerPlus and<br />
xfNetLink products to connect the<br />
Web interface to ASI’s <strong>Synergy</strong>/<br />
<strong>DE</strong>-built banking application<br />
routines.<br />
Developed for small-tomedium-sized<br />
community banks,<br />
the Insite Banking System is a<br />
complete data processing solution.<br />
“Using the <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus and<br />
xfNetLink tools made it easy for us to create a<br />
Web interface for our existing <strong>Synergy</strong> software,”<br />
said Tim Schmidt, Marketing Director of<br />
Automated Systems, Inc.<br />
It was designed with the latest<br />
programming methods, and is a<br />
fully integrated software system.<br />
Using sound financial practices and<br />
ensuring optimum efficiency and<br />
easy operation, the system provides<br />
banks with a complete in-house data<br />
processing system that is comprehensive<br />
and extremely flexible.<br />
The Insite Banking System includes<br />
a cost-effective check imaging<br />
module that displays processed<br />
checks online. This reduces<br />
overhead for banks, improves<br />
<strong>customer</strong> satisfaction, and<br />
enhances workforce productivity.<br />
Other major features include…<br />
- A full range of demand<br />
deposit module, savings, time<br />
deposits, and IRAs, as well as commercial,<br />
consumer, and mortgage loans.<br />
- Automatic interfacing to the<br />
general ledger; a comprehensive<br />
<strong>customer</strong> information system; over 250<br />
Continued on page 28<br />
20
HBS enables pharmacies to handle higher<br />
prescription volumes<br />
Health Business Systems (HBS) has released Rx Workflow, their end-to-end prescription solution, which will enable<br />
pharmacies to track a prescription through all phases of the prescription-filling process.<br />
An add-on module to HBS’ <strong>Synergy</strong>/<strong>DE</strong>-based Retail Pharmacy Management System, Rx Workflow enables a<br />
pharmacy to track the prescription process from beginning to end. From prescription intake, via manual entry or IVR<br />
(automated telephone refill system), through the filling process using bar code scanning of the drug package for data<br />
entry, and through a quality assurance check, using pill images to reduce medication errors, the HBS Workflow solution<br />
enables pharmacies to handle higher prescription volumes with less labor and increased accuracy. HBS <strong>customer</strong>s can<br />
also add on the Signature Capture module, which enables them to automatically collect and store patient signatures, as<br />
required by law, and to create an electronic log of day-to-day transactions for Rx pick-ups. Signature Capture is a<br />
<strong>Synergy</strong> application that communicates with a C language server via the <strong>Synergy</strong> socket <strong>API</strong>.<br />
“By automating the entire Rx processing function, our solution significantly reduces the workload for pharmacists,”<br />
states HBS president Lou Greenberg. “Especially with new HIPAA regulations on maintaining patient privacy records,<br />
pharmacists can get bogged down with paperwork. Our system allows them to increase their productivity, while at the<br />
same time maintaining more accurate and comprehensive records. Ultimately, this enhances the consumer’s experience.”<br />
About HBS<br />
HBS of Warminster, Pennsylvania has been a leader in Pharmaceutical Management technology since the early<br />
1980’s. With a national reputation in the field of high-tech Nursing Home and Mail Order Pharmacy Systems, HBS’<br />
innovative products are enhanced by HBS’ in-depth experience in Systems Integration, Networking, and Hardware<br />
Service. <strong>Synergy</strong>/<strong>DE</strong> powers their Retail Pharmacy Management System.<br />
http://www.hbsrx.com<br />
dabs.com launches new <strong>Synergy</strong>/<strong>DE</strong> xfServerPluspowered<br />
Web site<br />
Note: Attend SPC 2004, and get a behind-the-scenes look at this <strong>customer</strong>’s entire online ordering process as you<br />
learn about Web site design considerations and xfServerPlus integration. Register today on the SPC 2004 Web site:<br />
http://spc.synergex.com.<br />
dabs.com, the United Kingdom’s leading Internet retailer of IT and technology products recently reengineered their<br />
Web site with <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus, and is now processing £18 million ($30.6 million) of orders per month on the<br />
site. The Web site dramatically reduces order processing time, offering users a much-enhanced shopping experience.<br />
With a back-end based completely on <strong>Synergy</strong>/<strong>DE</strong>, dabs.com’s Web site offers over 20,000 lines from the world’s<br />
leading IT and technology manufacturers to over a million online <strong>customer</strong>s across the country. Servicing all of the<br />
United Kingdom from their state-of-the-art facility in Bolton, dabs.com typically processes 5,000 <strong>customer</strong> orders every<br />
day from the 1 million unique visitors that visit dabs.com each month.<br />
The development team at dabs.com recently decided to reengineer their existing Web site using <strong>Synergy</strong>/<strong>DE</strong><br />
xfServerPlus technology. “We weren’t satisfied with the amount of time it was taking to return order information,” states<br />
Paul Martin, dabs.com’s Head of Development. “The xfServerPlus solution was fast and easy to implement, and offered<br />
a dramatic decrease in response time. Our previous solution used DecThreads, Digital’s multithreading runtime library,<br />
and it took 45 seconds to bring back order information. With xfServerPlus, it’s immediate.”<br />
The Web site delivers additional enhancements, including reduced download time, increased bandwidth, improved<br />
sort functionality, and more.<br />
What’s more, dabs.com recently announced a major two-year sponsorship deal with Fulham Football Club, currently<br />
riding high in England’s Premier soccer league. As the official team sponsor for the 2003/2004 and 2004/2005 seasons,<br />
the dabs.com logo appears on the front of both the Fulham men’s and ladies’ shirts.<br />
Jonathan Wall, Marketing Director of dabs.com commented, “The shirt sponsorship deal with Fulham will undoubtedly<br />
propel our brand into a whole new dimension, putting our name in front of millions of people throughout the next<br />
two years. More importantly, and of particular importance for us as an Internet retailer, this sponsorship program will<br />
really help establish our online brand as a recognizable, reliable and viable alternative to the traditional retail outlet.”<br />
Continued on page 31<br />
21
The <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong>: Empowering Businesscraft to<br />
Provide Streamlined Integration Solutions<br />
Based in Newcastle, Australia, Businesscraft Pty. Ltd. provides commercial accounting and mission-critical<br />
software systems to the manufacturing, service, and building industries. Builders, manufacturers, and engineering<br />
shops across Australia use the <strong>Synergy</strong>/<strong>DE</strong>-based Businesscraft Corporate Management Software (Businesscraft) to<br />
manage all aspects of their daily operations, including job costing, estimating, contracts, workflow, financials, and<br />
much more.<br />
Businesscraft uses <strong>XML</strong> to import work order requests into their accounting software.<br />
One of Businesscraft’s clients, Machine Monitor, provides machine monitoring and plant maintenance on a<br />
contract basis for mines and manufacturers. They use the Businesscraft application to process the high volume of<br />
incoming job orders they receive on a daily basis.<br />
Recently, Machine Monitor created a Web application that enables site engineers to enter maintenance work<br />
order requests via the Web. To integrate their accounting software with this Web application, Businesscraft decided<br />
to implement an <strong>XML</strong> solution. Work order requests are now transmitted from Machine Monitor’s Web application<br />
to the Businesscraft application via e-mail messages containing <strong>XML</strong> documents as attachments. Upon receipt, the<br />
Businesscraft application uses the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> to extract and process the <strong>XML</strong> data and creates a new job in<br />
the Businesscraft Job Costing/Order Entry module.<br />
Continued on page 31<br />
Large regional education center replaces Visual Basic<br />
application with <strong>Synergy</strong>/<strong>DE</strong> solution<br />
Netherlands-based JPD Automatisering (JPD) has been selected by a leading Dutch Regional Education Center<br />
(ROC, or Regionaal Opleidingscentrum in Dutch) to use <strong>Synergy</strong>/<strong>DE</strong> to rewrite its existing Visual Basic human<br />
resources application. Lacking the resources to extend the existing application and accommodate its growing user<br />
base, the ROC has commissioned JPD to provide the increased functionality, performance, and flexibility its<br />
application requires.<br />
This ROC is one of the largest regional education centers in the Netherlands, educating over 22,000 students at<br />
54 locations. Supervisors in all four of the ROC’s divisions currently use the Visual Basic application to track<br />
personnel data—such as work schedules, job functions, and salaries—for their 2200+ employees. Because the<br />
current system doesn’t support data sharing, such tracking becomes difficult with teachers at remote locations—a<br />
frequent concern since some of the divisions contain over 20 schools. Managers at the remote locations are forced<br />
to keep separate, independent records for each teacher in standalone databases on their desktops. This data is never<br />
conveyed back to the teachers’ supervisors, who require it for scheduling and performance tracking, nor to the<br />
division HR departments, who would like to use it for reporting and planning purposes.<br />
Frustrated with the application’s limited functionality and the degree of difficulty required to maintain it, one of<br />
the ROC’s chief directors approached JPD Automatisering in search of a solution more suitable for the growing<br />
user 31base.<br />
“Sharing and maintaining these disparate databases is cumbersome and unreliable,” states J.P. van Dijk of JPD<br />
Automatisering. “What the ROC needs is a centralized source of up-to-date data that can be easily accessed and<br />
shared among their multiple users.”<br />
After reviewing the options available to them, the ROC decided to take JPD’s recommendation to rewrite the<br />
application using <strong>Synergy</strong>/<strong>DE</strong>. Although pleased with many of the basic concepts of their existing application, the<br />
ROC’s administrators recognized a need to accommodate their growing user base. Appreciating the ROC’s desire to<br />
retain many of the current application’s features, JPD’s first step will be to duplicate the application’s existing<br />
functionality, using <strong>Synergy</strong>/<strong>DE</strong> Professional Series Workbench. Once this has been accomplished, the most urgent<br />
enhancements will be incorporated.<br />
The new <strong>Synergy</strong> application will be deployed in a Windows Terminal Services environment. “At the 2003<br />
<strong>Synergex</strong> Success Partners Conference, I discussed this client with the <strong>Synergex</strong> Professional Services Group,”<br />
states van Dijk. “They suggested Terminal Services because of the simplified deployment and centralized system<br />
Continued on page 31<br />
22
<strong>Synergy</strong>/<strong>DE</strong> <strong>customer</strong> MCS uses <strong>XML</strong> for business-tobusiness<br />
data transport and to communicate with Web<br />
services<br />
About MCS & Insitu<br />
Headquartered in the Thames Valley in England, MCS Global Limited develops and distributes the leading computer-based<br />
management system for the equipment and tool rental market. Deployed in countries worldwide, their <strong>Synergy</strong>/<strong>DE</strong>-based Insitu<br />
application suite tracks a wide variety of rental items—everything from deep-sea diving equipment to cement mixers.<br />
How is MCS using <strong>XML</strong>?<br />
MCS uses <strong>XML</strong> for business-to-business data transport and to communicate with Web services.<br />
Data transport<br />
The Point of Sale (POS) application is the principal component of MCS’ Insitu software suite. It handles various types of<br />
transactions, both rental and sales, from initial inquiry to final accounting. MCS <strong>customer</strong>s wanted a streamlined process for<br />
electronically invoicing their <strong>customer</strong>s and receiving orders from them. However, end users’ incompatible applications and<br />
operating systems prohibited the sharing of data, forcing MCS <strong>customer</strong>s to complete these processes manually.<br />
“Some of our <strong>customer</strong>s generate over 10,000 invoices a month,” states Mark Nolan, Research and Development Manager at<br />
MCS. “Getting bogged down with manual billing procedures and costly human errors just isn’t an option for them.”<br />
Looking for an affordable way to meet their <strong>customer</strong>s’ requirements, MCS decided to incorporate <strong>XML</strong> into the Insitu<br />
solution. Outbound invoices and dispatch notices are now converted to <strong>XML</strong>, enabling third-party applications to receive and<br />
understand the data. Similarly, inbound orders and remittance notices arrive in <strong>XML</strong> format, enabling easy interpretation by<br />
Insitu.<br />
“Opening up this type of communication has allowed us to streamline many of the day-to-day processes for our <strong>customer</strong>s,”<br />
maintains Nolan. “Using <strong>XML</strong>, we can offer our <strong>customer</strong>s this new functionality without the complexity or the expense<br />
associated with traditional EDI solutions.”<br />
Communication with Web services<br />
Another way <strong>XML</strong> is helping Insitu users streamline business processes is by enabling them to communicate with Web<br />
services. When users enter new <strong>customer</strong> or supplier details, Insitu calls on the http://www.postcodeanywhere.co.uk Web service<br />
to help the user specify address information. When a user enters a number in the zip code field, Insitu uses the <strong>Synergy</strong> HTTP<br />
document transport <strong>API</strong> to send a request to the postcode Web service. It requests all company addresses with that zip code and<br />
then uses the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> to parse the <strong>XML</strong> data that is returned. The user receives a list of addresses corresponding to<br />
the zip code entered and can simply click on the appropriate entry.<br />
“This obviously saves our <strong>customer</strong>s significant time, not to mention the increase in accuracy it provides,” states Rachel<br />
Blunden, MCS Senior Developer. “Given the success with ‘postcodeanywhere,’ we have decided to look at Web services for<br />
other areas of our application. We are just beginning to unlock the tremendous potential this technology offers our application.”<br />
Note: Because their data transport implementation occurred before the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> was available, MCS created their<br />
own <strong>XML</strong> parsing/assembling code to meet their needs for that project. “We would have used the <strong>XML</strong> <strong>API</strong> if it had been<br />
available at the time,“ says Nolan. “We used the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> parsing routines with our Web services project, and it was<br />
certainly easier than creating our own parsing code.”<br />
<strong>Synergy</strong>/<strong>DE</strong> to support Microsoft .NET<br />
Continued from page 3<br />
<strong>Synergy</strong>/<strong>DE</strong> will enable <strong>customer</strong>s to migrate existing applications gradually to the .NET Framework, rather than requiring<br />
revolutionary code changes all at once. “This will allow our <strong>customer</strong>s to leverage the best available technology while continuing<br />
to preserve their <strong>Synergy</strong>/<strong>DE</strong> investment,” added Mooney.<br />
As a member of the Microsoft Visual Studio .NET Integration Program (VSIP), <strong>Synergex</strong> is working with Microsoft to<br />
ensure a smooth and optimized integration with Microsoft Visual Studio .NET. “Microsoft offers tremendous value to business<br />
application developers who continuously want to evolve their solutions to new technologies,” said Chris Flores, lead product<br />
manager for the Developer and Platform Evangelism Division at Microsoft Corp. “It’s great to see <strong>Synergex</strong> delivering this<br />
value to their <strong>customer</strong>s.”<br />
23
24<br />
<strong>Synergy</strong>/<strong>DE</strong> Technology Center<br />
Reducing network traffic with xfNetLink <strong>Synergy</strong> Edition<br />
If you use <strong>Synergy</strong>/<strong>DE</strong> UI Toolkit and <strong>Synergy</strong>/<strong>DE</strong> xfServer, you may be able to reduce your network traffic by using<br />
xfNetLink <strong>Synergy</strong> and xfServerPlus to move your record filtering to your server machine. xfNetLink <strong>Synergy</strong> is a set of<br />
routines distributed with <strong>Synergy</strong>/<strong>DE</strong> Professional Series. These routines work in conjunction with xfServerPlus to execute<br />
<strong>Synergy</strong> routines stored on a remote server.<br />
Your application probably filters out records each time it searches for a specific set of records. For example, your<br />
application may read a <strong>customer</strong> transaction file looking for invoices between two dates. If there is no suitable key, the<br />
application has to read the records in a loop and, for each record, first decide if it’s an invoice, and then decide if the invoice<br />
is in the required date range. In a “traditional” <strong>Synergy</strong> application, where the data resides on a different computer, the<br />
application has to retrieve each record from the data server, move it across the network, and then decide if the record is<br />
valid. With the approach suggested below, the application will tell the data server “get me the next valid record.” A routine<br />
on the data server will read through the file until it finds a valid record and then return that record to the application.<br />
This implementation would be particularly beneficial when you are reading through a large number of records in a data<br />
file and rejecting some of those records as part of a filtering process. An example of this is in a UI Toolkit load method.<br />
Depending on the size of the records and the frequency of record rejection, this technique can significantly reduce the traffic<br />
on your network. In simple tests run on <strong>Synergex</strong>’s in-house defect tracking application (Tracker), we reduced the typical<br />
time taken to load lists by 50 percent.<br />
The approach is relatively simple and should only take a short time to implement.<br />
1. Install and configure xfServerPlus on the server machine where the data is stored.<br />
2. Create a new subroutine (e.g., list_getrec) to do the work of selecting the next valid record. This is the routine that will<br />
be called remotely from your Toolkit application. Build the list_getrec subroutine into a separate ELB for use by<br />
xfServerPlus and enter it in the Method Definition Utility. Place the ELB on the server machine.<br />
3. Modify your Toolkit application to use xfNetLink <strong>Synergy</strong>. It will need to call %RX_START_REMOTE to create an<br />
xfServerPlus session and store the returned network ID so that it will be available to the load method. Your Toolkit application<br />
will also need to call RX_SHUTDOWN_REMOTE to close the xfServerPlus session when you are finished making<br />
remote calls.<br />
4. Modify the load method to use %RXSUBR to call the list_getrec subroutine. Because list_getrec is now doing the<br />
record filtering, the list method only needs to handle the display of the records sent to it. (In essence, you are splitting the<br />
load method in two: the code that does the record filtering is now part of list_getrec.)<br />
For more information on using xfNetLink <strong>Synergy</strong> and xfServerPlus, see the Developing Distributed Applications<br />
Manual.<br />
The <strong>Synergy</strong> CodeExchange (in the Resource Center of <strong>Synergex</strong>’s Web site) has sample code that illustrates this<br />
approach: “Example using xfNetLink <strong>Synergy</strong>.”<br />
When you review the sample code, be sure to read the “implementation notes” in the header for some additional implementation<br />
considerations.<br />
Are you wrapping your <strong>Synergy</strong>/<strong>DE</strong> installation on Windows?<br />
If so, be sure to get the Windows Installation Log Utility, wilogutl.exe. This utility will help you analyze log files from a<br />
Windows Installer installation, and it offers possible causes of errors in the log file. (Since you are not displaying <strong>Synergy</strong>/<strong>DE</strong><br />
installation screens and not displaying non-critical installation errors, you will rely on the windows installer log files to report<br />
the results of your installation.) Wilogutl.exe may be run in quiet mode or with a user interface, and it generates reports as text<br />
files.<br />
Example:<br />
If you encounter an error, such as:<br />
“The wizard was interrupted before <strong>Synergy</strong>/<strong>DE</strong> 7.5.1c could be completely installed. Your system has not been modified.<br />
To complete installation at another time, please run setup again.”<br />
you can determine which action caused the installation to end by running wilogutl and reviewing the information in its Error<br />
box.<br />
If you did not have this utility, you would have to manually search the log file and interpret the log information yourself. If<br />
an installation has multiple errors, the log utility has the ability to generate an html format of the logfile. This html page would<br />
allow you to navigate through the log file error by error rather than having to scroll through every line of the log file.<br />
(Please note that there is a typo in Microsoft’s documentation of the utility—the example command line says “WiLogUtil”<br />
but should actually be “WiLogUtl” without the “i.”)<br />
Continued on page 25
Technology Center<br />
Continued from page 24<br />
What is <strong>XML</strong>, and how can you use it with <strong>Synergy</strong>/<strong>DE</strong>?<br />
<strong>XML</strong> (Extensible Markup Language) is a standard that specifies a syntax that enables you to create your own markup<br />
language. It wraps all data in tags that identify what each piece of data represents. As the name suggests, you can define an<br />
unlimited number of tags to define the data in the <strong>XML</strong> document. <strong>XML</strong> looks similar to HTML in that it employs the start-tag/<br />
end-tag mechanism to delimit the data. <strong>XML</strong> is used to store and transmit information both on and off the Web.<br />
<strong>Synergy</strong>/<strong>DE</strong> 8.1 introduced an <strong>XML</strong> <strong>API</strong> that enables you to parse and assemble <strong>XML</strong> documents. The <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong><br />
gives you direct access to <strong>XML</strong> from within your <strong>Synergy</strong> programs. It enables you to:<br />
• Parse an <strong>XML</strong> file or string into a memory-based <strong>XML</strong> document that represents a DOM tree. Parsing the file means to<br />
disassemble the <strong>XML</strong> so that your <strong>Synergy</strong> program can process it.<br />
• Iterate through the DOM tree to access the <strong>XML</strong> data. This entails finding the root element, being able to iterate recursively<br />
through its children, and being able to get text and attributes for all these elements.<br />
• Assemble <strong>Synergy</strong> data into a memory-based <strong>XML</strong> document. This includes<br />
being able to specify an element’s children, attributes, and text values.<br />
• Write the contents of a memory-based <strong>XML</strong> document to a file or <strong>XML</strong> string.<br />
Visit the World Wide Web Consortium’s Web site on <strong>XML</strong> for more information.<br />
The URL is http://www.w3.org/<strong>XML</strong>/.<br />
Web Services: An Overview<br />
Promising a new level of compatibility across multiple technology platforms, Web<br />
services enable you to build more powerful applications by allowing you to integrate<br />
with third-party vendors in real time.<br />
Web services are based on <strong>XML</strong>, which provides a “lowest common denominator”<br />
method for different systems to talk to each other. <strong>XML</strong> can be used to create a set of<br />
industry standard protocols for finding companies, describing and exchanging information,<br />
and handling transactions between companies.<br />
Learn more about <strong>XML</strong> and<br />
Web Services by visiting the<br />
<strong>Synergy</strong>/<strong>DE</strong>, <strong>XML</strong>, and Web<br />
Services microsite within the<br />
<strong>Synergy</strong>/<strong>DE</strong> Resource Center on<br />
<strong>Synergex</strong>.com. http://<br />
resourcecenter.synergex.com/<br />
Open/SdeMicrosites/xml/<br />
Default.asp<br />
(Attention HelpDesk Support <strong>customer</strong>s:<br />
After clicking on this link, log into the<br />
Resource Center. You’ll then be<br />
redirected to the <strong>Synergy</strong>/<strong>DE</strong>, <strong>XML</strong>, and<br />
Web Services microsite.)<br />
Web services range from major services such as <strong>customer</strong> relationship management (CRM), to more limited services such as<br />
the checking of bids for an auction item. Using multiple vendors’ Web services, one can simultaneously communicate with a<br />
vendor for the latest price of an item, submit an order, and track the order until it has been received. Future Web services will<br />
allow further integration, such as the ability to schedule appointments with other exposed calendars online.<br />
A client program can communicate to a Web service using the Simple Object Access Protocol (SOAP). SOAP requests are<br />
specially formatted <strong>XML</strong> documents that request some functionality from a Web service over HTTP.<br />
With <strong>Synergy</strong>/<strong>DE</strong>’s introduction of the HTTP <strong>API</strong> in version 7.5.1 and the <strong>XML</strong> <strong>API</strong> introduced in 8.1, it is possible for your<br />
<strong>Synergy</strong> programs to make SOAP requests of Web services and process the responses.<br />
Get more information on the HTTP <strong>API</strong> and <strong>XML</strong> <strong>API</strong> in the <strong>Synergy</strong> Language Reference Manual within the <strong>Synergy</strong>/<strong>DE</strong><br />
Resource Center.<br />
Simple Object Access Protocol (SOAP) enables applications to communicate with each other.<br />
SOAP uses HTTP and <strong>XML</strong> as the mechanisms for information exchange. Since these Web protocols are installed and<br />
available for use by all major operating system platforms, HTTP and <strong>XML</strong> provide an already at-hand solution to the problem of<br />
how programs running under different operating systems in a network can communicate with each other. SOAP specifies exactly<br />
how to encode an HTTP header and an <strong>XML</strong> file so that a program in one computer can call a program in another computer and<br />
pass it information. It also specifies how the called program can return a response.<br />
An advantage of SOAP is that program calls are much more likely to get through firewall servers that screen out requests<br />
other than those for known applications. Since HTTP requests are usually allowed through firewalls, programs using SOAP to<br />
communicate can be sure that they can communicate with programs anywhere.<br />
For information about <strong>Synergy</strong>/<strong>DE</strong>’s <strong>XML</strong> and HTTP <strong>API</strong>s, refer to the <strong>Synergy</strong> Language Reference Manual.<br />
Continued on page 26<br />
25
Technology Center<br />
Continued from page 28<br />
HTTPS<br />
HTTPS (HyperText Transfer Protocol over Secure Socket Layer, or HTTP over SSL) is a Web protocol that uses<br />
Netscape’s Secure Socket Layer (SSL) as a sublayer under its regular HTTP application layering to encrypt and decrypt user<br />
page requests as well as the pages that are returned by the Web server.<br />
For example, if you are using a browser to order from an online catalog, you will be given a Web page order form with a<br />
URL that starts with https://. When you submit the order form to the retailer, your browser’s HTTPS layer will encrypt it,<br />
and the server will reply on the same connection with an equally encrypted acknowledgment. The acknowledgment will<br />
then be decrypted for you by your browser’s HTTPS sublayer.<br />
HTTPS and SSL support the use of X.509 digital certificates from the server so that, if necessary, a user can authenticate<br />
the sender. A digital certificate is an electronic “credit card” that establishes your credentials when doing business or other<br />
transactions on the Web. It is issued by a certification authority, and contains your name, a serial number, expiration dates, a<br />
copy of the certificate holder’s public key (used for encrypting messages and digital signatures), and the digital signature of<br />
the certificate-issuing authority so that a recipient can verify that the certificate is real. X.509 is a widely used standard for<br />
defining digital certificates.<br />
Since <strong>Synergy</strong>/<strong>DE</strong> 7.5.1, <strong>Synergy</strong> developers have been able to make requests of non-secure Web servers using the<br />
<strong>Synergy</strong> HTTP document transport <strong>API</strong>. <strong>Synergy</strong>/<strong>DE</strong> 8.1 added extensions to this <strong>API</strong> that enable users to make requests of<br />
secure Web servers using HTTPS.<br />
SSL is an open, nonproprietary protocol that Netscape has proposed as a standard to the World Wide Consortium. For<br />
more information about HTTPS and SSL, visit the following Web pages:<br />
• Introduction to SSL: http://developer.netscape.com/docs/manuals/security/sslin/contents.htm<br />
• Understanding Encryption and SSL: http://developer.netscape.com/docs/manuals/proxy/adminux/encrypt.htm<br />
• Securing Access to Web Servers: http://www-uxsup.csx.cam.ac.uk/%7Ejw35/courses/using_https/notes.html<br />
Using Microsoft’s GAC and NGEN.EXE utility with <strong>Synergy</strong>/<strong>DE</strong> xfNetLink .NET<br />
To build a distributed system with xfNetLink .NET and xfServerPlus, you’ll need to understand the GAC (Global<br />
Assembly Cache). The GAC is a directory structure in which a .NET application will look for assemblies. Assemblies<br />
placed in the GAC are considered “public,” enabling a single copy of the assembly to be used by multiple applications.<br />
A native image is an assembly that has been pre-compiled for the particular platform it is running on. An assembly<br />
installed as a native image is installed in the GAC with the ngen.exe utility.<br />
Not all assemblies need to be installed in the GAC or as native images; however, if you want to use (COM+) pooling, it<br />
is required that your assembly be registered in the GAC. The Microsoft Developer’s Network (MSDN) library contains<br />
additional information about the GAC and examples of the types of assemblies that need to be either added to the GAC or<br />
installed as native images.<br />
Signing Assemblies vs. Delayed Signing of Assemblies in <strong>Synergy</strong>/<strong>DE</strong> xfNetLink .NET<br />
When you run a batch file to build an assembly, xfNetLink NET generates public and private keys in a strong name key<br />
file (.snk file).<br />
These keys will be used to sign the generated assembly when you build your project in the batch file or Visual Studio<br />
.NET. Signing a .NET assembly is required to install the assembly into the GAC (global assembly cache). Signing is also<br />
used for distribution purposes, such as when the CLR (common language runtime) checks a generated hash value associated<br />
with a signed assembly to determine that the assembly has not been tampered with.<br />
If signing is not a concern for your application, you can simply use the defaults (i.e., do nothing in this regard). However,<br />
your company may decide to develop a policy for signing assemblies. In this <strong>case</strong>, you will need to do the following before<br />
running the batch file:<br />
• Create your own .snk file using Microsoft’s sn.exe utility, which is included in the .NET Framework SDK.<br />
• Edit the batch file (xmlFilename.bat). This file includes a line that runs sn.exe to create the default key file.<br />
• Edit the AssemblyKeyFile attribute in the AssemblyInfo.cs file to include your .snk file instead of the default file.<br />
Continued on page 27<br />
26
Technology Center<br />
Signing Assemblies...<br />
Continued from page 26<br />
Depending on your workflow, it may be more convenient to use delayed signing. Delayed signing assigns the public<br />
key when the assembly is built, but enables you to delay the assignment of the private key until you are ready to<br />
distribute the assembly. If you are using delayed signing, you will need to use the name of the public key file for the<br />
AssemblyKeyFile attribute in AssemblyInfo.cs and change the AssemblyDelaySign attribute to “true.”<br />
DOM Trees<br />
When you use the <strong>Synergy</strong> <strong>XML</strong> <strong>API</strong> to parse an <strong>XML</strong> file, a “tree view” of the document is produced. This tree<br />
view is called a DOM (Document Object Model) tree, and it can be traversed to retrieve and manipulate the <strong>XML</strong> data.<br />
The document’s root element is the top level of the tree. This element can have one or many child elements, or nodes,<br />
which represent the branches of the tree. Using a DOM, you can create a document, navigate its structure, and add,<br />
modify, or delete its elements.<br />
Here is an example of an <strong>XML</strong> document:<br />
<br />
<br />
<br />
And here is what this document would look like as a DOM<br />
tree. In this example, the topmost tag, structure, becomes the<br />
root element. This structure element has two attributes: name<br />
and size. Below it are the three child elements representing the<br />
three field tags. Each of these children, in turn, has three<br />
attributes: name, type, and size.<br />
synconfig<br />
Continued from page 6<br />
Visual SlickEdit key at your fingertips.<br />
Synconfig can be found on the <strong>Synergy</strong>/<strong>DE</strong><br />
Utilities menu (Start > Programs > <strong>Synergy</strong><strong>DE</strong><br />
> Utilities > <strong>Synergy</strong> Configuration Program).<br />
For more information about the <strong>Synergy</strong><br />
Configuration Program, refer to the Installation<br />
Configuration Guide.<br />
Fcompare<br />
Continued from page 7<br />
Sample output from fcompare (repository option):<br />
Data file [DATA1:orders], revision [4], creation version<br />
[7.3.1]<br />
Structure [orders]<br />
INFO: Record size defined as [863], actual [863]<br />
INFO: Number of access keys defined as [15], actual [15]<br />
WARNING: Key 3, Key length defined as [170], actual<br />
[200]<br />
ERROR: Key 3, Defined segment positions do not match<br />
actual segment positions<br />
Performing data tests...<br />
10 records read<br />
No data errors found<br />
Checked 1 file<br />
Fcompare is a very useful tool and should be run routinely<br />
after you create or update a repository or anytime you suspect a<br />
database performance problem. For more information about<br />
fcompare, refer to the “<strong>Synergy</strong> DBMS” chapter of the version<br />
8.1 <strong>Synergy</strong> Language Reference Manual.<br />
27
<strong>Synergex</strong> Success Partners Conference 2003: A Success<br />
“My SPC goals were elaborately met…I feel like I now have a good idea of recent, current, and future development.<br />
I particularly enjoyed learning about new features from the people who are actually in the process of<br />
developing them.”<br />
Dave Overbeck<br />
Turn-Key Distribution Systems, Inc.<br />
SPC 2003 Attendee<br />
SPC 2003 concluded on March 12, following an action-packed four-city tour. During each of the two-day<br />
conferences, <strong>customer</strong>s experienced the debut of <strong>Synergy</strong>/<strong>DE</strong> 8.1 and learned about the <strong>XML</strong> parser, HTTPS<br />
support, and enhancements to UI Toolkit, Workbench, and xfODBC. SPC attendees also learned about the upcoming<br />
<strong>Synergy</strong> object support, a powerful model for writing <strong>Synergy</strong> software; <strong>Synergy</strong>/<strong>DE</strong> support for Microsoft<br />
.NET, which offers a number of significant benefits to business application developers; the <strong>Synergy</strong>/VisualSmart<br />
product, which delivers analytics at the speed of thought; and exciting change management features in PVCS<br />
Tracker 7.5. Other SPC topics included scalability and performance, Web services, and xfODBC maximization.<br />
There were also plenty of opportunities at each conference for one-on-one discussions and networking with<br />
<strong>Synergex</strong> staff and <strong>Synergy</strong> developers.<br />
Thank you to everyone who attended SPC 2003. We look forward to seeing you all—and those who couldn’t<br />
make it this year—at SPC 2004.<br />
“By experiencing the latest features of <strong>Synergy</strong>/<strong>DE</strong>, we were able to see where <strong>Synergex</strong> is today; and by seeing<br />
the OO session, where they are planning to go in the future...The SPC gives me a chance to escape the hustle and<br />
bustle of business and think strategically-I use it like a software development retreat.”<br />
Don Fillion<br />
Distribution Management Systems<br />
SPC 2003 Attendee<br />
Come to the SPC 2004 and learn how easy it is to unleash the<br />
power of your <strong>Synergy</strong> applications. For details, visit<br />
http://spc.synergex.com.<br />
RDS Advantage<br />
Continued from page 19<br />
no minimum or maximum number of calls to make, and there are loads of<br />
user-defined criteria users can set for their calls.”<br />
RDS’ <strong>customer</strong>s are also pleased with the VoIP system. “We contacted<br />
RDS Advantage because we wanted to reach a large number of households<br />
in a short time,” said Chuck Pace, Minister of Education at the First Baptist<br />
Church in Lake Jackson, Texas. “RDS suggested two options: one was to<br />
purchase approximately $3,500 of phone messaging equipment and use six<br />
phone lines. The other was to use their VoIP telephone messaging capability,<br />
which requires no equipment and uses none of our phone lines. Needless<br />
to say, we chose the second option, and were able to reach 900<br />
households within a few minutes. I even watched the progress online.”<br />
ASI<br />
Continued from page 20<br />
standard reports; custom <strong>Synergy</strong>/<br />
<strong>DE</strong> ReportWriter reports; customized<br />
interfaces for ACH, ATM,<br />
electronic cash letters, proof<br />
machines, and reader/sorters; a<br />
fully integrated safe deposit box<br />
module; periodic upgrades to<br />
maintain regulatory compliance;<br />
and investment accounting—all in<br />
an ODBC compatible database.<br />
28
Where in the World Is <strong>Synergy</strong>/<strong>DE</strong>?<br />
Continued from page 2<br />
France, Poland, Japan, and elsewhere,<br />
Smithfield’s brands set the<br />
standard for fresh pork and processed<br />
meats.<br />
To manage their catalog orders,<br />
Smithfield uses the <strong>Synergy</strong>/<strong>DE</strong>-based<br />
Windows Catalog Order Entry System<br />
from Monette Information Systems.<br />
By ordering products online or from<br />
Smithfield’s printed catalog, <strong>customer</strong>s<br />
can bring home the taste and tradition<br />
of classic Virginia with world-famous<br />
hams direct from Smithfield, Virginia.<br />
With Monette’s Catalog Order Entry<br />
System, <strong>customer</strong>s can order country<br />
hams, exclusive gourmet gift baskets,<br />
Virginia peanuts, smoked turkeys,<br />
seafood, tasty cakes, and more.<br />
In 2002, Monette built the Windowsbased<br />
Catalog Order Entry System from<br />
the ground up. By the end of 2002,<br />
Monette had processed 48,000 orders<br />
for Smithfield. The Windows-based<br />
system enabled Monette to seamlessly<br />
integrate Web orders, UPS shipping and<br />
tracking, and credit card authorization<br />
systems, which significantly streamlined<br />
operations. The Order Entry<br />
system also provides a custom interface<br />
to BEST! Software’s MAS200 suite of<br />
Windows-based financial applications.<br />
For more information on Smithfield<br />
and Monette, browse the following Web<br />
sites: http://www.smithfieldfoods.com,<br />
http://www.smithfieldhams.com, and<br />
http://www.monette.com.<br />
<strong>Synergy</strong>/<strong>DE</strong> is backing the largest<br />
media-based aid organization In<br />
the United Kingdom!<br />
Broadcasting Support Service (BSS)<br />
(http://www.bss.org/) is a not-for-profit<br />
organization specializing in providing<br />
information to the public. With subjects<br />
ranging from social, health, educational,<br />
and public service issues to those of a<br />
more entertaining or commercial nature,<br />
BSS provides a vital link between their<br />
clients and those they serve, whether<br />
they be <strong>customer</strong>s, supporters, the<br />
general public, viewers, or listeners.<br />
BSS uses Gould Hall Computer<br />
Services’ (http://www.gouldhall.com/<br />
index.asp) <strong>Synergy</strong>/<strong>DE</strong>-built<br />
OSCAR (Orders Sales Costing<br />
And Reporting) system, which was<br />
designed for companies that<br />
manage the fulfillment of orders<br />
and the storage and distribution of<br />
materials for many clients.<br />
OSCAR enables BSS Distribution<br />
to handle the management,<br />
reporting, and production processes<br />
for the following services:<br />
• System management for<br />
Granada TV’s (http://<br />
www.granadamedia.com/<br />
cybersword/dotcom/default.asp)<br />
successful program “You’ve Been<br />
Framed,” which airs humorous<br />
video clips submitted by viewers.<br />
For instance, OSCAR serves up<br />
information to <strong>customer</strong>s who call<br />
the BSS contact line and want to<br />
find out exactly where their video<br />
is in the selection process. Approximately<br />
one thousand videos<br />
per week are entered into the<br />
OSCAR-run database. OSCAR<br />
also enables the “You’ve Been<br />
Framed” system to produce a<br />
unique barcode label and reference<br />
number for each of these videos,<br />
enabling the tracking of the video<br />
through each stage of the selection<br />
and eventual returns process.<br />
• Requests for program<br />
support literature for shows such<br />
as “Changing Rooms,” “Ground<br />
Force,” “Neighbours From Hell,”<br />
and “Son of God.”<br />
• Online purchases on<br />
Channel4.com (http://<br />
www.channel4.com/booklets).<br />
• Fulfillment of support<br />
materials for adult training courses<br />
via “Learn Direct.”<br />
OSCAR has enabled BSS<br />
Distribution to expand the portfolio<br />
of services it offers to clients<br />
and empowers them with a greater<br />
control over the delivery of these<br />
services.<br />
“We chose Gould Hall after<br />
evaluating what software was<br />
available for our market place,”<br />
says Bill Balance, BSS Operations<br />
Manager. “The bespoke system<br />
they are developing for us allows<br />
us to rapidly and efficiently react to<br />
our client’s needs and requirements.”<br />
Note: Gould Hall’s OSCAR<br />
system also manages donations<br />
given to Ethiopiaid (http://<br />
www.ethiopiaid.org.uk/) and the<br />
Brooke Hospital for Animals<br />
(http://www.brookehospital.org.uk/brooke/<br />
homeframe.html). These donations<br />
are processed through OSCAR via<br />
credit or debit cards, checks, postal<br />
orders, direct debits, and so forth.<br />
Ever get out of bed on a<br />
freezing cold day and have<br />
your feet greeted by a soft,<br />
warm carpet instead of a cold<br />
stone floor?<br />
If so, you may have <strong>Synergy</strong>/<br />
<strong>DE</strong> to thank! The Headlam Group<br />
(Headlam), the number one<br />
carpeting distributor in the world,<br />
uses Gould Hall’s <strong>Synergy</strong>/<strong>DE</strong>based<br />
Enterprise application<br />
(including its xfServerPlus Webenabling<br />
tools) to manage the<br />
entire distribution of their 35 trade<br />
brands of floor coverings. Enterprise<br />
automates the entire fulfillment<br />
process—from the minute an<br />
order is received, to the electronic<br />
transmission of the order to the<br />
fork lift, to the automatic cutting<br />
and packaging of the order, to the<br />
delivery of the order to the <strong>customer</strong><br />
... all within 16 hours of the<br />
order being placed!<br />
“Enterprise enables us to supply<br />
our <strong>customer</strong>s with products from<br />
all of the leading floorcovering<br />
manufacturers in the UK, Continental<br />
Europe and North America,”<br />
states Tony Brewer with Headlam.<br />
“By automating our entire distribution<br />
process, we are able to fill our<br />
orders quickly, exactly, and<br />
efficiently.”<br />
Continued on page 30<br />
29
Where in the World Is <strong>Synergy</strong>/<strong>DE</strong> Now?<br />
Continued from page 29<br />
See Headlam’s facilities in action. Visit their Web site at http://www.headlam.com/sections/company/<br />
company.htm.<br />
How is <strong>Synergy</strong>/<strong>DE</strong> related to lush tropical gardens, waterfalls and exotic wildlife?<br />
Located on Waikiki’s widest stretch of beach, the Hilton Hawaiian Village Beach features lush tropical gardens,<br />
waterfalls and exotic wildlife.<br />
Hilton Grand Vacation Club at the Hilton Hawaiian Village’s premier location offers guests immediate access to<br />
the abundant treasures of the 20-acre resort including: expansive recreation facilities, classic restaurants, diverse<br />
entertainment and world-class shopping. Sound appealing? These properties at the Hilton Hawaiian Village are just<br />
a sampling of the time-share properties managed by Hilton Grand Vacation Company (HGVC). And thanks to<br />
HGVC’s <strong>Synergy</strong>/<strong>DE</strong>-based reservations and property management software, booking and arranging vacations and<br />
timeshares is easy!<br />
HGVC’s software handles everything from accounting, lead generation, reservations, and loan processing, to<br />
keeping track of the many services offered by the Vacation Club. <strong>Synergy</strong>/<strong>DE</strong> xfODBC enables data access from all<br />
HGVC locations to contribute to the total information package served up to the representative’s monitor screen.<br />
And, thanks to <strong>Synergy</strong>/<strong>DE</strong> xfServerPlus Web enabling technology, HGVC members can access their member<br />
information and book their vacations right on the HGVC Web site!<br />
To pick your next vacation spot, visit the Hilton Grand Vacations Web site today: http://www.hgvc.com/.<br />
30<br />
Rewards are Sweeter with Nectar<br />
Imagine getting rewarded for grocery shopping! If you’re shopping at Sainsburys, Britain’s second largest<br />
supermarkets group, you can. Simply swipe your Nectar card at the checkout stand, and your grocery money will<br />
turn into “loyalty points,” redeemable for a number of valuable and exciting rewards.<br />
Nectar is a reward program that lets you earn points with a variety of sponsors, including the Sainsburys<br />
supermarkets group. Once you’ve collected enough points for the rewards you want, you can redeem them for free<br />
meals, flights abroad, cinema tickets, or even a champagne balloon ride—the choice is yours. You can even use<br />
your points to save money on your next shopping trip at Sainsburys.<br />
Launched in 2002, Nectar already has more than 11 million active users, representing a third of British households.<br />
Nectar uses the <strong>Synergy</strong>/<strong>DE</strong>-built GH-Fulfillment system from Gould Hall to manage a variety of functions<br />
for both consumers and sponsors. When a <strong>customer</strong> decides to exchange his loyalty points for a rewards voucher,<br />
GH-Fulfillment sends out the vouchers. The <strong>Synergy</strong>/<strong>DE</strong>-based application also enables Nectar to coordinate<br />
correspondence on behalf of the reward partners, send out welcome packets to new members, and replace lost or<br />
stolen cards.<br />
The GH-Fullfillment application takes the raw files supplied electronically by Nectar and incorporates them into<br />
a structured database to be used in the fulfillment process and for mail-merge purposes. Utilizing <strong>Synergy</strong>/<strong>DE</strong><br />
xfServerPlus technology, the application can interface with external Post Office files to ensure accurate addressing.<br />
The Nectar card has proven so popular that the number of reward partners is constantly growing. As a result,<br />
Gould Hall has recently been commissioned to develop a “generic” transfer format to incorporate the new partner<br />
rewards into the scheme.<br />
For more information, visit Gould Hall’s (http://www.gouldhall.com/) and Nectar’s (http://www.nectar.com/)<br />
Web sites.<br />
Have an interesting story<br />
about <strong>Synergy</strong>/<strong>DE</strong>?<br />
Tell us about it! Don’t worry,<br />
we’ll do all the writing—just<br />
send your ideas to<br />
mailto:<strong>Synergy</strong>@<strong>Synergex</strong>.com<br />
or give us a call at<br />
+1-800-366-3472 or at<br />
+1-916-635-7300.
Businesscraft<br />
Continued from page 22<br />
Prior to this integration with<br />
Businesscraft financial modules,<br />
Machine Monitor site engineers<br />
were required to fax work order<br />
requests to Machine Monitor,<br />
requiring cumbersome data entry<br />
and often resulting in inaccuracies.<br />
“The <strong>XML</strong> parser was one of the<br />
main reasons we decided to<br />
upgrade to <strong>Synergy</strong>/<strong>DE</strong> 8.1.3. <strong>XML</strong><br />
enables us to streamline processes<br />
for <strong>customer</strong>s such as Machine<br />
Monitor and save them tons of<br />
time,” said Steven Parish, president<br />
of Businesscraft.<br />
Other ways Businesscraft is<br />
using <strong>XML</strong><br />
(Note: The following projects<br />
were completed before the <strong>Synergy</strong><br />
<strong>XML</strong> <strong>API</strong> was available. As a<br />
result, Businesscraft created their<br />
own <strong>XML</strong> output routines to meet<br />
their <strong>customer</strong>s’ needs.)<br />
• Businesscraft is using <strong>XML</strong> in<br />
their Sales Automation software.<br />
This software is used by new homes<br />
sales consultants to help <strong>customer</strong>s<br />
select household options via an ASP<br />
Web page. Whenever a <strong>customer</strong><br />
selects a checkbox for the option<br />
that he wants, the Sales Automation<br />
software stores this information as<br />
<strong>XML</strong> data. <strong>Synergy</strong>/<strong>DE</strong><br />
xfServerPlus enables<br />
Businesscraft’s Sales Automation<br />
software to update this information,<br />
while <strong>Synergy</strong>/<strong>DE</strong> xfODBC enables<br />
the software to download the <strong>XML</strong><br />
data.<br />
• Businesscraft has also<br />
implemented an extensive set of<br />
interfaces to Crystal Reports,<br />
enabling Businesscraft developers<br />
to report on <strong>XML</strong> data. As a result,<br />
users can now view reports with the<br />
Crystal Viewer, publish reports as<br />
PDFs on an intranet, send reports<br />
via e-mail as PDF attachments,<br />
print reports directly to a printer, or<br />
fax reports through Windows NT<br />
Fax Server software—all without<br />
requiring customizations by<br />
Businesscraft developers.<br />
• Businesscraft is currently<br />
developing a new Microsoft .NET<br />
client application, which will<br />
provide an entirely new user<br />
interface to their existing legacy<br />
application. To accommodate the<br />
disconnected nature of the client/<br />
server design, Businesscraft has<br />
decided to integrate <strong>XML</strong> into this<br />
new client application for business-to-business<br />
data transport.<br />
Now, when a dataset is updated on<br />
the client, an <strong>XML</strong> packet is sent<br />
via an xfServerPlus call where the<br />
data is updated in the <strong>Synergy</strong><br />
ISAM files. This allows all of the<br />
new .NET Framework features to<br />
be used in the client user interface,<br />
while still leveraging the extensive<br />
business logic that has evolved<br />
over the past 20 years.<br />
Users of the new Businesscraft<br />
application will also be able to<br />
view Executive Information<br />
Summaries. When the client<br />
application requests such a<br />
summary, routines on the server<br />
read and summarize key data<br />
stored in <strong>Synergy</strong> ISAM files (such<br />
as Overall Debtor Aged Summary,<br />
TopN Customer Sales Figures, and<br />
so forth) and then return that data<br />
to the client, where an <strong>XML</strong>/XSL<br />
transformation is used to present it<br />
as HTML.<br />
For more information about<br />
Businesscraft, visit their Web site.<br />
http://www.businesscraft.com<br />
dabs.com<br />
Continued from page 21<br />
About dabs.com and<br />
<strong>Synergy</strong>/<strong>DE</strong><br />
Originally established in 1990 as<br />
Dabs Direct, a traditional mail order<br />
computer dealer, dabs.com (http://<br />
www.dabs.com) is now the United<br />
Kingdom’s leading Internet retailer<br />
of IT and technology products,<br />
offering approximately 20,000 lines<br />
from the world’s leading manufacturers<br />
to over a million online<br />
<strong>customer</strong>s across the country. Their<br />
<strong>Synergy</strong>/<strong>DE</strong>-based Fulcrum<br />
application enables the processing<br />
of 5,000+ orders each day. Running<br />
on an OpenVMS cluster, Fulcrum<br />
automates the entire process from<br />
allocating stock once an order is<br />
received, accepting credit card<br />
payments, communicating with the<br />
conveyor belt system in the<br />
warehouse, and tracking the item<br />
once shipped.<br />
<strong>Synergy</strong>/<strong>DE</strong> enables companies<br />
like dabs.com to deploy multiplatform,<br />
Web-enabled applications<br />
that integrate with e-commerce<br />
solutions, ODBC-enabled reporting<br />
tools, RDBMSs, ActiveX components,<br />
wireless devices, and other<br />
third-party applications and data.<br />
<strong>Synergy</strong>/<strong>DE</strong> has a long track record<br />
backed by millions of end-users<br />
worldwide, and a substantial<br />
presence in a multitude of vertical<br />
industries.<br />
JPD<br />
Continued from page 22<br />
and application management it provides. There are several rules and regulations<br />
that apply to the assignment of teachers and staff—and these rules<br />
change frequently. Terminal Services will allow my client to better accommodate<br />
these types of fluctuations.” Terminal Services will also help handle<br />
variances in staff size at a given remote location. The number of employees<br />
at a given location can vary tremendously from day to day, making Terminal<br />
Services an ideal solution.<br />
The ROC plans to go live with the <strong>Synergy</strong>/<strong>DE</strong>-based application in Q2 of<br />
2004. “This new solution will offer them a more flexible and manageable<br />
database structure, with centralized data that is available at any time to<br />
whomever needs it,” promises van Dijk. “And, most importantly, we can<br />
provide all of these enhancements without sacrificing the core functionality<br />
of their proven application.”<br />
31
2330 Gold Meadow Way<br />
Gold River, CA 95670<br />
U.S.A.<br />
inside CONNECTION<br />
<strong>Synergex</strong> releases <strong>Synergy</strong>/<strong>DE</strong> 8.1<br />
(February 2003)<br />
page 1<br />
Where in the World is <strong>Synergy</strong>/<strong>DE</strong> Now? 2<br />
xfODBC enhances AgTrax Software 3<br />
The <strong>Synergy</strong> Configuration Program 6<br />
<strong>Synergy</strong> <strong>XML</strong> <strong>API</strong>: A <strong>customer</strong> success<br />
story<br />
Unleash the power of your <strong>Synergy</strong><br />
application at SPC 2004!<br />
page 1<br />
page 28<br />
Fcompare: Resolving your database problems 7<br />
Support Center 8<br />
Vasco launches e-commerce site 14<br />
Radley Corp. Web system streamlines tasks 15<br />
Jack Henry upgrades to <strong>Synergy</strong>/<strong>DE</strong> 8.1 17<br />
Turnkey’s tkEDGE system uses xfODBC 19<br />
and much more...<br />
A Publication for Professional Developers and Users