Omron CX-SUPERVISOR SCRIPT REFERENCE

Cat. No. W10E-EN-01

Software Release 2.0

CX-Supervisor

USERS MANUAL

CX-Supervisor

User Manual

Software Release 2.0

OMRON	CX-Supervisor – User Manual

Notice

OMRON products are manufactured for use according to proper procedures by a qualified operator and only for the purposes described in this manual.

The following conventions are used to indicate and classify precautions in this manual. Always heed the information provided in them. Failure to heed precautions can result in injury to people or damage to the product.

DANGER! Indicates information that, if not heeded, is likely to result in loss of life or serious injury.

WARNING Indicates information that, if not heeded, could possibly result in loss of life or serious injury.

Caution Indicates information that, if not heeded, could result in relatively serious or minor injury, damage to the product, or faulty operation.

OMRON Product References

All OMRON products are capitalised in this manual. The word “Unit” is also capitalised when it refers to an OMRON product, regardless of whether or not it appears in the proper name of the product.

The abbreviation “PLC” means Programmable Logic Controller and is not used as an abbreviation for anything else.

Revision 2.0

Page i

CX-Supervisor – User Manual	OMRON

Page ii

Revision 2.0

OMRON	CX-Supervisor – User Manual

Visual Aids

The following headings appear in the left column of the manual to help you locate different types of information.

Note:	Indicates information of particular interest for efficient and convenient
	operation of the product.
1, 2, 3…	Indicates lists of one sort or another, such as procedures, checklists etc.
	Represents a shortcut on the Toolbar to one of the options available on the
	menu of the same window.
	Indicates a program must be started, usually by clicking the appropriate
	option under the standard Windows ‘Start’ button.

OMRON, 2007

All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form, or by any means, mechanical, electronic, photocopying, recording, or otherwise, without the prior written permission of OMRON.

All copyright and trademarks acknowledged.

No patent liability is assumed with respect to the use of the information contained herein. Moreover, because OMRON is constantly striving to improve its high-quality products, the information contained in this manual is subject to change without notice. Every precaution has been taken in the preparation of this manual. Nevertheless, OMRON assumes no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained in this publication.

Revision 2.0

Page iii

CX-Supervisor – User Manual	OMRON

Page iv

Revision 2.0

OMRON CX-Supervisor – User Manual

About this Manual

This manual describes the CX-Supervisor application and its ability to create, modify and run SCADA applications.

This manual contains the following:

Chapter 1 - Graphics Editor. This chapter describes the Graphics Editor and its various tools and controls.

Chapter 2 - Pages. This chapter describes the procedures involved in the creation and amendment of pages.

Chapter 3 - Points. This chapter describes the procedures involved in the creation, amendment and removal of points. The use of PLCs with points is also described.

Chapter 4 - Objects. This chapter describes procedures involved in the creation, amendment and removal of objects.

Chapter 5 - ActiveX Objects. This chapter provides an overview of using ActiveX objects in CXSupervisor.

Chapter 6 - Projects. This chapter describes procedures involved in the creation, amendment and removal of projects.

Chapter 7 - Graphics Library. This chapter describes the library of graphic objects and how to create and amend new libraries.

Chapter 8 - Alarms. This chapter describes the procedures involved in the creation and amendment of alarms.

Chapter 9 - Animation. This chapter describes the use of animations and how they can be applied to a CX-Supervisor project.

Chapter 10 - Recipes. This chapter describes the creation of recipes, and how they can be used.

Chapter 11 - Data Logging. This chapter describes the data logging facilities, including setting up, viewing and exporting

Chapter 12 - Databases. This chapter describes the Database facilities, including connections reading and writing data.

Chapter 13 - Multilingual Features. This chapter describes the Multilingual features, including creation of dynamically switching applications.

Chapter 14 - OPC Client. This chapter introduces OPC Server to a new user, and explains how to use CX-Supervisor as an OPC Client

Revision 2.0

Page v

CX-Supervisor – User Manual	OMRON

Chapter 15 - Connecting to a Remote CX-Supervisor application. This chapter explains how to create a distributed solution by connecting together CX-Supervisor applications on networked PCs.

Chapter 16 - Connecting to Omron Industrial Components. This chapter details connecting CXSupervisor to Omron's Industrial Components.

Chapter 17 – Best Practices. This chapter details the best practices to get the most from CXSupervisor including how to plan and design your application.

Appendix A – Configuring a PC for remote connection. The appendix explains how to configure a PC for remote connection.

Appendix B – Frequently asked questions. The appendix list some FAQs, and of course their answers.

Appendix C – Troubleshooting. The appendix is a guide to troubleshooting and resolving problems.

Appendix D – CX-Server error codes. The appendix lists the error codes from the communication software, CX-Server, and their meanings.

Appendix E – Using with the Omron DyaloX. The appendix lists information when using with the Omron’s DyaloX Industrial PC.

Appendix F – Obsolete Features. The appendix details obsolete features for backwards compatibility only.

A Glossary of Terms and Index are also provided.

Page vi

Revision 2.0

OMRON	CX-Supervisor – User Manual
TABLE OF CONTENTS
CX-Supervisor ..................................................................................................	Page
Chapter 1 - Graphics Editor..........................................................	1
About the Graphics Editor ......................................................................................	1
Palette ....................................................................................................................	1
Graphic Object Bar.................................................................................................	4
Control Bar .............................................................................................................	4
Status Bar...............................................................................................................	8
Text Bar ..................................................................................................................	9
Grid.......................................................................................................................	11
Chapter 2 - Pages..........................................................................	13
Creating a Page....................................................................................................	13
Amending a Page.................................................................................................	14
Defining the Properties of a Page ........................................................................	14
Printing a Page .....................................................................................................	16
Saving a Page to a Project...................................................................................	20
CX-Supervisor Preferences..................................................................................	20
Chapter 3 - Points.........................................................................	23
What is a Point? ...................................................................................................	23
About the Point Editor ..........................................................................................	23
Viewing Points via the Point Editor.......................................................................	24
Creating a Point....................................................................................................	27
Amending an Existing Point .................................................................................	33
Deleting an Existing Point ....................................................................................	34
Quick creation of many points ..............................................................................	35

Revision 2.0

Page vii

CX-Supervisor – User Manual	OMRON

Page viii

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents chapter 3 continued	Page
Runtime Point Maintenance .................................................................................	36
Point Import .........................................................................................................	37
System Points.......................................................................................................	38
Printing Points ......................................................................................................	41
Chapter 4 - Objects ......................................................................	45
Objects .................................................................................................................	45
Editing Objects .....................................................................................................	45
Creating and Editing Graphic Objects..................................................................	44
Creating and Editing Control Objects...................................................................	48
Manipulating Objects............................................................................................	63
Chapter 5 – ActiveX Objects.......................................................	69
Overview...............................................................................................................	69
Inserting a new object ..........................................................................................	69
Editing Properties at Design Time........................................................................	70
Reading and Writing Properties at Run Time.......................................................	72
Calling Methods at Run Time...............................................................................	72
Responding to Events ..........................................................................................	72
Chapter 6 - Projects......................................................................	75
Overview...............................................................................................................	75
Creating a Project.................................................................................................	75
Amending a Project ..............................................................................................	76
Saving a Project ...................................................................................................	76
Printing a Project ..................................................................................................	77
Device Configuration ............................................................................................	77
Settings.................................................................................................................	83
Runtime Settings ..................................................................................................	84
Runtime Security ..................................................................................................	91

Revision 2.0

Page ix

CX-Supervisor – User Manual	OMRON

Page x

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents chapter 6 continued	Page
Exit Level ..............................................................................................................	97
Compiling and Running a Project.........................................................................	95
Save Runtime As..................................................................................................	98
Create Runtime Install Disc..................................................................................	98
Project Information ...............................................................................................	99
Alias Definitions ....................................................................................................	99
Find.....................................................................................................................	100
Navigating Projects with the Workspace............................................................	101
Project Editor ......................................................................................................	101
Printing from the Project Editor ..........................................................................	104
Chapter 7 - Graphics Library ...................................................	105
Overview.............................................................................................................	105
Graphics Library .................................................................................................	105
Manipulating Objects..........................................................................................	107
Printing the Graphics Library..............................................................................	109
Chapter 8 - Alarms.....................................................................	111
What is an Alarm? ..............................................................................................	111
Alarm Settings ....................................................................................................	111
Viewing the Contents of the Alarm Database ....................................................	113
Creating a New Alarm ........................................................................................	114
Updating an Existing Alarm ................................................................................	118
Copying an Existing Alarm Definition .................................................................	119
Deleting an Existing Alarm .................................................................................	119
Printing Alarms ...................................................................................................	119
Alarm Reporting In Runtime ...............................................................................	120

Revision 2.0

Page xi

CX-Supervisor – User Manual	OMRON

Page xii

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents chapter 8 continued	Page
Chapter 9 - Animation ...............................................................	123
Associating Points with Actions and Events.......................................................	123
Animation Editor .................................................................................................	123
Runtime Actions .................................................................................................	129
Chapter 10 - Recipes ..................................................................	157
What is a Recipe? ..............................................................................................	157
Recipe Components...........................................................................................	157
Viewing Recipes in the Recipe Editor ................................................................	158
Creating a New Recipe ......................................................................................	160

Revision 2.0

Page xiii

CX-Supervisor – User Manual	OMRON

Page xiv

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents chapter 10 continued	Page
Updating an Existing Recipe ..............................................................................	162
Copying an Existing Recipe Definition ...............................................................	164
Deleting an Existing Recipe ...............................................................................	164
Recipe Security Levels.......................................................................................	164
Printing Recipes .................................................................................................	165
Using Recipes in Runtime ..................................................................................	166
Chapter 11 - Data Logging ........................................................	171
What is Data Logging? .......................................................................................	171
Data Log Editor...................................................................................................	171
Data Logging at Runtime...................................................................................	176
Data Log View Component ................................................................................	180
Remote Data Log Viewer ...................................................................................	181
Data Log Export Facilities ..................................................................................	182
Data Logging ......................................................................................................	184
Chapter 12 - Databases ..............................................................	189
Overview.............................................................................................................	189
Database Connection Editor ..............................................................................	189
Configuring a connection....................................................................................	190
Configuring Recordsets......................................................................................	197
Configuring Field Associations ...........................................................................	199
Configuring Parameter Associations..................................................................	201
Configuring Schemas .........................................................................................	202
Using Transactions.............................................................................................	206
Saving Recordsets as XML ................................................................................	207
Datashaping .......................................................................................................	207

Revision 2.0

Page xv

CX-Supervisor – User Manual	OMRON

Page xvi

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents		Page
Chapter 13 – Multilingual features...........................................		213
Development Features .......................................................................................		213
Runtime Language Features..............................................................................		214
Runtime Mulitlingual Features............................................................................		215
Configuring Windows for Language Support .....................................................		218
Data Log Viewer .................................................................................................		222
Adding Unsupported Runtime Languages .........................................................		222
Popup Keyboard Layout.....................................................................................		223
Chapter 14 – Using CX-Supervisor as an OPC Client ...........		225
An Overview of OPC? ........................................................................................		225
Using CX-Supervisor with OPC Servers ............................................................		230
Using with Omron’s CX-Server OPC .................................................................		235
Chapter 15 – Connecting to Remote Applications ..................		237
Two Tier, Client-Server or Master-Slave?..........................................................		237
Peer to Peer .......................................................................................................		238
Distributed Server...............................................................................................		238
Redundant Server ..............................................................................................		239
Creating a CX-Supervisor Server application ....................................................		239
Creating a CX-Supervisor Client application......................................................		239
Chapter 16 – Connecting to Omron Industrial Components. 243
Adding a Point linked to a parameter .................................................................		243
Chapter 17 – Best Practices.......................................................		249
Design ................................................................................................................		249
Performance .......................................................................................................		250
Points..................................................................................................................		253
Drawing ..............................................................................................................		254
Scripts.................................................................................................................		255
Data Logging ......................................................................................................		256

Revision 2.0

Page xvii

CX-Supervisor – User Manual	OMRON

Page xviii

Revision 2.0

OMRON	CX-Supervisor – User Manual
Table of Contents Appendices		Page
Appendix A – Configuring a PC for remote connection ........		259
Configurating a Client PC running Windows XP Service Pack 2 .......................		259
Configurating a Client PC running Windows XP ................................................		260
Configurating a Client PC running Windows NT or 2000...................................		260
Configurating a Server PC running Windows XP Service Pack 2......................		260
Configurating a Server PC running Windows XP...............................................		261
Configurating a Server PC running Windows NT or 2000	.................................	261
Appendix B – Frequently asked questions...............................		266
Appendix C – Troubleshooting .................................................		297
Appendix D – CX-Server error codes.......................................		305
Appendix E – Using with the Omron DyaloX..........................		309
Appendix F – Obsolete Features ...............................................		311
Glossary of Terms.......................................................................		329
Index.............................................................................................		337

Revision 2.0

Page xix

OMRON	CHAPTER 1 – Graphics Editor

CHAPTER 1

Graphics Editor

This chapter describes the Graphics Editor and the various tools and controls available. It also provides instructions for using these tools and controls and is supported with suitable screen displays.

About the Graphics Editor

The Graphics Editor enables a variety of objects to be created on a page. Supported objects are:

♦Graphical objects.

♦Control objects.

♦ActiveX objects.

Graphical objects are geometric shapes, for example ellipses and polygons, but also include Text objects. Control objects allow information to be displayed and entered in clear way through the use of Wizards. Examples of control objects include Pushbuttons and Trend Graphs. ActiveX objects or controls are from sources external to CX-Supervisor.

Refer to chapter 4, Objects for further information regarding control objects and bitmap objects. Refer to chapter 5 for further information on ActiveX Objects.

The tools are contained on a Control Bar, and within palettes. The palettes allow all similar types of tool to be kept together, and are contained within a free floating window. The various tools and palettes are discussed in the following chapters. Status and help information is presented in a Status Bar located at the bottom of the main CX-Supervisor window.

Palette

The Palette is always displayed on top of any pages created within CX-Supervisor. If no pages are open, the Palette is not displayed, and if there are no currently active pages, the Palette is rendered inactive. An example of the Palette illustrating the position of various palettes and controls is shown below:

Revision 2.0

Page 1

CHAPTER 1 – Graphics Editor	OMRON

The Palette can be removed or re-displayed at any time by selecting Palette from the View menu.

A tick next to the name indicates the Palette is currently displayed. CX-Supervisor saves the settings when it is exited and restores them when it is next run.

Each of the palettes and controls is discussed in more detail in the following paragraphs.

Colour Palette

To create an object in a particular colour: before selecting the object’s tool from the Graphic Object bar, first select the colour by clicking in the appropriate square in the Colour Palette.

Note: It is not strictly necessary to select a colour for an object before creating it, however if no colour selection is made, the object retains the same colour as the last object.

To apply a colour to a previously created object, select the object on the page and click with the left mouse button in the appropriate square in the Colour Palette.

Note: Colour may only be applied to some graphic objects. It cannot be applied to embedded objects or bitmap graphics.

Line Style Palette

The Line Style Palette is located in the Palette just below the Colour Palette.

To create an object with a particular line style: before selecting the object from the Tool Palette, first select the line style by clicking on the appropriate line in the Line Style Palette.

Note: It is not strictly necessary to select a line style for an object before creating it, however if no line style selection is made, the object retains the default style of thin solid.

To apply a line style to a previously created object, select the object on the page and click on the appropriate line in the Line Style Palette.

Note: Line styles may only be applied to some graphic objects. They cannot be applied to text, embedded objects, controls or bitmap graphics.

Page 2

Revision 2.0

OMRON	CHAPTER 1 – Graphics Editor

Fill Pattern Palette

The Fill Pattern Palette is located at the bottom of the Palette.

To create an object with a particular fill pattern: before selecting the object’s tool from the Tool Palette, first select the fill pattern by clicking in the appropriate square in the Fill Pattern Palette.

Note: It is not strictly necessary to select a fill pattern for an object before creating it, however if no fill pattern selection is made, the object retains the default of no pattern.

To apply a fill pattern to a previously created object, select the object on the page and click in the appropriate square in the Fill Pattern Palette. With a fill pattern applied to an object, clicking in the Colour Palette with the left mouse button allows the foreground colour of the chosen fill pattern to be changed. Clicking in the Colour Palette with the right mouse button allows the background colour of the chosen fill pattern to be changed.

Note: Fill patterns may only be applied to solid graphic objects. They cannot be applied to unfilled graphic objects, text objects, embedded objects, controls or bitmap graphics.

Extended Colour, Line Style and Fill Pattern Palette

Each of the Colour, Line Style and Fill Pattern Palettes may be extended to allow access to more choices. Only one palette may be extended at any one time. The Extended Selection tools are located at the top of the Palette and are illustrated as follows:

The left hand square controls the extension of the Colour Palette; the line between the two squares controls the Line Style Palette extension, and the right hand square control the Fill Pattern Palette extension.

An example of the Extended Colour, Line Style, and Fill Pattern Palettes is shown below:

The operation of each of the extended palettes is identical to that of the non-extended palettes.

Revision 2.0

Page 3

CHAPTER 1 – Graphics Editor	OMRON

Graphic Object bar

The Graphic Object bar contains the tools to create the graphic objects which can be placed on pages within CX-Supervisor.

In general terms, the operation of the Graphic Object bar is simple. With a page active the Graphic Object bar is active, and operation involves merely clicking on the desired tool to select it, and then clicking and dragging to the appropriate point in the page. This is not the case with the text, polygon or polyline tools, however the operation of these tools is fully discussed in chapter 4, Objects.

Moving the mouse pointer over any of the tools causes CX-Supervisor to display a tooltip to describe the tool.

By default, the cursor returns to Selection mode (an arrow) after drawing an object. If you would prefer it to remain in its current state, clear the Return to select mode checkbox in the Editing Preferences dialog, which is found on the CX-Supervisor file menu.

For further details concerning the tools contained within the Graphic Object bar refer to chapter 4, Objects.

Control Bar

CX-Supervisor provides a Control Bar containing formatting and object manipulation tools. The Control Bar can be activated or de-activated from the View menu. To activate the Control Bar, select Control Bar from the View menu; CX-Supervisor places a check mark next to it signifying its active status. To de-activate it, repeat the procedure (the check mark is removed), and the Control Bar is no longer displayed. The various tools on the control bar allow the properties of objects to be modified.

A control may be activated with more than one object selected to change a particular attribute of all of the selected objects, e.g. when all graphical objects on a page are selected and the Rotate button is pushed in and the desired angle specified, all selected objects are rotated.

An illustration of the Control Bar is as follows:

The Control Bar may vary slightly from this according to the display resolution currently in use - the number of buttons displayed depends on the available space - at higher resolutions more buttons are displayed.

The Control Bar can be removed from the display at any time by selecting Control Bar from the View menu.

Page 4

Revision 2.0

OMRON	CHAPTER 1 – Graphics Editor

A tick next to the name indicates that it is currently displayed. CX-Supervisor saves the settings when it is exited and restores them when it is next run.

The specific operation of the controls on the Control Bar is described in the following paragraphs.

Object Identification

When an object is created, CX-Supervisor gives it a unique identifier. This identifier consists of the object type and a sequential number (starting at 1). For example, a text object could have an identifier of TEXT_1; a polygon object could have an identifier of POLYGON_3 etc. The Object Identification field displays a list of all current objects on a page.

The identification of an object can be changed by clicking on the entry in the Object Identification control, typing over the entry and pressing <Return>. A confirmation box is provided to double check the operation, click the OK pushbutton to proceed with the name change or the Cancel pushbutton to abort the operation.

It can at times be difficult to select a particular object if it is mostly obscured by other graphic objects. The Object Identification control allows an object to be selected by simply selecting its name from the presented list. Click on the arrow button to display the list and select the desired object. On selection the object is highlighted.

The following illustration shows the Object Identification control in de-selected state:

The following illustration shows the Object Identification control in selected state:

Raise Up One

The Raise Up One button allows an object which forms part of an overlapping group of objects to be moved nearer the top of the group, one layer at a time. With an object selected, clicking the pushbutton once moves the object up one layer. This continues until the object is at the top. Clicking the pushbutton with the object at the top of a group has no effect.

The following example illustrates the state of a group of two objects before and after clicking the Raise Up One button with the black round rectangle selected:

Revision 2.0

Page 5

CHAPTER 1 – Graphics Editor	OMRON

Before

After

Lower Down One

The Lower Down One button allows an object which forms part of an overlapping group of objects to be moved nearer the bottom of the group, one layer at a time. With an object selected, clicking the button once moves the object down one layer. This continues until the object is at the bottom. Clicking the button with the object at the bottom of a group has no effect.

The following example illustrates the state of a group of two objects before and after clicking the Lower Down One button with the grey polygon selected:

Before

After

Rotate

The Rotate button allows graphical and bitmap objects to be rotated. With an object selected, clicking the button once opens the Rotate dialog box. Set the desired angle and click the OK pushbutton to rotate the object.

The following example illustrates the state of an object before and after clicking the Rotate button and defining a 10° rotation with the object selected:

Page 6

Revision 2.0

OMRON	CHAPTER 1 – Graphics Editor

Before

Rotated 10°

Horizontal Mirror

The Mirror Horizontal button on the Control Bar allows graphical and bitmap objects to be mirrored in the horizontal plane. With an object selected, clicking the button once “flips” the object producing a horizontal mirror image.

The following example illustrates the state of an object before and after clicking the Mirror Horizontal button with the object selected:

Before

After

Vertical Mirror

The Mirror Vertical button allows graphical and bitmap objects to be mirrored in the vertical plane. With an object selected, clicking the button once “flips” the object producing a vertical mirror image.

The following example illustrates the state of an object before and after clicking the Mirror Vertical button with the object selected:

Before

After

Transparency On/Off

The Transparency button changes an object from solid to outline and from outline to solid. With an object selected, click the button and the object toggles from solid to outline (or vice-versa).

Revision 2.0

Page 7