Wizcon Quick Guide
Wizcon Quick Guide
TM
Quick Guide
Warranty/Trademarks
"This document is for information only and is subject to change without prior notice. It does not represent
a commitment on the part of Wizcon Systems. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying or recording, for any
purpose, without written
permission from Wizcon Systems Inc.
If you find any problems in the documentation, please report them in writing. Wizcon Systems Inc. does
not warrant that this documentation is error-free.
1986-2007 Wizcon Systems
All rights reserved. Wizcon, Wizcon Systems, Wizcon Agents, Wizcon Supervisor, Wizcon Hypervisor, Wizcon for Windows & Internet, WizScheduler, WizAAM, WizPLC, WizOPC, WizSQL, WizReport
XL, WizCAD and WizAudit are trademarks or registered trademarks of Wizcon Systems. Wizcon Premium Maintenance, Wizcon Hotline Plus, Wizcon eXpert Program, Wizcon Hosted Services, Wizcon
Collaborate, Wizcon Trace, Wizcon Certified, Wizcon SI Environment, and Wizcon VIPartners are service marks of Wizcon Systems. BACnet is a registered trademark of ASHRAE. All other trademarks
are either property of Wizcon Systems or property of their respective owners.
DRS00930WCU-2-EN
ELUTIONS Inc.
1300 East 8th Avenue
Suite 200
Tampa, FL 33605
USA
tel +1 (813) 371-5500
fax +1 (813) 371-5501
www.wizcon.com
Wizcon Systems BV
Concordiaweg 149-151
Postbus 351
NL-4200 AJ Gorinchem
Nederland
tel +31 (0)183 646 303
fax +31 (0)183 621 601
This Quick Guide can be used as a short introduction to the application. It guides you
through the elementary stages of installing the application and building a basic project.
A short description of each module in the application appears in the Terminology section
at the end of the book.
When installing the application you can select to download the Wizcon for Windows and
Internet User Guide which is the applications complete User Guide manual. Or,
alternatively, you can order a hard copy of the manual through your supplier.
Wizcon Systems
Customer Support
You can receive technical support from your local distributor. To receive prompt
support, make sure that you complete the registration form and send it to Wizcon
Systems Inc., or register online at : http://www.wizcon.com
The following E-mail address and fax number can be used to contact our support offices:
Wizcon Systems
Activating macros
System Requirements
Before you install the application verify that you have the following:
Hardware
Hard Disk: 500MB minimum free (recommended 3Gb). This is required for both
installing the program and for later developing an application
Monitor: Resolution 800X600 or higher. If you are using the Scheduler then for
optimized view you require a resolution of 1024X768
Display: VGA, SVGA, or any graphic adaptor that supports the operating system
desktop. The display should be set at 256 colors or higher and the screen resolution
should be set at 800 x 600 or higher
Wizcon Systems
Software
Web server: A web server is required for publishing the application. Wizcon
recommends MS IIS.
Browser: Microsoft Internet Explorer 6 SP1 (or higher) and virtual machine.
Java 1.1 enabled browser with SUN JAVA plug-in version 1.4 (recommended
1.5.0_06).
A web server. For example, the Microsoft Internet Information Server that can be
downloaded from the Microsoft web site
Note: In this manual the names WizSQL, WizLanguage, WizDDE and WizDDES have
been named: Application SQL, Application Language, Application DDE and
Application DDES. When writing code substitute the word application for Wiz.
Installation
It is strongly recommended that you close and exit all Windows programs before running
the installation procedure.
To install the application:
1. Insert the CD-ROM into the CD-ROM drive. The Wizcon Supervisor Welcome
window is displayed.
Wizcon Systems
Installation 5
3. Click Yes and then Yes again to accept the Agreements. The Setup dialog box opens
enabling you to either accept the Destination Folder location or to Browse and
define a different location where the program will be saved.
4. Click Next to open the Setup Type dialog box.
Typical
Custom
5. Make your selection and then click Next to open the Language Selection dialog box.
6. Click the arrow and select the relevant language and then click Next to open the
Select WizPLC Version dialog box.
Wizcon Systems
Installation 7
7. Select either WizPLC 3.0 (strongly recommended) and WizPLC 2.11 (to use only if
backward compatibility is needed) and then click Next. The whole WizPLC
installation process will follow till the end.
8. The Shortcut Configuration message opens on your screen. To create the Quick
Launch Toolbar click Yes or No not to.
9. The Finish Reboot dialog box opens. Select either Yes to restart your computer or
No not to and then click the Finish button to exit the setup program.
Previous Versions
If you have a previous version of the system installed a message box opens reminding
you to uninstall it.
If you have a different version of CoDeSys installed (upon which WizPLC is based), you
will have the option to leave it untouched and not install the version supplied with the
installer.
Wizcon Systems
Installation 9
1. Click the Start button on your desktop, point to Settings and then click on Control
Panel. The Control Panel folder is displayed.
2. Double-click on the Add/Remove Programs icon. The Add/Remove Program
Properties dialog is displayed.
3. Select the application from the list of available programs and click the Add/Remove
button. The Modify or Remove Program dialog box opens.
4. Make your selection and then click Next to actually uninstall the program from your
computer.
5. A message opens on your screen reminding you to restart your computer. Click Yes
to restart your computer now or No not to.
It is recommended that you restart your computer after uninstalling the program.
Note: It is strongly recommended that a personal web server or IIS be installed on the
computer prior to installation. If the above software components are not installed a
dialog box opens informing you that Setup has detected that the version of Internet
Information Server or Personal Web Server required have not been installed. Click Yes
to exit system setup so that you can install the missing IIS or PWS or No not to.
To create a shortcut to your application (without going through the Project
Wizard):
1. Right-click on your desktop, and select New from the popup menu.
2. Select Shortcut from the popup menu. The Create Shortcut dialog box is displayed.
10
3. Type the location and name of your application (*.Wpj) or search for the application
by clicking on the Browse button.
4. Click Next and select a name for the shortcut.
5. Click Finish to complete the operation.
Click on the Start button on your desktop, point to Programs, to Wizcon Supervisor and
then to the application. Click on the application to open the Studio.
Or,
Double click on the shortcut application icon on your desktop. The Quick Access Bar
opens on your computer.
Load Layout
Capture Layout
Load Image
Wizcon Systems
Load Chart
Load Recipe
Save Recipe
Multiple Tags
Single Tag
WizPLC Development
WizPLC Runtime
Users Timetable
Shift Management
Users/Groups
12
Scheduler Configuration
Application Studio
Wizcon Systems
Application Studio 13
All Containers
Control Panel
A menu bar through which you can access application operational menus.
A toolbar that enables quick access to the Application Studio most frequently used
functions.
A status bar showing the number of tags and alarms in the application.
Toolbar
Open application
Save application
Add Tag
14
Wizcon Systems
Application Studio 15
User Management lists all the users and groups defined in a project. This module
also defines the user's access permission and level. Access can be given per user,
group and team. Backup users can also be defined. User Management also enables
the System Integrator to create a user timetable and schedule workplans. For further
details see User Management on page 86.
Web Application contains the elements that are used to publish an application, such
as HTML pages for the Image, Events Summary Profile, and Trend Profiles. See
page 87, and page 90.
Files contain the elements that are stored as files, such as: Images, Events
Summaries, Charts, History Viewer, Model Recipes, Layouts and Reports. See
page 90, page 87, page 91 and page 92.
Objects holding the elements that are stored as objects, such as: Tags and Alarms.
See page 93 and page 95.
Right clicking on a container opens a popup menu that displays related options.
16
you to set up or modify the add-on and programs that run when
starting this application. See page 38.
Macros are shortcuts that can be used to execute pre-defined
Wizcon Systems
Application Studio 17
programs with the powerful language constructs of the IEC 611313 standard. WizPLC Runtime is used when running the
application. See page 81.
Tag Filters - The Tag Filter module is used to filter, view and
they are printed out or written to the Event Summary. See page 82.
Printer Targets - A Printer Target is a collection of predefined
filters and printers specifying the conditions under which the
targeted printer is activated. See page 82.
Zone Navigator - The Zone Navigator is a global, multi-image
18
Menu Options
Option
Action
File
New
Open
New Application
Open Application
Save
Save As
Exit
Toolbar
Status Bar
Disable non-web
features
Window system
menu
View
Wizcon Systems
Application Studio 19
20
Menu
Option
Action
Design
Add Object
Communication
Drivers
Macros
Define macros
DDE Blocks
Application Setup
Alarm Parameters
Alarm Filter
Printer Targets
Menu
Option
Action
Zone Navigators
Language
Options
Authorization
Advanced Alarm
Management (AAM)
Scheduler
Configuration
Wizcon Systems
Application Studio 21
Menu
Option
Action
Network
Single Tag
Multiple Tags
Import
Export
Find
Multi language
Support
WizPLC
Tools
22
Menu
Help
Wizcon Systems
Option
Action
Application Upgrade
Advanced Alarm
Viewer
Help Topics
Application Studio 23
Designing an Application
The following is a suggested workflow for designing an application:
Note: If you are building a network application, define a network name and number
before you begin the workflow. Remember to restart the application.
A new project file is saved with the suffix *.Wpj. When the Application Studio opens on
your screen the name of the project appears at the route of the All Containers pane.
After the project is saved, Station Properties, which enable your to adjust system
parameters to optimize your application working environment can be defined.
24
In the All Containers pane right click the project name and select Station Properties from
the popup menu.
User
Date Format
Wizcon Systems
Designing an Application 25
VFI
Audit Trail
ODBC Connectivity
Advanced Alarm
Management
Scheduler
User Management
Logfile Limitation
26
Tags are I/O points that are mapped from PLCs to the application as well as to internal
(dummy) and calculated (compound) variables. You can use tags in images, charts,
alarms and all application functions.
When defining tags, make sure that tag and block sample rates do not conflict with each
other. See page 93.
Defining Alarms
Once you define the tags, continue by defining the alarms. Alarms notify a user of an
event in the process. They can:
Set different severity levels to control grouping and display of the alarms.
Target serious alarms to a pop-up window, ensuring that users will not perform any
systematic function before clearing the alarm. This is recommended.
Assign an alarm to an object in an image. This object will then change its graphical
attributes whenever the alarm conditions are met.
Wizcon Systems
Designing an Application 27
Assign a Help file to each alarm so the user will know what to do when an alarm
begins.
The Image Editor that features many different toolboxes to enable you to build your
application.
Zones, different areas of the image that can be viewed in close up. Each zone can
represent a different part of a plant process.
Layers that can be compared to transparent sheets with the same coordinates, which
lay on top of each other. You can enable group access to certain layers and thereby
control sensitive information.
Cluster libraries that use object oriented technology to simplify and speed up
application design and maintenance. A cluster is an object with predefined behavior
patterns and can be linked to existing tags and alarms, or can be used to
automatically create new tags and alarms.
The Image Editor that features many different toolboxes to enable you to build your
application.
28
Loading a recipe.
Charts provide graphical views of past and current tag values. You can use charts to
follow a trend or compare values. You can define up to 16 tags on a single chart.
When defining a chart, it is possible to:
Define a unique color to each chart that is also used by the scales of the chart.
Defining Reports
Reports (see page 93) can be defined for different users such as: operators, engineers,
and managers. Make sure that each report includes the required information for the
designated user.
Reports can be:
Written to a file.
Wizcon Systems
Designing an Application 29
Place fields in different positions and include any text, such as a header or short
explanation at the end of the report. The fields can represent runtime values and a
number of calculations performed on the historical tag values, such as averages,
integrals, sums and more.
Choose the range calculation, such as start day, start time, end day and end time.
Define compound fields that are based on two other fields according to a specific
formula. Multiple fields allow you to receive a value based on a group of other
fields.
Defining Recipes
Recipes are specified sets of tag values that can be stored for future use.
When defining recipes, remember that:
Each recipe must belong to a model that includes tags for certain processes or
production modes. The recipe uses the tags in the model to which it belongs, but can
also include tags that are not defined in the model.
You can save the current values of any tags at any time as a recipe. This means that
at the end of a process, you can save its values as a recipe and reload the recipe when
the process is resumed.
Activate reports.
Check alarms.
Once you are satisfied with the results, fine tune your entire application, by:
30
Setting the menus that will be displayed for the different user groups.
Wizcon Systems
Designing an Application 31
Shutting Down
To logout:
You can exit the system from the User Login or from the Application Studio.
To exit the application:
User Login
Local User Login
To login to the system locally, click the Login icon in the Quick Access Bar. The User
Login dialog box will open on your screen.
If you know your user name and password type them in the relevant fields and click OK.
32
Note: A default login name and password can be defined by the System Integrator and
used by all users to login to the system.
A user can also be a member of a group or team. In which case the group/team login
name and password are used.
Login using their user name and password and access their group assigned options
Or,
Login using a default user name and password and access the options specified for
default users
The Login/Logout Quick Access Bar, which appears when the browser is opened,
enables you to quickly login and out of the system.
The application enables you to replace the Login/Logout bar, and design your own login/
logout interface using HTML script. Remote user options will still run in the
background.
To login:
1. Start the system and access your web application. The browser is launched.
2. A typical browser will display the application icon, which you can click to begin
login.
Wizcon Systems
User Login 33
3. You can also click Login on the Login/Logout Quick Access bar displayed in the top
left corner of the window to open the User Login.
4. If you know your user name and password type them in the relevant fields and click
OK.
Note: A user can also be a member of a group or team. In which case the group/team
login name and password are used.
To logout:
Default User
The application enables you to create a default user. When a Default User is assigned,
after a user logs out of the application, the application automatically opens using the
name and password of the Default User.
A default user is created in the User Management module by selecting Users to open the
List of Users and then right clicking on a specific user name and selecting the Default
User option. The
Note: Only users that are members of the Administrator group can add users to the
application.
In the All Containers section of the Application Studio, right click HTML and select
Properties from the popup menu. The HTML Properties dialog box is displayed.
34
Popup - where you can specify whether or not a Popup Event Summary window is
displayed in a browser
Popup
This dialog box enables you to define whether or not a Popup Event Summary display is
enabled in a browser. It also enables you to assign group authorization so that the Popup
Events Summary is displayed only in the browser of authorized users. Do the following:
1. Check the Enable Popup Window in Browser checkbox to enable this option.
2. Click the Groups button to display the standard Groups dialog box in which you can
assign group authorization for Popup Events Summary display.
3. Click OK to save these definitions.
Wizcon Systems
User Login 35
Users
This dialog box enables you to define remote user login parameters.
1. Check the Enable Login Quick Access Bar in Browser checkbox to enable this
option. The user can then login to the Web application by clicking the Login button.
2. Check the Automatically Login with Default User checkbox to enable any user to
login with a default user name and password. This means that any user can access
the application and use the options that are assigned to default users. When this
option is not checked the user will be forced to login with a user name and password.
3. Click OK to save these definitions.
36
Trends
Graph description
Wizcon Systems
User Login 37
Experienced HTML users can customize the login/logout procedure on their computers
by creating buttons in HTML and attaching HTML script, as follows:
HTML Script
Action
scriptLoginUser()
scriptLogoutUser()
Logout
scriptGetCurrentUserName()
After customizing the login/logout procedure, deselect the remote user login parameters,
so that the Login/Logout Quick Access bar is replaced by your own login interface.
Note: Remote system mechanisms will continue to run in the background.
Application Setup
The Application Setup dialog box enables you to set up or modify the additional add-ons
and programs you wish to run when starting the application.
To open the Application Setup dialog box:
In the Control panel of the Application Studio, double click the Communication Driver
icon.
Or,
From the Design menu, select Application Setup. The Application Setup dialog box is
displayed.
38
Properties
Remove
Note: When adding a list of programs, write the list in the order that you want them to
run. Do not place a program that should run before the application interface following a
program that should run after it.
Wizcon Systems
User Login 39
Click the Add button in the Application Setup dialog box. The Programs Specification
dialog box is displayed:
40
Program to Run
Parameters
Open a Window
Click the Advanced button in the Application Setup dialog box. The Advanced Settings
dialog box is displayed:
Wizcon Systems
User Login 41
Run WizPLC
Runtime
Select Application
WizPro Options
WizPro is the application programming interface kernel. It provides mechanisms
through which PLC and external device communication can be implemented, maintains
an online database, and services all inter-process requests and messages.
42
From the Design menu, point to Options and select WizPro from the popup menu. The
Set WizPro Options dialog box is displayed:
Write to HIS
File
Alarm Module
Collapse
Alarms
Wizcon Systems
User Login 43
Enable Multilanguage
Support
Perform
Compress on
Next Restart
Physically removes all deleted tags and alarms from the system's
database and renumbers their ID numbers. When tags or alarms
are removed from the application, they are not physically deleted,
but only marked as deleted so as not to affect the internal ID
numbers of the remaining tags and alarms. Enable this option in
applications where it is necessary for tags and alarms to have
sequential ID numbers.
Note: If the ID number of tags or alarms changes, the data in the history files may not
be processed. Therefore, it is strongly recommended that you keep a backup of the tag
definition files (table tags and alarms in Wizdata MDB) deleting any tags from the
database.
If the ID number of tags changes save the applications Language commands again in
the application Language Definitions dialog box. This is necessary so that the
commands will correspond to the new, internal tag IDs.
Deleted tags count as defined tags when the application checks that the number of
defined tags is less than the amount allowed by the security key.
From the Design menu, point to Options and select Paths from the popup menu. The Set
Default Paths dialog box is displayed:
44
The dialog box displays the application file types with their current path specifications.
Wizcon Systems
User Login 45
1. Click in the relevant line and either type in the new path or click the Browse button
to open the Browse for Folder dialog box where you can search for the correct file
path. A path must be specified with a terminating backslash (\).
2. Click Save to confirm the new path locations.
Note: Restart the application for changes to take effect. It is not recommended to
change the path of Users, Macros, Classes, Web Applications, Event Summary Profiles,
Pictures and Trends.You can only change the users or application path by typing directly
into WizCfg.dat
Strings
If you have a multi-language application with strings in two or more languages, it is
possible that not all the strings will be present in all languages after import. If a string is
absent in a selected language the missing string will appear on the screen in the
following format:
<??string ID?>
46
1. From the Tools menu, point to Multi-language Support and select Export Language
from the popup menu. The Export Language dialog box is displayed:
2. In the Export to file field, enter the name of the text file you wish to create for the
language strings.
3. Click OK to save your definitions and close the dialog box. It is recommended to
save the file in the same directory as your application.
Note: If multi-language support has already been defined in your application, the last
language you imported will appear in the Export language field.
Note: Note that multi-language support must be enabled before you can use this feature.
Wizcon Systems
1. From the Tools menu, point to Multi-language Support and select Import Language
from the popup menu. The Import Language dialog box is displayed:
2. Click in the Import Language field to display a list of available languages. Select the
language in which the application was written.
3. In the Import from file field, enter the name of the text file that contains the language
string (this is the file you created in the Export to file field in the Export Language
dialog box on the previous page), or click Browse to locate the file.
4. Click OK to import the file. The following message appears:
5. Click Yes to establish a link between the language and its file.
To translate the file:
48
5. In the Import from file field, enter the name of the file that contains the translated
language strings, or click Browse and locate the file.
6. Click OK to import the file. A message box opens.
7. Click Yes. The language is now supported.
Selecting a Language
After you have defined multi-language support, you can select the language in which
you want the application to display the application texts.
To set a language:
From the Tools menu, point to Multi-Language Support and select Select Language from
the popup menu. The Select Language dialog box is displayed:
1. Click in the Select the language for the application field, and select the required
language from the list of supported languages.
2. Click OK to save your definitions and close the dialog box. The language strings are
now displayed in the selected language.
Note: The language strings are displayed in another language only after refreshing the
required container in the All Containers section. For example, to display the alarms
language strings in the selected language, click the + sign to the left of Objects. The
objects list collapses and the + changes to a -. Click the - sign to expand the objects list
and then click Alarms to display the List of Alarms. The alarm text is displayed in the
Text column of the List of Alarms in the selected language.
Application
If you try to load (import) an image, or the wizdata.mdb file created in another
application, the multilanguage support module may detect that the file was not created in
the current application. The following may occur:
If a language has not been defined for the application, the application will work with
the default language. The multi-language support module will attach the loaded file
to the current application.
Click Browse to specify the path of the language database to be used with this file.
If the selected database does not match the loaded file, the Language Database Selection
dialog box will reappear. You can either click Ignore to attach the loaded file to the
current language database, or click Cancel to prevent file loading.
Layouts
A layout is the position of an open window in an application. You can assign a layout to
a user, so that when the user logs on, the windows included in the layout will
automatically be displayed in the position in which they were saved. You can also close
all the open windows in your application. Capturing layouts, assigning them to users
and user login is for local use only. Layouts are not used when interacting with the
application through a browser.
You can open Image, Events Summaries, History Viewers and Chart windows, position
them on your screen and save their position.
50
1. Right click Layouts and select Properties from the popup menu. The Layouts
Properties dialog box is displayed:
2. Select Prompt to save layout. When you exit the application you are prompted to
save the current layout. This change can be implemented online.
To save a layout:
In the All Containers section of the Application Section, right click Layouts and select
Capture Layout from the popup menu. A standard Save As dialog box is displayed in
which you can save the layout. The layout is displayed in the List of Layouts.
To add additional window positions to an existing layout:
Specify the existing layout file name in the Save As dialog box.
Wizcon Systems
Layouts 51
To load a layout:
In the List of Layouts in the Application Studio, right click the required layout and select
Load Layout from the popup menu.
To delete a layout:
In the List of Layouts in the Application Studio, right click the layout you want to delete
and select Delete Layout from the popup menu.
1. In the User Management container in the All Containers pane click Users. The List
of Users opens in the Control Panel.
2. Select a user and then right click and select Modify from the popup menu. The User
Properties User dialog box opens.
52
3. In the Layout field click the arrow to open a dropdown list and select the relevant
layout. The selected layout will be attached to the User and will open on the User's
station.
Note: Users can also be assigned a layout when defining new users and following the
instructions above.
Wizcon Systems
Layouts 53
In the All Containers section, right click Layouts and select Close All windows from the
popup menu.
Right click the application in the root of the container list in the All Containers section
(if you have saved your application, the application name will appear in the root), and
select Station Properties. The Station properties dialog box opens. This dialog box has
the following tabs:
54
User - where a default user that will be logged in when you start the application is
defined.
VFI - where the format for history files by selecting Virtual File Interface DLLs is
defined.
Audit Trail - where an Audit Trail is added or enabled to view operator actions
stored in an application system file in the form of tag values.
Wizcon Systems
56
Display untitled
windows icons in
task bar
Display windows
icons in the task bar
Note: You only log on to the system when using the application locally.
The instructions below apply to both Default User and Logout User fields:
1. In the User field type in the user's name. Enter an asterisk (*) to specify the last user
that logged out. Changes are implemented online.
Wizcon Systems
58
Wizcon Systems
Date
separator
1. In the Stations Properties dialog box select the Date Format tab. The Date Format
Dialog opens.
2. From the Date Style list select a predefined date style.
3. From the Date Separator list select the way you want the date to be separated.
4. Click OK key to enter your selection.
When loading for the first time, the application sets default values for these parameters
using country code, defined in Control Panel/Regional Settings.
The table below lists the default values in the application for different countries.
60
Country
Date Style
Date Separator
USA
MMDDYY
/ (slash)
Japan
YYMMDD
/ (slash)
Netherlands
DDMMYY
- (dash)
Denmark
DDMMYY
- (dash)
Country
Date Style
Date Separator
Germany
DDMMYY
. (dot)
Austria
DDMMYY
. (dot)
Russia
DDMMYY
. (dot)
All others
DDMMYY
/ (slash)
Wizcon Systems
This dialog box Tags and Alarms fields have the following options:
Proprietary format
DBF format
Custom
62
Operator actions are stored in an application file in the form of tag values that can be
accessed and viewed.
The application logs all manual operations, with exception to those made using Add-on
programs, such as script language and WizPLC. Additionally, the application does not
record Smooth Type trigger actions.
Audit Trail provides data recovery for users connected to a remote ODBC data source in
instances of network failure.
Note: It is not recommended to work with a remote database due to possible connection
failures.
To enable audit trail:
1. Right click New Application in the All Containers list of the Application Studio to
open the Station Properties dialog box.
2. Using the arrows scroll to open the Audit Trail Enable tab.
Wizcon Systems
3. Check the Enable Audit Control checkbox to activate the Current Data Source field.
When the database source is predefined, click the Current Data Source field's drop
down list and select the database. If it is not predefined click the Add Data Source
button.
The standard Windows Create New Data Source wizard window is displayed, in
which a database source can be defined. The data source can be any valid predefined
ODBC data source.
4. In the Select a Type of Data Source section click User Data Source (applies to this
machine only) and then click Next to open the next dialog box.
64
5. Select the driver for which you want to set up a data source and click next to open
the Finish dialog box.
6. Verify that the information in this dialog box is correct. If it is, click Finish, if not
click Back to make any corrections. The ODBC Microsoft Access Setup dialog box
opens.
7. Complete the Data Source Name and Description fields.
Create
Repair
Compact
9. In the System Database field click either None or Database and then click OK.
10. The Database Successfully Created notification will appear on your screen. Click
Apply and OK to close the dialog box and then restart your computer.
Note: The application does not support the File Data Source (Machine independent)
option.
Wizcon Systems
Data Recovery
Audit Trail provides data recovery for users connected to a remote ODBC data source in
instances of network failure.
When a network problem is discovered, the application ends the session with the remote
database and creates a temporary file in the Temp folder of Windows NT. This file, a text
file in CSV format, is called BCK*.tmp.
The application then scans the network connection once a minute, and when connection
to the server is re-established, writes the temp file to the audit trail file. If the information
is written correctly, the application then deletes the temp file. If the information is not
written correctly, the application will notify you of possible data loss.
Note: It is not recommended to work with a remote database due to possible connection
failures.
Database Fields
66
Field
Variable
UserName
Specifies which user name performed the
action.
SQL_VARCHAR 20
SourceType
Specifies the Image or browser.
SQL_VARCHAR 10
SourceName
Specifies the Image or picture name.
SQL_VARCHAR 200
SourceID
Specifies the IP address of the browser.
SQL_VARCHAR 50
Action
Specifies one of the following actions: tag
assign, zone, macro.
SQL_VARCHAR10
TagName
Specifies the name of the tag.
SQL_VARCHAR50
Field
Variable
TagValue
Specifies the tag value.
SQL_DOUBLE
ZoneName
Specifies the name of the zone.
SQL_VARCHAR 20
MacroName
Specifies the name of the macro.
SQL_VARCHAR10
TimeAction
Specifies the time and date the action took
place. When accessed through a browser, the
time and date will be that of the server.
SQL_VARCHAR20
Wizcon Systems
1. Right click New Application in the All Containers list of the Application Studio to
open the Station Properties dialog box.
2. Using the arrows scroll to open the ODBC Connectivity tab.
3. Check the Enable ODBC checkbox to activate the dialog box options.
68
4. In the Current Data Source field select the database type to which you want to save
application Historical Data. Or click the Add Data Source button to open the Create
New Data Source dialog box.
5. In the Cross Reference Table field, type in the name of the table and click the Create
Reference Table button to create a cross reference table including tag definition
parameters.
6. If you intend to use a protected database (such as Oracle) type the user name and
password in the identification field.
7. Under the History Table field type in the name of the historical data table. Check the
Enable Tag Name Logging checkbox to write tag names to the historical data table.
8. Click Apply and OK to confirm.
If the communication lines used by AAM are already defined then do the following:
1. Right click New Application in the All Containers list of the Application Studio to
open the Station Properties dialog box.
2. Using the arrows scroll to open the Advanced Alarm Management tab.
Wizcon Systems
3. Check the Enable Advanced Alarm Management checkbox. You can define the
order in which alarms in a queue will be processed by selecting Enable Priority
Management. You can use the alarms severity field to sort the alarms but you must
define whether higher severity alarms are treated with a higher priority than others or
vise versa. For example, if you decide that the Highest Severity has the Highest
Priority, then, if two alarms with are waiting to be sent, the alarm that was defined
with the highest severity will be sent first.
4. Restart the application.
70
1. In the All Containers side of the Application Studio right click the application's
name to open the Station Properties dialog box.
Wizcon Systems
1. Right click New Application in the All Containers list of the Application Studio to
open the Station Properties dialog box.
72
2. Using the arrow, scroll and open the User Management tab.
3. Select the options you want then click OK .
4. Restart the application.
Wizcon Systems
1. Right click New Application in the All Containers list of the Application Studio to
open the Station Properties dialog box.
74
Wizcon Systems
Communication with PLC's in order to represent data from PLC memory or to send
commands to PLC's.
In fast Pentium PCs with a 16550 UART (serial interface chip), Windows 2000 default
settings may cause communication errors on serial communication drivers. To overcome
this problem, lower the buffer sizes on the UART in the following menu:
Start/Settings/ Control Panel/System/Device Manager/Ports/Communication Port 1.4/
Port Settings/Advanced. Use a trial and error method to reach the optimum setting.
Printers
The Printers dialog box enables enhanced printing capabilities. Each printer added to a
system can be set to print reports, alarms or both. Printers can also be Network printers
that are shared by multiple users. In addition, you can define whether many alarms will
be printed on a full page or whether only one alarm will be printed on each page. Page
orientation, font and printed alarm properties can also be defined and printed in different
colors, text and background.
76
Multiple Tags
The Multiple Tags module can be used to optimize performance and enhance
functionality. This module enables you to adjust system parameters and establish the
correct environment for working with the application.
Multiple Tags displays tag lists and enables you to read and write tag values, as well as
change several tag attributes. In addition, Multiple Tags provides options to save the tag
list as a recipe or a tag list file.
Tag list files are ASCII files that contain lists of tags and their attributes. These files have
the extension .GLS and can be used in the application to generate tag lists in the tag
definition procedure.
Single Tags
The Single Tag dialog box is used to assign an immediate value to a specific tag. This
dialog box has the following fields: Station Name, Tag Name, Current Value, New
Value and Suggest and Set.
DDE Blocks
The programs DDE Client Block enables the application to receive may tag values from
the server in one update message. This improves the communication between the
application and the DDE Server. The application DDE client Block is built from a
matrix of rows and columns in which each cell of the matrix contains the value of one
data item.
Note: Not all programs support block messages check the documentation of the DDE
server.
A common use for the DDE client blocks is a setup in which a DDE server
simultaneously updates a block of items that make up a recipe. This software program,
the client, receives all the items and the tag values are changed immediately.
Define DDE client blocks only if data items in the server change simultaneously (within
milliseconds). The application receives the whole block of data whenever one of the
items in the block changes. Therefore, if items change one at a time, the application will
receive a whole block of values of which have not changed.
Wizcon Systems
Application Setup
The Application Setup dialog box enables you to set up or modify the add-ons and
programs that run when starting this application. See page 38.
Macros
Macros are shortcuts that can be used to execute pre-defined actions, commands, or
sequences, whenever designated keys or key combinations are activated. This enhances
overall application functionality, and saves you the time and effort of having to execute
operations in several stages.
Up to 65535 application macros can be defined.
Application macros are defined by the following attributes:
Accelerator keys that invoke the macros (F1 to F12, A to Z, ALT alone, or in
combination with Ctrl, Shift, and others).
Authorization groups.
Actions
Commands
Sequence
Trigger Macros
If an application window, including the Application Studio, or the Single Tag Input
dialog box is the active window. If any other window is active the macro will not be
executed.
When the application is used locally (for example, if a trigger macros is invoked
through a web browser) it will not be executed.
Note: Macro names cannot contain the following character (single quotation mark).
78
Application Network
An operations station that can communicate with up to 1000 network stations and 32
PLCs simultaneously. This station performs functions such as:
Sampling PLCs
Generating alarms
The operator can view the process through the application user-interface and interact
with on-going activities. The application's SCADA station can receive and send data to
other network stations.
Wizcon Systems
Application Language
Language statements are scanned periodically by the system, as defined during the
Application Language setup procedure. If a statement condition is true, the relevant
operation or operations are executed.
WizPLC Development
WizPLC enables you to write control logic programs with the powerful language
constructs of the IEC 61131-3 standard. The IEC 61131-3 is an international standard for
programming languages of PLC's. WizPLC offers the entire range of languages
described in this standard.
WizPLC consists of two parts: a programming system (WizPLC Development) and a
runtime system (WizPLC Runtime).
WizPLC is a complete development system for your Windows station which allows you
to significantly reduce application development time.
WizPLC Development:
80
Is a programming tool.
WizPLC Runtime
All processes and data can be monitored and controlled by this software application. All
tags defined in the application are automatically accessible within the associated
WizPLC project.
Tag Filters
The Tag Filter module is used to filter, view and manage a list of tags and their status
(locked/unlocked) in the application. This is useful for the development and
maintenance of an application.
The Tag Filters List is stored in the application's TFM.XML filter that is created in the
.\docs directory (or another appropriate directory of the application).
When accessed through Java applets the Tag Filters List can be defined/modified/viewed
in the Image module during runtime. Up to 10 tag filters can be selected simultaneously.
In this version up to 1000 tags can be defined.
Tags can be sorted according to:
Source
PLC - tags associated with external devices and mapped on the external device
variables.
Dummy - tags representing internal variables used for a variety of calculations,
control and other application related needs.
Compound - tags which are linear calculations based on values of other tags.
System - tags that are predefined and built to provide system status information
Type
Digital - discrete logic tags that have a boolean value of True (1) or False (0).
Wizcon Systems
Note: There is the option to select all sources and all types or only one or more source or
type.
Alarm Filters
The Alarm Filter filters alarms and reports before they are printed out or written to the
Event Summary. Alarm filters are displayed in the Alarm Filters table and defined or
modified in the Filter Properties dialog box. Filter properties can be updated, however
the name of a filter cannot be changed.
The Alarm Filter filters the alarms sent when parameters defined in tag variants are not
met.
After alarms and reports outside the defined categories have been filtered out by the
Alarms Filter, the remaining alarms are sent to the Printers defined in the Printer Targets
module.
Printer Targets
The Zone Navigator is a global, multi-image zone navigation window that enables
efficient navigation through a list of zones defined in the application's various image
files.
Using the Zone Navigator window a number of navigators each of which can contain a
number of zones from one or more different image files can be defined.
The Zone Navigator can be applied on images through button and action type triggers or
by configuring an action macro using the Zone Navigation Action macro.
A digital tag representing the zone status of each Zone Navigator can be attached. If the
tag value is set to 1 Zone Navigator status will be BAD and if set to 0 Zone Navigator
82
status will be GOOD. Additionally, colors can be defined in which zones with a control
tag of BAD status will be displayed in the run-time Zone Navigator window. The Zone
Navigator is Web enabled.
Advanced Alarm Management
The Advanced Alarm Management (AAM) module provides additional alarm services.
This is useful when critical alarms requiring urgent attention need to be sent, read and
the cause of the alarm handled.
The AAM module sends either alphanumeric or voice messages. An alarm can be sent
by SMS, pager, E-mail, fax, printer, or as voice to single or multiple users. An alarm
sent by voice mail can be acknowledged and any messages sent with the alarm can be
read.
AAM messages can be sent to groups as defined in the User Management module and
according to schedules set in the Users Timetable.
The AAM module supports multilanguage. User messages can be translated into
French, English or German.
Note: All WAV files played by the AAM must be in mono format and not stereo.
WizScheduler
The Internet based Scheduler enables you to easily create daily or weekly task orientated
schedules remotely. Accessed through an Internet browser or by clicking on an icon, the
Scheduler is extremely user friendly, efficient and economical.
Being both task and time orientated the Scheduler can be used to create unlimited tasks,
actions and states. Task can be modified, enabled/disabled and have many states such as
On/Off attached to them. An unlimited number of actions, which are basic operations,
can be attached to each task.
Timetable templates can be created in advance and be attached to a task. Additionally,
multiple schedules using the same template can be defined, where changes made to one
template will automatically appear in all the other schedules using the same template.
The Scheduler enables temporary changes to be defined for both tasks and dates.
An additional feature is the ability to create an unlimited number of Special Days, such
as public holidays and incorporate them into the task schedule. Different tasks can be
defined for these days or the task schedule for a specific day can be altered.
Wizcon Systems
Another feature used to make changes is the Temporary Daily Program. The definitions
made in a Temporary Daily Program override regular task and Special Day definitions.
Note: Set your computer monitor to the resolution 1024 X 768 for maximum view
quality.
RePlay
The RePlay module is used to view a graphical display of previous history tag values in
images. The application reads and displays the tag values from the application's history.
The RePlay module is activated from the Application Studio Control Panel. An
application image cluster controls the RePlay itself.
Only tags that have Write to History defined during Tag Definition can be used. String
Tags and Remote Tags are not displayed in this version.
Tag Mapper
The Tag Mapper is a data file of tags and tag values that can be used to considerably
reduce workload during application creation. Tag values of tags held in a Tag Mapper
table are mapped by the Tag Mapper into a list of other tags.
There are two types of Tag Mapper tags:
Source: These are tags whose values are directed to target tags. More than one source
tag can be pointed to the same target tag.
Target: This tag type receives the values of the source tag. All target tags must have the
WIZTGM_ prefix.
To define the source tags that update a specific target tag first create the tables used by
the Tag Mapper. Each table has a unique Id (Index) that is later used in the image as the
index value. Each image can use one table only at a specific time. The table that is used
is defined by the index value. A single image can be used to display different source tags
values in the same target tags (depending on the index value entered by the user).
An unlimited number of tags can be mapped. The Tag Mapper is bidirectional. All Tag
Mapper dialog boxes are resizeable.
Dialog boxes can be accessed by either clicking the relevant button, from the menu bar
options, or by right clicking and selecting an option.
Tag Mapper Tables can be imported and exported to/from other applications.
84
Wizcon Systems
All Containers
User Management
86
Definition of how alarms are transferred and received by users using Advanced
Alarm Management
HTML
The system's applications are viewed online using application Java Applets known as
Wizlets that are embedded in HTML pages displayed by the Web browser. The page also
includes a parameter that specifies the input file. For example, a page containing an
Events Summary Profile wizlet also contains the file name for the Events Summary
Profile.
The system includes an HTML assistant to help you generate HTML pages. You can
also build the pages manually. The HTML pages are then published on a web server so
that an operator can view and interact with an application in a web browser.
HTML pages can be generated from the following:
Events Summary Profile: The resulting page displays an Events Summary Viewer
in which you can view and interact with online alarms.
A Trend Profile: The resulting page displays a Trend Viewer in which you can
view past and current events that occurred in the system.
Audit Trail Profile: The resulting page shows a log of the actions performed over a
specified time period
History Profile: Shows the values of selected tags over a selected time period.
You can generate a single HTML page that will contain two or more objects, or an
HTML page that will contain a single object.
Note: When an Events Summary/Chart is created an additional file will be created
automatically for the Events Summary Profile/Trend Profile.
In an Event Summary that is displayed on the Web only one alarm can be selected.
The displayed order of columns of the Event Summary and Event Summary Profiles over
the web differs to the order of the same windows not displayed over the web.
Event Summary Profiles
The Events Summary Profile module holds the definitions that determine the way alarms
are displayed on the Internet browser. The Events Summary Profiles dialog box has the
following tabs:
Alarm Filters: Which defines the alarm filtering criteria by which alarms are sorted
and then displayed in the Events Summary.
Wizcon Systems
88
Display: Which defines the display parameters of the Events Summary window.
Features: Which defines the features that will be enabled or disabled for the
operator.
Events Summary Profile files can be identified by their WNA file name extension.
The Events Summary Viewer features real-time alarms monitoring (online mode)
according to the definitions specified in the Events Summary Profile. In addition to the
Online mode, the application also provides a History mode that displays a report of
historical alarms. This shows a list of alarm activities for a specified period of time. For
example, alarm information one week before the current date.
The application enables you to define filters for the Events Summary Viewer to specify
the type of alarm information that is displayed.
For example a filter can be defined that displays only alarms from a specific family such
as; families beginning with the letter A. Filters can also be applied online to display a
historical report.
Trends Profiles
Trends are used to compare device functionality and correlate actions and responses.
Their data can be displayed in one of two modes:
Online mode in which the Trends are constantly updated according to changes in
field values.
History mode in which the Trends can be configured to display tag values that
occurred over a specified time period.
A Trend Profile contains the definitions that determine the way graphical views of past
and current activities recorded by the application are displayed over an Internet browser.
A Trend Viewer displays online past and current activities recorded by the system
according to definitions specified in the Trend Profile. Trend Viewers can be modified
online.
Trend Viewers are created by generating an HTML page from a Trend Profile and then
opening the resulting page on the Web.
Wizcon Systems
Images
The Image Editor is the graphic tool of the application. It is used to create and view the
images that enable the operator to visualize part or all of a control process.
The Image Editor operating in an Image window defined during application setup
includes a wide variety of drawing tools that make image design quick and easy. Any
drawing in this window can be zoomed and scrolled.
Objects created using the Editor can be linked to tags, so that as the values of a tag
change, the objects linked to the tag will change accordingly. In addition, objects can be
defined as triggers for tag value input.
Image Editor operations can be performed only by operators that have the appropriate
authorization level permission. While some operators may be authorized to design and
view images, others may only be able to view them. In addition, each object in an image
has its own authorization level.
The following basic activities can be performed using the Image Editor:
Image Animation - Associating Image objects and dynamic properties with tags
and modifying their values.
Event Summaries
The Events Summary is a window in which alarms are displayed. Several Events
Summaries can be created each with different types of alarm categories. This enables
the operator to identify the type of alarm. Alarms in the Events Summary can be
classified according to several groups, and insignificant events and information can be
inhibited for operator convenience.
Events Summaries operate in one of two modes, Online or History.
In the Online mode, only active alarms are listed (according to the specified filters).
In the History mode, a historical list of alarms is shown in the Events Summary
(according to the specified alarm filter) and can be directed to the Internet, Intranet,
operator's screen, file, or a printer.
The Events Summary can display alarms generated on any application station on the
network. This way, an operator can see alarms of the same logical functional group from
different parts of the controlled area.
90
Alarms are displayed in default colors, specified during Application Setup. Different
colors for background and foreground (text) can be defined for each severity range and
zone, but event time (Start Time, Ack Time and End Time) colors are assigned by the
system and cannot be changed.
The event time colors are:
Note: By default the background color for Start Time, Ack Time, End Time is white.
Charts
Charts provide graphical views of past and current activities recorded by the system.
They can be used to reveal operational trends, compare device functionality and
correlate actions and responses.
A Chart can be defined, edited and viewed. It is displayed in a window where up to 16
activities can be displayed simultaneously, each with its own color and style.
Chart operations are performed according to the operator's authorization level. For
example, some operators may be able to define, edit, and view Charts; others may only
be able to view Charts.
In addition to the standard window structure, the Chart window includes the following
elements:
Graph Area
Time Scale
Scroll Bar
Wizcon Systems
History Viewer
Recipes are lists of tag values that are applied to specific control processes. Value groups
are applied to a control process to cause the process to enter a desired working state.
In the application, when a recipe is applied, the tags listed in the recipe are set to the
corresponding values that are specified. Tags in a recipe can be assigned a set value or
associated with the value of another tag. If a tag is associated with another tag, its value
will be the current value of the tag with which it is associated at the time the recipe is
applied.
Creating recipes involves two steps:
Recipes are stored as simple text files. Therefore, they can be used to exchange
information between the application and other programs.
Recipes are defined and grouped using models. A Model is a prototype list of tags from
which recipes are derived. In the application, models must be defined before recipes.
However, while each recipe must belong to a model, recipes do not necessarily have to
include tags from the model to which they belong.
Each model and recipe has a unique name. Two different recipes with the same name can
belong to different models.
Models, like recipes, are stored as text files, and can be exported to external applications.
Write blocks are groups of tags to which values are written in a single data transfer
operation whenever the recipe is applied.
Layouts
92
You can also close all the open windows in your application, as described below.
Capturing Layouts, assigning them to users and user log on is for local use only. Layouts
are not used when interacting with the application through a browser. For further
information see page 50.
Reports
The Report module can be used to define customized reports for specific plant
requirements. The application generates the reports that you define with this utility as
free-format documents that can contain text and calculated values (fields), based on
historical data stored in system files.
After the report is defined and saved, it can be generated by typing the command at the
command line, or by a command in Application Language.
A report is composed of the following components:
Frame Free text and fields. Frames are stored in ASCII files called *.rpt and field
data is stored in files called *.rpd.
Fields Tag and calculated values, including report date and time
Tags
The term Tags in the application refers to control values monitored by the system. These
values are similar to variables in a programming language such as BASIC, PASCAL,
and C. Like their programming counterparts, each value is identified by a unique name
and can be one of several data types, such as integer, real, or boolean.
PLC tags are distinguished from other variables in that they can be associated with
external device components, such as registers or I/O points in PLCs, memory locations
in remote devices. A tag value represents the value of an external component or device,
so that referencing the tag is equivalent to referencing the component or device itself.
Updating a tag causes the external component or device to also be updated. Thus, an
application PLC tag is actually a link to external devices.
Once tags are defined in the Tag Definition dialog box, they can be used in other
modules for displaying, calculating and control functions.
For quick reference, the number of tags within the application is listed Application
Studio Status Bar.
Wizcon Systems
An application tag can be associated with one of the following sources: PLC, Dummy or
Compound:
PLC Tags are associated with external devices and mapped to the external device
variables (for example, PLC registers). The application samples these tags
periodically through the communication driver so that value changes in the field
device variable are automatically transferred to the associated tag. PLC tag value
changes in the application are recognized in the external device.
Dummy Tags represent internal variables and are used for a variety of calculations,
control and other application-related needs. Dummy tags are updated by user input
or changed by other application modules. These tags are set to 0 upon system
initialization.
System Tags are predefined and built to provide system status information. These
tags can be added to an application only once either when the application is activated
or anytime afterwards. Once added, System Tags will appear under the Tags icon in
the All Containers pane. When double clicked a list of all the System Tags in the
application will open in the Control Panel.
RePlay Tags: The RePlay Tags list is held in the Application Studio, All Containers
pane under the Tags container. This list contains seven application dummy WIZRPL
tags and the dummy WIZRPL tags that are generated during image RePlay.
In the RePlay module the list of WIZRPL Tags appears in the RePlay Image field.
Dummy RePlay tags have the same attributes as the original tags used in the original
image.
Tag Mapper is a data file of tags and tag values that can be used to considerably
reduce workload during application creation. Tag values of tags held in a Tag
Mapper table are mapped by the Tag Mapper into a list of other tags.
Tag Contexts: These are a set of strings that will be used in tag templates. They are
used to replace the dynamic part of a tag name at runtime in order to modify the
behaviour of the image or chart in which the tag context is used. See the User Guide
for more details.
The application marks the different tag types with icons. Below are the Analog, Digital
and String icons used to mark tags in the Studio Tag List.
94
Analog Tag
Digital Tags
String Tags
Alarms
alarm. The Start, End and Acknowledgement time and date of the alarm can also be
listed in the Summary Events.
The application enables you to visualize alarm conditions graphically by associating
image objects with alarms. Alarm objects in images react to the conditions of the alarms
in the alarm family with which they are associated. For example, if the alarm condition is
true in the alarm family, the object may begin to blink or change colors.
The application enables you to define filters and apply tag counters to alarms. The tag
counters collect the specified alarm information that can be used in Images. The alarm
filter is automatically activated when the application is loaded
Tag Generator
96