Rockwell
Software
OPC Test
Client Application
Version 1.1
User Manual
Table of Content
INTRODUCTION............................................................................................................................ 3
LICENSE........................................................................................................................................ 4
GETTING STARTED...................................................................................................................... 6
SETTING UP THE SERVER.............................................................................................................. 6
CONNECTING TO THE SERVER........................................................................................................ 6
ABOUT THE SERVER VIEW............................................................................................................. 7
CREATING A GROUP...................................................................................................................... 7
CONNECTING TO AN ITEM.............................................................................................................. 9
REMOVING AN ITEM..................................................................................................................... 10
REMOVING A GROUP................................................................................................................... 10
DISCONNECTING FROM A SERVER................................................................................................ 10
IN DEPTH LOOK AT FUNCTIONALITY.......................................................................................11
SERVER OBJECT......................................................................................................................... 11
GROUP OBJECT.......................................................................................................................... 12
ENUMOPCITEMATTRIBUTES OBJECT........................................................................................... 14
ADVANCED MECHANISMS........................................................................................................ 15
MMI EMULATION MODE............................................................................................................... 15
GROUP EVENTS.......................................................................................................................... 16
LOG VIEWER............................................................................................................................... 18
ITEM VIEW COLUMNS.................................................................................................................. 19
FILE MANAGEMENT................................................................................................................... 21
OPENING A FILE.......................................................................................................................... 21
EDITING THE CSV FORMAT FILE.................................................................................................. 21
THE FILE FORMAT FOR THE TEST CLIENT.....................................................................................21
INDEX........................................................................................................................................... 25
I NTRODUCTION
Rockwell Software has provided this program for the purpose of testing OLE for
Process Control (OPC). Specifically, this clients primary focus is to test the
implementation of the 1.0a specification on servers created with the RSServer OPC
Toolkit. The goal for this program will be to use the entire OPC interface and
enable the user to test their server for compliance to the spec.
This manual will detail the functional behavior of the RSOPC Test Client,
specifically with regards to its implementation of the OPC 1.0a version of the
specification. At the time of writing, the RSOPC Test Client only implements the
required interfaces from the OPC 1.0a specification.
This manual assumes minimal familiarity with OPC. It is not intended to be a
rewrite of the OPC specification.
This is an additional tool for the RSServer OPC Toolkit. It is not redistributable or
transferable. Please refer to your license agreement in your toolkit documentation
for more information on redistributable files.
L ICENSE
GRANT OF LICENSE
Rockwell Software Inc. ("RSI") and its third party licensors grant to you a non-exclusive license to install and
use the software programs in this package (collectively referred to as the "Software") on either: (a) a single
computer, or (b) a network server for access by one user, by way of terminal or computer attached to the
network server. Should you choose to install the Software on additional computers, or increase user access
via a network server, you must first acquire a license for each additional user who will use the Software, with
the understanding that at any one point in time (and regardless of the number of media sets included with the
Software), the number of users who are permitted to use the Software may not exceed the number of singleuser licenses you have acquired.
If this Software is an upgrade from a previous version of an RSI product, you may not transfer the prior
version to another user. This Agreement supersedes any prior license with respect to your use of the
Software.
Any attempted sublicense, rental, sale, or lease of the Software is prohibited. However, you may transfer your
rights to use the Software on a permanent basis, provided: (1) you transfer this Agreement, the Software, and
all accompanying written materials and retain no copies; (2) the recipient agrees to the terms of this
Agreement; and (3) you first notify RSI in writing of the date of transfer and the recipient's full name and
address. This Agreement will automatically terminate without notice to you if you fail to comply with its
terms.
The Software and the accompanying documentation are copyrighted. Unauthorized copying, reverse
assembly, reverse engineering, decompilation, and creating derivative works based on the Software are
prohibited. You may not make copies of the Software except that you may install the Software into permanent
memory of a single storage device provided you keep the original media solely for backup or archival
purposes. You may not copy the accompanying documentation. Ownership and title to the Software is
retained by RSI or its licensors, as applicable.
You may not use this software to develop a software product that configures or communicates to any
Rockwell Automation Network Product or any Rockwell Automation Devices, including but not limited to
Programmable Controllers, I/O Devices / Systems, Numerical Controllers, Motion Controllers, and Operator
Interface Devices.
LIMITED WARRANTY
The Software is warranted for ninety days after it is delivered to you that it will conform with the
accompanying documentation supplied by RSI at the time of delivery. Defective media will be replaced
without charge if returned during the warranty period. This warranty shall be void if you attempt to modify
the Software. RSI makes no representation or warranty, express or implied, that the operation of the Software
will be uninterrupted or error free, or that the functions contained in the Software will meet or satisfy your
intended use or requirements; you assume complete responsibility for decisions made or actions taken based
on information obtained using the Software.
THE LIMITED WARRANTY IN THIS AGREEMENT IS IN LIEU OF ALL OTHER WARRANTIES,
EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. ROCKWELL SOFTWARE INC.
AND ITS LICENSORS SHALL NOT BE LIABLE FOR DAMAGES, INCLUDING ANY LOST PROFITS,
LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF
YOUR USE OR INABILITY TO USE THE SOFTWARE, EVEN IF RSI OR ITS RESELLER HAVE BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
This warranty gives you specific legal rights, and you may also have other rights which vary from jurisdiction
to jurisdiction. Some jurisdictions do not allow the exclusion or limitation of liability for incidental or
consequential damages, or the exclusion of an implied warranty, so the above limitation or exclusion may not
apply to you.
LIMITATION OF REMEDIES
RSI's entire liability and your exclusive remedy shall be:
1. The replacement of the Software not meeting the Limited Warranty specified above which is returned with
proof of purchase; or
2. If RSI is unable to deliver replacement Software which meets the Limited Warranty specified above, RSI or
its reseller will refund your purchase price. IN NO EVENT SHALL RSI's LIABILITY TO ANY PARTY
EXCEED THE PURCHASE PRICE OF THE SOFTWARE.
OTHER PROVISIONS
This Agreement shall be governed by the laws of the State of Wisconsin. This Agreement is the complete and
exclusive agreement between RSI and you, and supersedes all prior agreements, whether written or oral,
relating to the Software provided in this package and the accompanying documentation. This Agreement may
not be changed or modified except by an instrument in writing signed by a duly authorized representative of
RSI.
