User’s Guide WebWare Server Version 4.9 Document ID: 3HAC 031360-001
© Copyright 2008 ABB. All rights reserved.
Revision: A
The information in this manual is subject to change without notice and should not be construed as a commitment by ABB. ABB assumes no responsibility for any errors that may appear in this manual. Except as may be expressly stated anywhere in this manual, nothing herein shall be construed as any kind of guarantee or warranty by ABB for losses, damages to persons or property, fitness for a specific purpose or the like. In no event shall ABB be liable for incidental or consequential damages arising from use of this manual and products described herein. This manual and parts thereof must not be reproduced or copied without ABB's written permission, and contents thereof must not be imparted to a third party nor be used for any unauthorized purpose. Contravention will be prosecuted.
Copyright 2008 ABB All rights reserved. ABB AB Robotics Products 721 68 Västerås Sweden
© Copyright 2008 ABB. All rights reserved.
Additional copies of this manual may be obtained from ABB at its then current charge.
Table of Contents
Overview ..........................................................................................................................................7 Glossary............................................................................................................................................9 1 Installing ABB WebWare Client
15
1.1 Overview ..................................................................................................................................15 1.2 User Security Settings ..............................................................................................................16 1.3 Download the Installation Files................................................................................................18 1.4 Install ABB WebWare Client Software ...................................................................................20 2 Using ABB WebWare Client
23
2.1 ABB WebWare Client User Interface ......................................................................................23 2.2 WebWare ServerModule.........................................................................................................27
2.2.1 Login Page......................................................................................................................27 2.2.2 Help Page .......................................................................................................................28 2.2.3 Documentation Page ......................................................................................................29 2.2.4 Admin Page ....................................................................................................................31
© Copyright 2008 ABB. All rights reserved.
2.3 WebWare Report Module .......................................................................................................32
2.3.1 Overview ........................................................................................................................32 2.3.2 Info Page ........................................................................................................................33 2.3.3 Data Page........................................................................................................................37 2.3.4 Report Viewer Page .......................................................................................................42 2.3.5 Report Manager Page .....................................................................................................43 2.3.6 Report Builder Page .......................................................................................................45 2.3.7 How to Build a Report ...................................................................................................47 2.3.8 How to Edit Reports You've Created .............................................................................49 2.3.9 How to Run a Report......................................................................................................50 2.3.10 How to Add an Existing Module to Your Report ........................................................51 2.3.11 How to Create a Chart/Table Module ..........................................................................52 2.3.12 How to Set Up Chart/Table Parameters .......................................................................53 2.3.13 How to Build a Database Query...................................................................................54 2.3.14 How to Use the Query Builder Page ............................................................................55 2.3.15 How to Apply Design-Time Options ...........................................................................68 2.3.16 How to Apply Chart Options .......................................................................................70 2.3.17 How to Apply Table Options .......................................................................................71 2.3.18 HTML Module Overview ............................................................................................72 2.3.19 How to Add an HTML Module to Your Report ..........................................................73 2.3.20 How to Export a Table to Excel ...................................................................................75 2.3.21 How to Export Reports.................................................................................................76 2.3.22 How to Import Reports.................................................................................................77 2.3.23 How to Enable Log Filtering........................................................................................78
3HAC 031360-001 Revision: A
3
Table of Contents
2.3.24 Service Page ................................................................................................................ 80 2.3.25 Service Information System (SIS) Logs Report.......................................................... 84 2.4.1 Overview ....................................................................................................................... 86 2.4.2 How to Configure WebWare Backup ........................................................................... 87 2.4.3 How to Configure WebWare NFS Backup ................................................................... 89 2.4.4 How to Configure an NFS Mount for an S4 Robot....................................................... 90 2.4.5 How to Configure an NFS Mount for an IRC5 Robot .................................................. 92 2.4.6 How to Configure NFS at the Device Configuration Utility......................................... 94 2.4.7 Backup Control Page..................................................................................................... 95 2.4.8 How to Use On-Demand Backups ................................................................................ 97 2.4.9 Backup Tips................................................................................................................... 99 2.4.10 Backup Status Messages ........................................................................................... 101 2.4.11 Backup Schedule Page .............................................................................................. 106 2.4.12 Schedule Manager Page ............................................................................................ 107 2.4.13 How to Schedule Backups......................................................................................... 109 2.4.14 Backup Results Page ................................................................................................. 110 2.4.15 How to Display Backup Results................................................................................ 113 2.4.16 Backup Restore Page................................................................................................. 115 2.4.17 How to Use the WebWare File Manager .................................................................. 119 2.4.18 How to Use the Restore Page .................................................................................... 120 2.4.19 How to Restore a Backup Using WebWare .............................................................. 123 2.4.20 WebWare RAPID Restore Procedure ....................................................................... 125 2.4.21 How to Restore Files from an NFS Mount Using the Robot Teach Pendant............ 135 2.4.22 How to Restore Files from an NFS Mount Using the Robot Flex Pendant .............. 138 2.4.23 Backup Summary Page ............................................................................................. 141 3 System Reference
143
3.1 Return Status Codes............................................................................................................ 143
3.1.1 Return Status Codes .................................................................................................... 143 3.1.2 RPC Communications Errors ...................................................................................... 144 3.1.3 InterLink Module Communication Errors................................................................... 145 3.1.4 General Error Messages .............................................................................................. 147 3.1.5 InterLink FTP Error Codes.......................................................................................... 148 3.1.6 InterLink Error Code Definitions ................................................................................ 149 3.1.7 InterLink Monitor Connecting Failure ........................................................................ 152 3.1.8 Variable Handling Error Messages ............................................................................. 154 3.1.9 Program Handling Error Messages ............................................................................. 156 3.1.10 File Handling Error Messages................................................................................... 157 3.1.11 Configuration Handling Error Messages................................................................... 158
4
3HAC 031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
2.4 WebWare Backup Module ..................................................................................................... 86
Table of Contents
© Copyright 2008 ABB. All rights reserved.
3.1.12 Log Error Messages ...................................................................................................159 3.2 WebWare Server Error Codes ................................................................................................161
3HAC 031360-001 Revision: A
5
© Copyright 2008 ABB. All rights reserved.
Table of Contents
6
3HAC 031360-001 Revision: A
Overview
Overview About This Manual This manual contains information and procedures to use the ABB WebWare Server. Usage This manual should be used during daily use of the ABB WebWare Server. Who Should Read This Manual? This manual is intended for: •
ABB WebWare Server Users
•
Production Technicians
Prerequisites
© Copyright 2008 ABB. All rights reserved.
The reader should: •
Be familiar with basic robot concepts.
•
Have knowledge and understanding of computers and computer networks as well as robots and robot controllers.
Organization of Chapters The manual is organized in the following chapters: Chapter 1. Installing ABB WebWare Client
Contents How to install the ABB WebWare Client used to access the advanced features of ABB WebWare Server.
2. Using ABB WebWare How to use the powerful features of the ABB WebWare Server. Client 3. System Reference
Reference information containing detailed information on error code explanations and more.
References Reference
Document Id
-
Continues on next page 3HAC031360-001 Revision: A
7
Overview Continued
Revisions Description
-
First release
© Copyright 2008 ABB. All rights reserved.
Revision
8
3HAC031360-001 Revision: A
Glossary
Glossary
© Copyright 2008 ABB. All rights reserved.
Important Terms The table below defines terms as we will use them in describing concepts in WebWare products. Term
Definition
Alarms
OPC events that indicate a problem with some part of the system. OPC alarms include several conditions, including type, severity, state, name, etc.
Alias
The named instance of a robot controller accessed by InterLink.
Backup file set
The list of files, robot program modules, log files, etc. that you selected for backup from a robot controller.
BaseWare
ABB robot controller operating system software.
Counters
Counters count event occurrences over a given time frame. Typical WebWare counters are ideal for counting parts per hour and failures per hour, often set from RAPID robot controller counter functions.
Data Collector
Any computer that has InterLink software installed on it. A Data Collector collects data from robot controllers and pushes that data up to WebWare Server.
Data Event
The WebWare Data Event Editor allows you to increment WebWare counters or start and stop WebWare timers based on an OPC tag’s state.
Data Source Name (DSN)
A data source name (DSN) is a data structure that contains information about a specific database that an Open Database Connectivity (ODBC) driver needs to connect to it. Included in the DSN, which resides either in the registry or as a separate text file, is information such as the name, directory and driver of the database, and depending on the type of DSN, the user ID and password.
Default Web Site
A “default” web site is the first site that will appear when a browser is pointed to http://hostname where hostname is the name of the server PC.
Device Configuration Utility (DCU)
Program that allows users to configure robot aliases and profiles for use in the WebWare system.
Event Log
File that stores event messages from the robot.
Continues on next page 3HAC031360-001 Revision: A
9
Glossary Continued
Term
Definition
Events
Something that happens. In WebWare, typical events include StatusChanged events, Help events etc.
Extensible Markup Language XML, a formal recommendation from the World Wide Web (XML) Consortium (W3C), is similar to the language of today's Web pages, the Hypertext Markup Language (HTML). XML is a markup language for documents containing structured information. Hypertext Transfer Protocol (HTTP)
Protocol used for transferring files (text, graphic images, sound, video, and other multimedia files) on the World Wide Web.
InterLink Module
The ABB InterLink Module provides the core communications support needed for ABB WebWare products.
InterLink Monitor
Utility program that allows users to monitor the connection status of devices connected to the WebWare network.
InterLink Service
The InterLink executable object that is installed in the registry database maintained by the Service Control Manager. The InterLink service, when installed, allows InterLink to be started at boot time by a boot program, by the system, or it can be started on demand by the Service Control Manager.
IP Address
The numeric Internet Protocol address that uniquely identifies each computer on a network that uses TCP/IP. The IP address is a 32-bit identifier made up of four groups of numbers, each separated by a period, such as 123.432.154.12.
License Key
A license key allows you to use an application or a feature of an application that you have purchased from ABB. A license key is a data record in a license file. You will receive one or more license files each containing one or more license keys for the various applications that you have purchased from ABB.
License Request
A request received either electronically or via mail, for a license key that will allow you to operate a piece of ABB software or a feature of an ABB software product.
Linked Alias
An additional application or device connected to the same Robot alias on a WebWare network.
Continues on next page 10
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Hypertext Markup Language The set of markup symbols or codes inserted in a file intended (HTML) for display on a World Wide Web browser page.
Glossary Continued
Term
Definition
Log messages
Individual error or event messages that are grouped into a log file.
Microsoft Message Queue Server (MSMQ)
Microsoft Message Queuing (MSMQ) technology enables applications running at different times to communicate across heterogeneous networks and systems that may be temporarily offline. Applications send messages to queues and read messages from queues. MSMQ provides guaranteed message delivery, efficient routing, security and priority-based messaging. It can be used to implement solutions for both asynchronous and synchronous messaging scenarios.
Network File System (NFS)
The ABB Network File System (NFS) option was originally designed to provide an alternative method for restoring files to a robot controller via a Teach Pendant.
© Copyright 2008 ABB. All rights reserved.
Open Database Connectivity An open standard application programming interface (API) for (ODBC) accessing a database. OLE for Process Controls (OPC)
A standard interface developed by the OPC Foundation. It allows factory floor devices, business information and control systems to communicate with each other using a standard industrial protocol. The OPC specifications are available at http://www.opcfoundation.org.
OPC Device
Any Object Linking and Embedding (OLE) for Process Controls (OPC) compliant device. Devices could include PLC’s, HMI devices etc.
OPC Server
The OPC Server is an ABB software product that provides an interface to all robot controllers using the OLE for Process Controls (OPC) specification.
Persistent Variables
In RAPID, a variable that keeps its value between sessions.
Poll delay
This field contains the InterLink polling delay in milliseconds. The polling delay is the amount of time the robot interface sleeps between polling cycles. The default polling delay is 200 milliseconds.
Profile
A profile is a group of properties and parameters that determine the behavior of a robot alias.
Ramdisk
In an ABB robot controller, a memory device located in the controller’s RAM.
Continues on next page 3HAC031360-001 Revision: A
11
Glossary
Term
Definition
Robot Application Protocol (RAP)
Provides an application interface to the ABB Robot Controllers. RAP provides a set of services that you can use to control and monitor ABB Robots from an external computer.
RAPID
Programming language used to program ABB robots.
Robot Alias
The naming device used by InterLink to refer to a designated device on the WebWare network.
Robot modules
RAPID programs consist of one or more modules. There are two types of modules:Program modules - contain the RAPID program statementsSystem modules - configuration parameters and robot settings
Service
A program, routine, or process that performs a specific system function to support other programs, particularly at a low (close to the hardware) level.
Simulated Interface
An interface that allows InterLink to respond to all functions and methods, even though InterLink is not connected to a real robot controller. Used for application development.
SQL Server
The Microsoft program that manages Structured Query Language (SQL) databases. When referring to the product or the server running the product, SQL is pronounced “sequel” and takes the article a when not preceded by Microsoft - for example, “an SQL Server.”
Structured Query Language (SQL)
SQL is a standard interactive and programming language for getting information from and updating a database.
Tags
A tag is a name or a label for a piece of data or a data point. WebWare uses tags to label data on various display pages.
Task scheduler
A Windows utility that can run a script, program or document at a pre-selected time, either on a one-time or repeating basis.
Transfer Control Protocol (TCP)
A protocol used along with the Internet Protocol (IP) to send data in the form of message units between computers over the Internet.
Timers
A software routine that causes the system to trigger an event whenever a specified interval elapsed or at user-defined intervals. Typical timers in WebWare are used to measure cycle time, squeeze time, hold time, etc.
Continues on next page 12
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Continued
Glossary
© Copyright 2008 ABB. All rights reserved.
Continued
Term
Definition
Uniform or Universal Resource Locator (URL)
An address that uniquely identifies a location on the Internet. A URL for a World Wide Web site is preceded with http://, as in the fictitious URL http://www.example.microsoft.com. A URL can contain more detail, such as the name of a page of hypertext, usually identified by the file name extension .html or .htm.
Virtual Directory
A virtual directory is addressed as http://hostname/vdir where vdir is the name of the virtual directory created by the site administrator.
Visual SourceSafe (VSS)
A source code repository program from Microsoft used to store and maintain version control of software components.
WebWare
WebWare is a suite of products that provide a web site for process monitoring, file management, collection of production statistics and diagnostic information. The WebWare family consists of WebWare Server (the web site software) and the WebWare SDK for developing custom factory-floor PC operator stations.
WebWare Backup
A WebWare utility that backs up a robot program or selected robot modules.
WebWare Server
WebWare Server is a standard software product used to present production data, statistics, and diagnostic information collected from S4 robot controllers, HMI applications, and other factory floor automation equipment.
WebWare Server host machine
The computer that is the WebWare Server host computer. The machine where WebWare Server software is installed.
WebWare WebClient
Software that allows a remote computer to browse to the WebWare Server web site. Requires Windows Internet Explorer.
3HAC031360-001 Revision: A
13
© Copyright 2008 ABB. All rights reserved.
Glossary
14
3HAC031360-001 Revision: A
1 Installing ABB WebWare Client 1.1. Overview
1 Installing ABB WebWare Client 1.1. Overview What is ABB WebWare Client?
© Copyright 2008 ABB. All rights reserved.
The ABB WebWare Client is a collection of ActiveX controls that allow you to access the WebWare Server web site and access all of the features of the site. You install ABB WebWare Client on any client computer that will be allowed to browse to the WebWare Server web site.
3HAC031360-001 Revision: A
15
1 Installing ABB WebWare Client 1.2. User Security Settings
1.2. User Security Settings Prerequisites You must have Power User system permissions or higher to download the ABB WebWare Client. Inspecting Security Settings Before attempting to download ABB WebWare Client, inspect Internet Explorer’s security settings to ensure that all components can be downloaded. Follow the steps below to check your systems security settings. 1. Open Internet Explorer. 2. Click the Tools menu and select Internet Options…
© Copyright 2008 ABB. All rights reserved.
3. Click the Security tab. The Internet Options Security dialog appears.
xx0500001597
Continues on next page 16
3HAC031360-001 Revision: A
1 Installing ABB WebWare Client 1.2. User Security Settings Continued 4. Select the correct icon (Internet or Local Intranet) for the type of download you will be performing, then click Custom Level… to inspect the download settings. The Security Settings dialog will be displayed:
© Copyright 2008 ABB. All rights reserved.
xx0500001598
5. Ensure that the following settings are set to Enabled or Prompt before attempting to download ABB WebWare Client (scroll down through the list, if necessary, to locate all of the settings): •
Download signed ActiveX controls (must remain enabled for proper functionality)
•
Run ActiveX controls and plug-ins (must remain enabled for proper functionality)
•
Script ActiveX controls marked safe for scripting
•
File Downloads (must remain enabled for proper functionality)
Apply the security changes (if necessary) and close the Internet Options property page. NOTE: All downloadable ABB ActiveX controls, DLLs, and scripts that are included in the WebWare family are digitally signed for security.
3HAC031360-001 Revision: A
17
1 Installing ABB WebWare Client 1.3. Download the Installation Files
1.3. Download the Installation Files Procedure Follow the steps below to download the ABB WebWare Client software from the server site. 1. From the client computer, navigate to the WebWare Server default page location e.g. http:/ /localhost/webware 2. Depending on which operating system you are running or if browser security settings are set to Prompt, a Security Warning dialog will be displayed since WebWare products are digitally signed to prove their authenticity. Windows 2000 or Windows XP: •
Click Yes to start the installation.
Windows XP Service Pack 2 and Windows Server 2003 Service Pack 1: •
Click More Options and select Always run software...
•
Click Run to start the installation.
3. The WWVerChk3 DLL will download and run. This file will inspect the version of ABB WebWare Client that is installed on the system, and then compare it with the version available for download on the WebWare web server.
Continues on next page 18
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
NOTE: For ABB WebWare Client to function correctly with ABB WebWare Server, the Always run software... option must be selected.
1 Installing ABB WebWare Client 1.3. Download the Installation Files Continued 4. If there is a newer web client version available, a page will prompt you to upgrade the ABB WebWare Client to the newer version. The first time WWVerChk3 runs, it will find no ABB WebWare Client, and the browser will be redirected to the WebWare Client Installation page.
© Copyright 2008 ABB. All rights reserved.
xx0500001601
5. Click the WebWare Client graphic to download the installation file. The File Download dialog will appear. 6. Do one of the following: •
Click Open to install the WebWare Client from the server.
•
Click Save to save the install files to the client computer for installation later.
3HAC031360-001 Revision: A
19
1 Installing ABB WebWare Client 1.4. Install ABB WebWare Client Software
1.4. Install ABB WebWare Client Software Introduction After you have successfully downloaded the client software from the server site, follow the steps below to complete the installation. If you open and install the software directly from the server, follow the steps in the Server Installation Procedure on page 20. If you saved the file to your hard drive, follow the steps in Local Client Installation Procedure on page 20. Server Installation Procedure Follow the steps below to complete the WebWare client installation from the server site 1. If you click Open, a progress bar will appear as the software is installed. 2. After the installer file is downloaded, the Windows Installer will start. 3. When the installer is initialized, the Welcome Screen for the WebWare Client installer will appear. Click Next to continue.
5. The Ready to Install dialog appears. Click Install to continue. 6. A progress bar appears to show the installation progress. 7. When the installation is complete, the InstallShield Wizard Completed dialog appears. Click Finish. Local Client Installation Procedure Follow the steps below to install the client software from the executable that you saved to your client machine hard drive. 1. Navigate to the location where you saved the ABB WebWare Client installation files. 2. Double-click on the setup.exe file to start the installation. 3. The InstallShield Wizard will load, and then the Welcome dialog will appear. Click Next to continue. 4. The License Agreement dialog will appear. Click I agree... and then click Next to continue. Continues on next page 20
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
4. The License Agreement dialog appears. If you accept the terms of the license agreement, click Next to continue.
1 Installing ABB WebWare Client 1.4. Install ABB WebWare Client Software Continued 5. The Ready to Install... dialog appears. Click Install to continue. 6. The Installing... dialog with a progress bar appears to show the installation progress.
© Copyright 2008 ABB. All rights reserved.
7. When the installation is complete, the InstallShield Wizard Completed dialog appears. Click Finish.
3HAC031360-001 Revision: A
21
1 Installing ABB WebWare Client
© Copyright 2008 ABB. All rights reserved.
1.4. Install ABB WebWare Client Software
22
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.1. ABB WebWare Client User Interface
2 Using ABB WebWare Client 2.1. ABB WebWare Client User Interface Introduction
© Copyright 2008 ABB. All rights reserved.
ABB WebWare Client contains all of the controls necessary for navigating the WebWare web site. To illustrate this point, you will notice that all of the Internet Explorer toolbars have been closed for the illustrations in this chapter. In many cases, we have cropped the illustrations to save space.
xx0500001590
The ABB WebWare Client navigation controls are located along the upper part of the browser window as menus, and along the left side of the browser window as the WebWare Device Tree. WebWare Devices are WebWare enabled systems that report data to, or collect data for, the WebWare network server.
Continues on next page 3HAC031360-001 Revision: A
23
2 Using ABB WebWare Client 2.1. ABB WebWare Client User Interface Continued
Overview of Web Site Menus The table below provides an overview of the menus in the WebWare user interface. More detailed descriptions are provided later in the text. Sub-menu
Description
Login
Used to access the login page.
Help
Used to access the online help.
Home
WebWare Welcome page.
Info
Device
Displays information about state and versions for each device in the network.
General
Displays information such as version, company, author and description.
State
Displays information about current state of the robot controller.
User
Displays information that is defined in the RAPID program.
Version
Displays information about system and software versions in the robot controller.
Data Reports
Backup
Displays and filters IO signals. Viewer
Used to view reports.
Manager
Used to manage reports and report modules.
Service
Used to access the Service Information System (SIS).
Control
Used to start or stop manual backups.
Schedule
Used to schedule backups.
Results
Used to view backup results.
Restore
Used to restore backup sets to the robot controller.
Summary
Displays a summary of backups for a selected device.
Documentation Admin
Provides access to robot documentation and other WebWare-related documentation. Settings
Used to change the appearance of the web site.
Devices
Used to manage devices.
Data Collector Setup
Used to download and install software for the Data Collector.
Continues on next page 24
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Menu
2 Using ABB WebWare Client 2.1. ABB WebWare Client User Interface Continued
Menu
Sub-menu
Description
Database
Used to configure database setup and archiving.
Reports
Used to administer custom databases and counter resolution.
Backup
Used to administer backup and restore settings.
Device Tree Icons Several different types of icons can appear in the WebWare Device Tree: Component
Function Plant Model – A logical root to the device tree. The WebWare Plant node is always the top level of the WebWare Device Tree.
xx0500002106
WebWare Data Collector – The second level of the WebWare Device Tree is populated with an entry for each of the WebWare Data Collectors configured on the network. xx0500001623
S4 Robot Controller – The Robot Controller WebWare Device appears when a real or virtual controller is configured on the network. xx0500001624
© Copyright 2008 ABB. All rights reserved.
IRC5 Robot Controller - This icon appears when a real or virtual controller is configured on the network. xx0500001625
OPC Device - The OPC Device icon appears for each OPC server configured on the network. xx0500001626
OPC Alarm - This OPC Alarm icon appears for each OPC Alarm device configured on the network. xx0500001627
OPC Data Access Device - This icon will appear for each OPC Data Access device configured on the network. xx0500001628
File System - This icon will appear for each File System configured on the network. xx0500001629
Continues on next page 3HAC031360-001 Revision: A
25
2 Using ABB WebWare Client 2.1. ABB WebWare Client User Interface Continued Using the WebWare Device Tree, you can browse all the WebWare Devices on the network or select a particular device for remote viewing. In addition, the tree shows the current connection status for all of the devices. Possible values for connection status include: Component
Function No License - The server was unable to assign a license to the device.
xx0500001630
No Backup Module License - The number of backup licenses has been exceeded or not installed. xx0500001861
No Report Module License - The number of report licenses has been exceeded or not installed. xx0500001862
Disconnected - The device interface is not currently available. xx0500001631
Connected - The device interface is available. xx0500001632
Simulated - The device interface is available and configured as simulated. Halted State - The device interface is halted. xx0500001634
Unavailable - A "ghost" device, meaning a device that exsists in the plant model, but is not connected. xx0500001635
Backup in Progress - A backup process is ongoing. xx0500001863
26
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
xx0500001633
2 Using ABB WebWare Client 2.2.1. Login Page
2.2 WebWare ServerModule 2.2.1. Login Page Introduction The login page is displayed when you are required to login to access WebWare Server. Procedure Follow the steps below to log in to WebWare Server.
© Copyright 2008 ABB. All rights reserved.
1. Click Login in the upper right hand corner of the Home page.
xx0500001788
2. Enter your user name and password in the WebWare Login fields. Click Login as shown in the figure above. 3. The Home page will appear.
3HAC031360-001 Revision: A
27
2 Using ABB WebWare Client 2.2.2. Help Page
2.2.2. Help Page Introduction
© Copyright 2008 ABB. All rights reserved.
The help page presents the online help that provides information how to use WebWare Server. You access the information by clicking Help in the top right-hand corner of the WebWare Server web page.
xx0500001789
28
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.2.3. Documentation Page
2.2.3. Documentation Page Overview The Documentation Page contains links to WebWare-related ABB documentation and can be customized to include links to other relevant customer documents. In addition to the WebWare user documentation, there are links to ABB controller documentation, robot product manuals, and RAPID programming reference manuals. The documentation is provided as PDF-files (Portable Document Format). To view this documentation online requires the Adobe Acrobat Reader software installed, which is available as part of the ABB WebWare Client installation or as a free download from Adobe’s web site, http://www.adobe.com. The documentation at the web site is organized into a tree. Click on the tree names to expand and list the conents on the web page. Click on the document link to open and display the selected Acrobat document in a separate window.
© Copyright 2008 ABB. All rights reserved.
The Documentation page can be customized by adding files or including links to files and web pages.
Continues on next page 3HAC031360-001 Revision: A
29
2 Using ABB WebWare Client 2.2.3. Documentation Page Continued
© Copyright 2008 ABB. All rights reserved.
xx0500001790
30
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.2.4. Admin Page
2.2.4. Admin Page Overview
© Copyright 2008 ABB. All rights reserved.
The Admin pages allow you to configure the behavior of the WebWare Server web site. This guide was intended only for client users, so that information can be found in the WebWare Server Administrator´s Guide.
3HAC031360-001 Revision: A
31
2 Using ABB WebWare Client 2.3.1. Overview
2.3 WebWare Report Module 2.3.1. Overview Introduction The WebWare Report Module is a licensed option that provides a report generator that allows you to choose data sources from a list of available timers and counters, select a report graphic style, and apply custom labels, headers, footers and explanatory text. Reports are printable, and can be saved as templates for future use.
32
•
Create new reports
•
Customize report appearance
•
Save reports as templates
•
Customize data generation criteria
•
Display the reports as a part of a web page
•
Add textual information to the report page in the form of HTML snippets
•
Select a report from a list of existing reports and run the report
•
Preview the display elements of the report before running it
•
Select a report from a list of existing reports and edit the report
•
Create Custom Queries that query the WebWare database and return the data to be assembled into a table or chart for display
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
With WebWare Reports, you can:
2 Using ABB WebWare Client 2.3.2. Info Page
2.3.2. Info Page Overview The WebWare Info page displays fundamental information about the WebWare network or selected devices on the network. WebWare Server Device Counts
© Copyright 2008 ABB. All rights reserved.
Highlight the WebWare Network node on the tree. The content pane will display a list of device counts for the devices on the network. This is a handy way of checking the relative health of the network.
xx0500001666
Data Collector Device Counts You can also highlight an individual Data Collector to display the Data Collector Device Counts page to view the connection status of the devices connected to that Data Collector.
Continues on next page 3HAC031360-001 Revision: A
33
2 Using ABB WebWare Client 2.3.2. Info Page Continued
WebWare Device Information Highlight any device on the tree other than the network node. The Info page for that device will appear. The data shown in the figure can be assigned using one of three methods: If the WebWare Device is a real or virtual controller, the values can be set from RAPID using functions available in the WebWare System Module (WEBWARE.SYS).
•
If the device is a WebWare Client Application, the values can be set using the WebWare ActiveX control. For more information about creating WebWare Client Applications, refer to the WebWare SDK online help.
•
If the device is an OPC Device, these values are configured using the Device Configuration Utility. For complete details, see Configuring the Device Configuration Utility (DCU) in the Device Configuration Utility help file.
© Copyright 2008 ABB. All rights reserved.
•
xx0500001667
Continues on next page 34
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.2. Info Page Continued Robot devices have an additional view page available. The data shown is extracted from the robot controller and provides controller version and state information.
© Copyright 2008 ABB. All rights reserved.
xx0500001668
Info Page Views The Info page provides sub-menues to display an overview of information extracted from the robot controller. A brief introduction of the content of each page view is listed here. Menu General
Information Displayed • • •
•
•
Status - connection state of the device. Icons indicate the device connection status. Version - the user-defined version (usually a WebWare Client Application). Company - the user-defined company name (usually defined in a WebWare Client Application or from OPC Device tags). Author - the user-defined Author name (usually defined in a WebWare Client Application or from OPC Device tags). Description - the user-defined description name (usually defined in a WebWare Client Application or from OPC Device tags).
Continues on next page 3HAC031360-001 Revision: A
35
2 Using ABB WebWare Client 2.3.2. Info Page Continued
State
Information Displayed • • • • • •
User
• •
Version
• • • • • •
36
Status - connection state of the device. Icons indicate the device connection status. Operation - the operational state of the device (Automatic, Manual, etc.). Program - the operational state of the device program (Loaded, Initialized, etc.). Control - the operational state of the robot controller (E-Stopped, Auto, etc.). Prog/Ctrl - the operational state of the device program (Stopped, Auto, etc.). Interface - indicates whether the device interface is connected, disconnected or disabled. Status - connection state of the device. Icons indicate the device connection status. User Defined fields - these fields are all defined by the user.. Status - connection state of the device. Icons indicate the device connection status. Boot - the EEPROM version number (controller BIOS). RAP - indicates the version of RAP running on the robots. System - indicates the robot operation system version installed. Pendant - the Teach Pendant hardware and software version numbers. Control ID - the robot serial number..
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Menu
2 Using ABB WebWare Client 2.3.3. Data Page
2.3.3. Data Page Overview
© Copyright 2008 ABB. All rights reserved.
The Data Page displays data from the selected Robot Alias or OPC Device. No data is currently displayed from the WebWare Client Application.
xx0500001669
Robot I/O Configuration File For S4 robots, the robot I/O configuration file must be loaded into the Device Configuration Utility (DCU) on the WebWare Data Collector for the robot I/O to be displayed in the WebWare Client interface. To learn more about this procedure, refer to the Device Configuration Utility help file. For IRC5 robots, robot I/O is displayed automatically and does not need to be configured.
Continues on next page 3HAC031360-001 Revision: A
37
2 Using ABB WebWare Client 2.3.3. Data Page Continued
Views All of the I/O and variable data are dynamic and are updated when the WebWare Client receives new information about the device. The Views drop-down list allows you to select from digital I/O, analog I/O, group I/O, board and RAPID (perssistent data, variable data and constants). Each signal or variable is placed on a line in the table. Click the column header to sort the data in any column in ascending or descending order. Filters You can simplify the data view of the selected device by choosing one of the available filters. You can display different signal views, such as: •
All signals
•
Digital signals only
•
Analog signals only
•
Group signals only
•
Board signals only
•
RAPID program data only
•
All inputs and outputs
•
Outputs only
•
Inputs only
© Copyright 2008 ABB. All rights reserved.
You can filter the views by:
Continues on next page 38
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.3. Data Page Continued The figure below illustrates how to select a filter from the drop down menu.
xx0500001670
© Copyright 2008 ABB. All rights reserved.
Column Header Definitions The table below defines the column headers for the robot I/O data page. Component
Function
Name
I/O name.
Container
• •
For I/O signals: Controller board name. For RAPID variables: Not used.
Data Type
Type of signal. Possible values are: • Digital I/O • Analog I/O • Digital Group I/O • Analog Group I/O • RAPID variable types (bool, num, string, etc.).
Data State
Connection state of the signal. Possible values are: • Connected • Not Connected
Continues on next page 3HAC031360-001 Revision: A
39
2 Using ABB WebWare Client 2.3.3. Data Page Continued
Component
Function
Value
Current value of the I/O. For digital I/O, possible values are 0 and 1. For analog I/O, possible values are dependent on the type of signal being measured. A question mark indicates a disconnected signal.
Modified
Date the I/O parameters were last modified.
Quality
Quality of the data. Possible values are: • Good (Connected) • Bad (Disconnected)
RAPID Persistent Variables
Each row of the variable view is formatted with the columns containing the variable name, type, status, and value. If the variables are registered properly and the RAPID program is executing, the variable status is Connected, and values will be updated dynamically as they change. If the variables are not registered properly or the RAPID program is not currently executing, the variable status is Not Connected. The status values are defined in Return Status Codes in the System Reference section. OPC Device The Data Page displays the tag data for the selected OPC Device. Component
Function
Name
I/O name.
Container
Not used.
Data Type
Tag data type. Possible values are: • Native Type • Bool • Short • Long • Double • String
Continues on next page 40
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
The Data page RAPID view displays bool, num, or string RAPID persistent variables that have been registered in the Variable Subscriptions tab in the Device Configuration Utility on the device Data Collector. Information about setting up variables on the Data Collector can also be found in the Device Configuration Utility help file.
2 Using ABB WebWare Client 2.3.3. Data Page Continued
Function
Data State
Connection state of the signal. Possible values are: • Connected • Not Connected
Value
Varies depending on the tag data type. A question mark indicates a disconnected signal.
Modified
Date the I/O parameters were last modified.
Quality
Quality of the data. Possible values are: • Good (hex value of C0) • Bad (any other common OPC hex value 00, DF, AB, etc.)
© Copyright 2008 ABB. All rights reserved.
Component
3HAC031360-001 Revision: A
41
2 Using ABB WebWare Client 2.3.4. Report Viewer Page
2.3.4. Report Viewer Page Introduction
xx0500001676
Screen Components The table below describes the function of the screen components that appear on the Report Manager page.
42
Component
Function
Reports List Box
Lists the reports currently on the server ready to be viewed.
Magnifying Glass Icon
Select a report and click the magnifying glass icon to view a report in the list.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
The Report Viewer page allows you view reports that you have created.
2 Using ABB WebWare Client 2.3.5. Report Manager Page
2.3.5. Report Manager Page Introduction
© Copyright 2008 ABB. All rights reserved.
The Report Manager page allows you to: •
Add new reports
•
Edit existing reports
•
Remove existing reports
•
Edit existing modules
•
Remove existing modules
xx0500001677
Screen Components The table below describes the function of the screen components that appear on the Report Manager page. Component
Function
Reports List Box
Lists the reports currently on the server ready to be run.
“+” Icon
Click to add a new report or module to the list. Opens the Report Builder page.
Continues on next page 3HAC031360-001 Revision: A
43
2 Using ABB WebWare Client 2.3.5. Report Manager Page Continued
Component
Function
Modules List Box
Lists the modules (report components) on the server that can be assembled to form a report, or opened and edited.
Pencil Icon
Click to open the selected item for editing.
“X” icon
Click to delete the selected item from the server. Click to import a report pack onto the WebWare Server host machine.
xx0500001678
Click to export selected reports and modules as a WebWare Server report pack.
© Copyright 2008 ABB. All rights reserved.
xx0500001679
44
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.6. Report Builder Page
2.3.6. Report Builder Page Introduction
© Copyright 2008 ABB. All rights reserved.
The Report Builder Page provides five panes in which to place various components such as chart modules, labels and explanatory text (HTML code snippets), titles, captions, etc.
xx0500001680
Screen Components The Item Numbers in the table below correspond to the callout numbers in the figure above. No.
Component
Function
1
Reports Submenu
Allows access to all Report functions.
2
Report Box
Displays the default name of the report that you will build.
3
Description Box
Displays a user-defined description.
4
Add menu
Click on a link to add a component to your report.
5
Panes
Panes are the pre-defined containers that locate modules on your report page.
Continues on next page 3HAC031360-001 Revision: A
45
2 Using ABB WebWare Client 2.3.6. Report Builder Page Continued
Component
Function
6
Right Arrow/Left Arrow
Move the highlighted element listed in the pane to the pane to the right or to the left, depending on the arrow you click on.
7
Up Arrow
Move the highlighted element up in the current pane. If the item is the uppermost item in the pane, move the element to the next pane above on the page.
8
Down Arrow
Move the highlighted element down in the current pane. If the item is the lowermost item in the pane, move the element to the next pane below on the page.
9
Pencil
Edit the selected item in a pane.
10
“X”
Delete the selected item from the pane.
11
Finish
Click to save the report on the server.
12
Cancel
Click to cancel the report build process. Clears all panes on the Report Builder page.
© Copyright 2008 ABB. All rights reserved.
No.
46
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.7. How to Build a Report
2.3.7. How to Build a Report Introduction You build reports from modules that you select from the list available to you from WebWare Server. You can create new modules or modify existing modules to collect and display exactly the data you need. Procedure Follow the steps below to create a WebWare report. 1. Click on the Reports menu. The Reports submenu and the Report Viewer Page will appear. 2. Click on the Manager submenu. The Reports Manager page appears. 3. Click: •
+ (plus sign) to create a new report
•
pencil icon to select an existing report from the list for editing
•
on the X to delete any selected report or module
© Copyright 2008 ABB. All rights reserved.
4. The Report Builder page will appear. Choose the first module that will appear in your report. Click on one of the links in the Add: box: •
Chart - to add a bar chart or line chart
•
HTML - to add a block of HTML code
•
Table - to add a table of selected data sources and values
5. The “Definition” page for the item you selected will appear. Click on either: •
New - to create a new module for your report. For more details, see How to Add an HTML Module to Your Report on page 73 and How to Create a Chart/Table Module on page 52.
•
Existing - to add an existing module already on the server to your report. For more information, see How to Add an Existing Module to Your Report on page 51.
6. Repeat steps 4 and 5 until your report is complete. 7. Enter a new report name in the Report Name field.
Continues on next page 3HAC031360-001 Revision: A
47
2 Using ABB WebWare Client 2.3.7. How to Build a Report Continued 8. Enter any descriptive comments in the Report Description field. 9. Click on: Save - to save the completed report on the server under the name in the Reports: list box.
•
Cancel - to blank all panes in the Report Builder and return to the Report Manager page
© Copyright 2008 ABB. All rights reserved.
•
48
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.8. How to Edit Reports You've Created
2.3.8. How to Edit Reports You've Created Procedure Follow the steps below to edit an existing report 1. Open the Reports Manager page and highlight the report that you wish to change. 2. Click on the Pencil icon. The Report Builder page will open. 3. All of the selected modules in the report will display in the various report panes. To: •
Move the modules around, select a module and then click on the appropriate Arrow links until the module appears in the desired pane.
•
Delete a module or modules, select a module to be deleted and then click on the X next to the pane.
•
Edit a module, highlight the desired module and click on the Pencil icon. The appropriate module screens will appear.
•
Add a new module to the report, click on one of the links in the Add box. The appropriate module builder page will appear.
© Copyright 2008 ABB. All rights reserved.
4. When you have finished, click the Finish link at the bottom of the page.
3HAC031360-001 Revision: A
49
2 Using ABB WebWare Client 2.3.9. How to Run a Report
2.3.9. How to Run a Report Procedure Follow the steps below to select and run an existing WebWare Server report 1. Click on the Reports menu. The Reports submenu and the Report Viewer page will appear. A scroll bar will appear if there are more reports available than fit in the list box. 2. Select a report from the list and click the magnifier link. WebWare Server will run the report and display the results on the screen. 3. If you are not satisfied with the results, click the Options link below the title bar on the page. Use the options provided to tailor your results. If no options appear, the report designer removed the [User Defined] criteria from the Query Builder page when he or she designed the report. In order to modify the report, you will have to open the report in the Report Manager page and modify the report as needed.
© Copyright 2008 ABB. All rights reserved.
4. If you make any modifications to the report options, click Refresh to run the report again with the new options.
50
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.10. How to Add an Existing Module to Your Report
2.3.10. How to Add an Existing Module to Your Report Procedure Follow the steps below to add a Chart, HTML or Table module to your report 1. From the Report Builder page, click on a module link (Chart, HTML or Table) in the Add: box. 2. When the Chart, HTML or Table Definition page appears, click on Existing. Click Next. 3. Choose the module you want from the list box that appears. 4. Click: Back - to return to the previous page.
•
Finish - add the module to the center pane of the report on the Report Builder page.
•
Cancel - to return to the Report Builder page and blank all panes in the Report Builder.
© Copyright 2008 ABB. All rights reserved.
•
3HAC031360-001 Revision: A
51
2 Using ABB WebWare Client 2.3.11. How to Create a Chart/Table Module
2.3.11. How to Create a Chart/Table Module Procedure Follow the steps in the table below to create a new chart or table module. Each of the steps below is further explained in topics that are linked from the steps below. 1. Set up the chart/table parameters. For more information, see How to Set Up Chart/Table Parameters on page 53. 2. The Query Builder page appears. Use the Query Constructor to create your database query. For more information, see How to Build a Database Query on page 54. 3. Select the Design-Time and User-Defined Options to use when the chart/table is created. For more information, see How to Use the Query Builder Page on page 55. 4. Click the Options link and apply the formatting that you wish to add to your chart/table. For more information, see How to Apply Design-Time Options on page 68. 5. Preview the data that will be used to create the chart and/or preview the finished chart/ table.
© Copyright 2008 ABB. All rights reserved.
6. Click Finish to save your chart/table, and then click Finish again to save the Report containing the chart/table module you just created.
52
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.12. How to Set Up Chart/Table Parameters
2.3.12. How to Set Up Chart/Table Parameters Procedure Follow the steps below to set up the chart name and data source for your new chart. 1. From the Report Builder screen, click on the appropriate link for the module you will add. Available modules are: •
Chart
•
HTML
•
Table
2. When the Chart/Table Definition page appears, click New. 3. Click Next. The next Definition page appears. 4. Click on the Name field and enter the file name for the module. 5. Click on the Title field and enter the title that will appear on the chart/table when it is displayed on the screen. 6. Click Next. The Data Source Selection list box appears.
© Copyright 2008 ABB. All rights reserved.
7. Select from one of the categories (database tables) to query. You can query from one of the following tables: •
Counters
•
Timers
•
Log Events
•
OPC Alarms and Events
•
Custom WebWare database tables
8. Click Next. The Query Builder page appears. Complete the database query. For more information, see How to Build a Database Query on page 54.
3HAC031360-001 Revision: A
53
2 Using ABB WebWare Client 2.3.13. How to Build a Database Query
2.3.13. How to Build a Database Query Procedure Follow the steps below to build a query for the WebWare database 1. Navigate to the Query Builder page. 2. Use the default fields that appear or choose the fields that you wish to use from the Add Field list box. 3. Click on the corresponding X button to remove any unwanted fields from the query. 4. If necessary, edit the Field row names to edit the column headers in the table that will be created. 5. Click on the View list box to choose the view property to be applied to the data. 6. Click on the Sort list box to choose either ascending or descending sort for the values for the selected item. 7. Determine whether the column should appear in the final table. Check the Output check box if you wish the column to appear in the finished column.
9. IGo on to apply Design-Time Options to your chart. For more information, see How to Apply Design-Time Options on page 68.
54
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
8. If the field allows criteria filtering, the Criteria field will appear in the query table. Enter the criteria that you wish to filter the field by.
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page
2.3.14. How to Use the Query Builder Page Introduction The Query Builder page allows you to create custom queries against any of the standard report categories (alarms, counters, events, custom WebWare databases or timers).
© Copyright 2008 ABB. All rights reserved.
You use queries to build the chart and table modules for your report. The queries that you build can be used to sort the data, perform calculations, or apply criteria to return the desired results. You can then save the Chart or Table modules you create for later use.
xx0500001681
User Interface Components The table below lists the functions of the components on the Query Builder page. The Item Numbers in the table below correspond to the callout numbers in the figure above. No
Component
Function
1
Design Pane
Click to open or close the query constructor.
Continues on next page 3HAC031360-001 Revision: A
55
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page
No
Component
Function
2
Field Name
These are the standard fields available to make up your query. To see all available standard fields for the query you are creating, click Add Field.
3
Description
User defined name for the column heading in the generated table.
4
View
Perform simple operations on a field. For example, you can perform average, count, sum, etc. operations on numerical fields. The only operation that you can perform on string fields is the count operation.
5
Sort
Click the down arrow to select a sort option from the list. Available sort options are: • Ascending • Descending • None
6
Output
Click this check box to output the data. Leave this check box blank to process the data but not display this column of the query in the final results.
7
Format
Used only for timer queries to select the display units (hours, minutes, etc.) for the value field.
8
Criteria
If the criteria choices are available, click the down arrow to display the list of available choices. If the criteria field is editable, click on the field and enter the criteria to sort the data by. For details, see Refining a Query on page 60.
9
Add Field list box
Click on the arrow button and select a field to add to the query. The new field will be added to the right-hand side of the existing query. Use the arrow buttons to move the field to its correct position.
10
Options Link
Click to open the design-time Options pane.
11
Result Link
Click to open the Result pane.
12
Right Arrow/Left Arrow
Move the module to the right or to the left, depending on the arrow you click on.
13
“X”
Delete the selected item from the pane.
Continues on next page 56
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Continued
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page Continued
No
Component
Function
14
Back
Return to the Query Definition page. You will lose any changes you made to the query.
15
Finish
Save the changes you made to the Query and return to the Report Manager page.
16
Cancel
Discard any changes made to the Query and return to the Report Manager page.
Basic Concepts The query builder is designed to conceal some of the difficulties with creating SQL queries. In order to prevent you from getting bogged down in the details, some of the power of SQL is cloaked in the WebWare Server Query Builder interface. Because of the compromises that were made, some queries cannot be created via the query builder. To create a readable chart, follow these guidelines: •
Make the data set fairly small (less than 25 items)
•
Make the first column in the query a text field. Make the next 1 - 5 columns numeric.
© Copyright 2008 ABB. All rights reserved.
One of the most important things to remember about the WebWare Query Builder page is that the sort order applies to all columns in the query, from left to right.
Continues on next page 3HAC031360-001 Revision: A
57
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page Continued
Building a Query The query builder attempts to create a well-structured query by gathering user input for each field allowed for a typical type of a query. In WebWare's query building tool, the SELECT statement is configured in a two step procedure. First step is to select which type of data to query (counter, timer, etc.). Second step is to add/remove needed fields. There are four standard types of data in the WebWare Database. The WebWare query builder also allows users to query custom databases created by various WebWare controls or RAPID programs. The remainder of this section focuses only on the four standard types of data: •
Counters
•
Timers
•
Log Events
•
OPC Alarm and Events
© Copyright 2008 ABB. All rights reserved.
The illustration below shows the page where you can select the data source for your query.
xx0500001682
Continues on next page 58
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page Continued As an example, if you decide to query Counter data, WebWare automatically selects the unique fields available for Counter type data. For counters you select from the following fields: •
Device Name
•
Device Class
•
Device Type
•
Counter Name
•
Time
•
Value
A query can have duplicate fields. Each of the standard data types has a set of unique fields taken from a defined set of tables. This is different from Microsoft Access, where you build a query by selecting the tables to be included in a query.
© Copyright 2008 ABB. All rights reserved.
Manipulating the Query Columns Use the components listed below to modify the order of the columns in the query. Component
Function
Left Arrow
Click to move the selected column to the left one column.
X
Delete the column from the query.
Right Arrow
Click to move the selected column to the left one column.
Add Field list box
Select a column from this list box to add to your query. The column will be appended to the right side of the query.
Configuring the Data Shown Use the components listed below to configure the output results. Component
Function
Description field
Enter the column header text here.
View list box
Choose from available view properties here.
Sort list box
Choose either ascending or descending table record sort here.
Output check box
Check to show output in resulting table. Remove check to process data but not display results in final table.
Continues on next page 3HAC031360-001 Revision: A
59
2 Using ABB WebWare Client 2.3.14. How to Use the Query Builder Page Continued
Component
Function
Format list box
If the field contains information that can be formatted in multiple ways (timer data can be displayed in various time units, for example) this list box will appear and be populated with appropriate options.
Criteria text box
Enter the criteria to filter the results by here.
Refining a Query After you have selected a query type and the fields that you need in your query, you may have to refine the query to display only the data you are interested in. For example, you may want to create a query that displays values for just one counter, or for errors that occurred during a certain time span. It is simple to create queries that exclude/include certain text strings or a range of numbers. For example, in the Counter Query there is a field named Value. To refine a query to return all counters that contain a value greater than twenty and less than one hundred would be written using this syntax: >20 AND
greater than
=
greater than or equal to
Configuration Editor... The Configuration Editor appears. 7. From the Type name window, select Application Protocol. 8. A list of configured communication protocols is displayed. •
If an entry for NFS exists, double click the entry and go on to step 12.
•
If no entry for NFS exists, go on to step 9.
9. Right click Application Protocol and select Add Application Protocol. NOTE: If Add Application Protocol is not selectable; on the Controller menu, select Request Write Access. 10. The Edit Application protocol(s) dialog appears. Highlight the Name parameter and enter a new name in the Value box (e.g. "NFS").
Continues on next page 92
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
4. The System Parameters appears. Expand the Configuration tree by clicking the plus sign.
2 Using ABB WebWare Client 2.4.5. How to Configure an NFS Mount for an IRC5 Robot Continued 11. Highlight the Type parameter and select NFS from the drop-down list in the Value box. NOTE: If NFS is not displayed in the list the robot software option is not installed and therefore cannot be used. 12. Highlight the Transmission protocol. From the Value box drop-down list, select the protocol that you will use, e.g. "TCP/IP". 13. Highlight Server address and enter the text string for the Data Collector IP address e.g.“130.110.69.222”. NOTE: This address must be a fixed IP Address! 14. Highlight Local Path. Enter a meaningful name for the Local Path (“pc:” is default), the name that will be used to identify the mount on the robot. 15. Highlight Server Path. Enter a meaningful name for the Server Path, the name that will be used to identify the robot on the NFS device. The path must include the forward slash (/). NOTE: For WebWare Server you must set the path to "/" (without the server path), which is the root of the backup directory. 16. Click OK to close the Edit Application protocol(s) dialog.
© Copyright 2008 ABB. All rights reserved.
NOTE: The changes of the parameters will not take place until the controller is warm-restarted. 17. After the controller restarts, verify that the robot has successfully mounted the NFS device.
3HAC031360-001 Revision: A
93
2 Using ABB WebWare Client 2.4.6. How to Configure NFS at the Device Configuration Utility
2.4.6. How to Configure NFS at the Device Configuration Utility Procedure Follow the steps below to enable NFS for the selected robot alias in InterLink. 1. From the Tools menu, select Configure NFS.
xx0500001694
xx0500001695
3. Click OK. The message shown in the previous figure indicating that the computer must be rebooted will appear. 4. Reboot the computer. The NFS function is now enabled in InterLink. 5. If necessary, restart DCU and define an alias for the robot. IMPORTANT: You must define an alias for the robot before NFS will work. No special profile settings are required for that alias. If no alias is defined, or if NFS is disabled, all NFS mounts are rejected and an error is reported at the robot controller.
94
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
2. The NFS Configuration dialog appears. Select Enable NFS.
2 Using ABB WebWare Client 2.4.7. Backup Control Page
2.4.7. Backup Control Page Overview The buttons on this page allow you to control a backup. You may start or abort selected backups, (where you have selected individual data elements such as only robot programs, etc. to backup), or start backups of a device set.
© Copyright 2008 ABB. All rights reserved.
Note that backing up many devices at the same time will increase network traffic that could become a problem.
xx0500001704
Continues on next page 3HAC031360-001 Revision: A
95
2 Using ABB WebWare Client 2.4.7. Backup Control Page Continued
Screen Components The buttons on the Backup Control page are defined on the page. The Backup Comment text field can be used to add a comment of up to 1024 characters to a manual backup of a device set or selected devices. The comment along with the user name and backup task are stored in the WebWare database. The Backup Summary items in the table below represent a snapshot of the backup status of all the devices in the tree that can be backed up. Current Backup Status Component
Function
In progress:
This is the number of devices that have a backup in progress at the present time. You might have multiple selected backups scheduled, and the number of backups remaining will appear in this field.
Idle
This is the number of device that are in an “Idle” backup state. These devices may or may not be available for backup.
96
Component
Function
Successful
This is the number of backups that completed successfully.
Error during backup
This is the number of backups that completed with errors. Go to the Backup Results page to examine the error details.
Failed
This is the number of backups that failed due to time-outs, etc.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Last Backup Status
2 Using ABB WebWare Client 2.4.8. How to Use On-Demand Backups
2.4.8. How to Use On-Demand Backups Overview In addition to scheduling automated backups, you can also manually control backups through the Backup Control page. Procedure 1. Open the browser and point it to the WebWare web site.
© Copyright 2008 ABB. All rights reserved.
2. From the WebWare menu. The Backup Control page appears.
xx0500001704
3. To backup one or more single devices: •
Select the devices to be backed up by clicking on the corresponding checkboxes next to the devices in the device tree pane.
•
Click Start Selected Backup or Start Full Backup to begin backing up files immediately.
To backup a Device Set: •
Select the Device Set to be backed up from the drop-down list.
•
Click Start Device Set to begin backing up files immediately. Continues on next page
3HAC031360-001 Revision: A
97
2 Using ABB WebWare Client 2.4.8. How to Use On-Demand Backups Continued
Aborting Backups Once you have clicked the Start Selected Backup command button, the check boxes only indicate the devices that will be backed up. Simply uncheck-ing a box will not prevent the corresponding device from being backed up, once you have clicked a Start button. To abort the backup of a Selected Device for any reason, uncheck the box corre-sponding to devices that will be backed up, make sure the check the box(es) of the device(s) that will be aborted are checked, then click the Abort Selected Backups button.
© Copyright 2008 ABB. All rights reserved.
To abort the backup of all of the Selected Devices or a Full Backup for any reason, click the Abort All Backups button.
98
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.9. Backup Tips
2.4.9. Backup Tips Backup Tree View Use the Backup Tree View to monitor backup progress or spot problems quickly. The backup tree view displays the results of the last backup, and changes while a backup is under way, to show progress and/or error conditions. The table below shows an example of what happens before, during and after a manual backup is performed on a single robot. Before… The backup has not been run. Notice the Final Status of Successful and the Start Date, indicating the last date the backup was run.
xx0500001705
© Copyright 2008 ABB. All rights reserved.
During… The backup status messages appear as the backup process initializes, checks the robot state and then actually begins the backup. Notice that the Final Status and Duration blank out, indicating that the backup process is underway.
xx0500001706
Continues on next page 3HAC031360-001 Revision: A
99
2 Using ABB WebWare Client 2.4.9. Backup Tips Continued After... After the backup completes, the Final Status and Duration appear.
© Copyright 2008 ABB. All rights reserved.
xx0500001707
100
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.10. Backup Status Messages
2.4.10. Backup Status Messages
© Copyright 2008 ABB. All rights reserved.
Backup State Messages The table below lists the messages that appear in the backup view at the WebWare Server device tree during a backup session. The table also lists the related ID that is displayed in the Backup Log. ID
Message
Task/Event
What You Should Do
1
No license
2
Idle
No backup is running.
Normal State - no action required.
3
Initializing
Backup is configured and started.
Wait.
4
Mode check
Initialization is complete. Waiting for Auto Mode at the robot.
Wait/Set robot to AUTO.
5
Cycle stop check
Waiting for ww_StopProgram to be true, so that the robot program can be stopped.
Wait.
6
Wait cycle stopped
Waiting for program to stop. Wait/Stop robot program.
7
Save full system
WebWare Server is now performing a standard backup.
8
Save program
WebWare Server is now Wait. backing up selected RAPID programs.
9
Save modules
WebWare Server is now Wait. backing up selected RAPID modules.
10
Save configuration
WebWare Server is now Wait. backing up selected configuration parameters.
11
Save log files
WebWare Server is now backing up selected log files.
Install a WebWare Server License. See License Administration Page and License Key Request Process.
Wait.
Wait.
Continues on next page 3HAC031360-001 Revision: A
101
2 Using ABB WebWare Client 2.4.10. Backup Status Messages Continued
ID
Message
Task/Event
What You Should Do
12
Save disk files
WebWare Server is now Wait. backing up the robot ramdisk/flashdisk contents.
13
Commit to NFS
NFS is being initialized.
14
Push to Server
The command is sent to Wait. WebWare Server to receive files.
15
Wait push completed
Files are moved from the data collector to the WebWare Server network server computer.
Wait.
16
Completed
Backup was completed successfully.
This message usually flashes by so quickly that you cannot see it. The system is now ready for the next backup.
Backup Final State Messages The table below lists the messages that appear in the final results table on the WebWare Server Backup Results page. The table also lists the related ID that is displayed in the Backup Log. For details, see How to Display Backup Results on page 113. ID
Message
Task/Event
What You Should Do
1
Successful
The backup session completed successfully, without errors.
No action to take - check the File Manager Data folder if you want to examine the backup data. If the system backs up to a SourceSafe database, open SourceSafe to examine the files.
2
Completed with errors
The backup session Use the WebWare Server completed successfully, but Results Page to examine errors occurred. the errors and determine what course of action to take.
Continues on next page 102
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
This message will usually flash by so fast that you will not see it.
2 Using ABB WebWare Client 2.4.10. Backup Status Messages
© Copyright 2008 ABB. All rights reserved.
Continued
ID
Message
Task/Event
What You Should Do
3
Aborted
Backup was cancelled by Use the Backup Control the user (clicked one of the page to initiate a backup or Abort buttons). wait for the next scheduled backup, if one is scheduled.
4
Failed
An external event caused the backup to fail.
5
Timeout
The backup session did not Investigate the problem or complete within the timeout initiate another backup period set at the WebWare session. Server Backup Schedule page.
6
Not configured
No backup is configured for Go to the DCU. the selected robot. Select the robot profile and click Edit Profile. Click the Backup file set tab and select the backup parameters needed.
7
No license
8
DC COM error
WebWare Server has attempted to start a backup on a data collector (DC) that does not exist.
9
Simulated mode
The robot alias is set to Either ignore this message simulate the interface at the or correctly configure the DCU. alias at the ICU (remove the Simulate Interface selection).
10
No Alias found
The robot alias selected at WebWare Server for backup does not exist at the DCU.
Restart the system or investigate the problem.
Install a WebWare Server License. See License Administration Page and License Key Request Process. Check network connections. Make sure the Data Collector is operating properly.
Use the WebWare Server Admin Page to delete the alias or configure the alias at the DCU.
Continues on next page 3HAC031360-001 Revision: A
103
2 Using ABB WebWare Client 2.4.10. Backup Status Messages Continued
Message
Task/Event
What You Should Do
11
In progress
Backup is cancelled before Redo the backup. Backup it is completed. folders are created in the robot’s File Manager Data folder, but they are empty. You may want to delete the empty folders.
12
Not run
Backup has never been run Run a backup session. on this system.
13
DC Not connected
The Data Collector (DC) computer is disconnected from the WebWare network.
Check network connections. Make sure the Data Collector is operating properly.
14
Timeout Init
The backup session timed out before the initialization step was completed.
Check the interface connections between the network server and the Data Collector.
15
Timeout Robot Ready Wait The backup session timed out before the robot status checking steps were completed.
16
Timeout Robot Ready
The backup session timed out before the robot indicated that it was ready to backup. The session timed out before the ww_backupOK variable was set.
17
Timeout Connection Wait
The backup session timed Make sure the network out because the connection connections are communito the robot was lost. cating.
18
Timeout Auto Mode Wait
The backup session timed out before the robot was placed in Auto mode.
19
Timeout Backup
The actual backup steps Investigate the problem or did not complete within the initiate another backup timeout period set at the session. WebWare Server Backup Schedule page.
This could be related to RAPID programming. Increase the timeout interval at the Backup Control page.
Make sure robot is placed in Auto Mode.
Continues on next page 104
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
ID
2 Using ABB WebWare Client 2.4.10. Backup Status Messages Continued
Message
Task/Event
What You Should Do
20
Timeout Cycle Stop Check
The backup session timed Make sure out while waiting for ww_StopProgram is being ww_StopProgram to be set set to TRUE. to TRUE.
21
Timeout Stopping Cycle
The backup session timed Look for external factors out while waiting for the that may be restarting the robot to reach a cycle stop. robot program (PLC's, SDK apps, etc.)
© Copyright 2008 ABB. All rights reserved.
ID
3HAC031360-001 Revision: A
105
2 Using ABB WebWare Client 2.4.11. Backup Schedule Page
2.4.11. Backup Schedule Page Overview
xx0500001708
Screen Components The Backup Schedule page has the following components:
106
Component
Function
Sort by list
This drop-down list lets you sort the list of scheduled backups according to Device Set, Frequency and Time
+ icon
Add a new scheduled backup.
Pencil icon
Edit the selected scheduled backup.
X icon
Delete the selected scheduled backup.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
The Backup Schedule page presents an overview of configured backup schedules. You may sort, add, edit or delete schedules in the list.
2 Using ABB WebWare Client 2.4.12. Schedule Manager Page
2.4.12. Schedule Manager Page Overview You use the Schedule Manager page to schedule automated backups of the devices or device sets on the WebWare network at the date, time and frequency you select.
© Copyright 2008 ABB. All rights reserved.
NOTE: Backups scheduled to run the 31st of each month will only run in months with 31 days.
xx0500001709
Screen Components The Backup Schedule page has the following components: Component
Function
Device set list
This list box contains all of the available named groups of devices (device sets) that have been created.
Start Time list
This list box contains all of the start times that have been entered into the system. Displayed with either 24-hour format or AM/PM-format depending on the Regional Settings.
Continues on next page 3HAC031360-001 Revision: A
107
2 Using ABB WebWare Client 2.4.12. Schedule Manager Page
Component
Function
Frequency list
This list box contains all of the settings that determine how often a scheduled backup is performed, for details see Frequency Details on page 108. Available options include: • Once • Daily • Weekly • Monthly
Run backup on check-box
Here you set the date or set which day(s) of the week the backup will run. The display changes depending on the selected Frequency.
Apply
Click apply to add the new scheduled backup to the list of scheduled backups without returning to the Scheduled Backup page.
OK
Click OK to add the new scheduled backup to the list of scheduled backups and return to the Scheduled Backup page.
Cancel
Click Cancel to return to the Scheduled Backup page without adding the Scheduled Backup.
Comment text box
Add a comment to a scheduled backup of a device set. The comment along with the user name and backup task are stored in the WebWare database.
Frequency Details If Once is selected from the Frequency drop-down-list, you may select a start time and a date for the backup. If Daily is selected from the Frequency drop-down-list, you may select a start time. If Weekly is selected from the Frequency drop-down-list, you may select a start time and which weedays the backup will run. If Monthly is selected from the Frequency drop-down-list, you may select a start time and either the day of the month to run the backup, or the first, second, third, fourth or last specified weekday of the month(s).
108
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Continued
2 Using ABB WebWare Client 2.4.13. How to Schedule Backups
2.4.13. How to Schedule Backups Procedure Follow the steps below to schedule a robot backup. The procedure below configures WebWare Server to backup the entire network at the scheduled time that you select. 1. Configure the robot profiles for the robots that will be backed up using the DCU. 2. Open the browser and point it to the WebWare web site. 3. From the Backup submenu, click on Schedule. The Backup Schedule page appears. 4. Click + to add a scheduled backup. The Schedule Manager page appears. 5. Select the Device Set, Start time and Frequency for that backup to occur. For details about backup frequency, see Frequency Details on page 108. 6. Click the Set Backup Schedule button. The WebWare network server will request the backup of the networked devices at the scheduled intervals. A confirmation message will appear on the page.
© Copyright 2008 ABB. All rights reserved.
NOTE: If an error message appears, make sure that: •
you have entered a scheduled time for the backup to occur.
•
you have selected one or more days to run the backups on.
7. If necessary, change the backup timeout value and click Set Timeout. This will change the amount of time that WebWare Server will continue trying to complete a backup after an unsuccessful attempt. A confirmation message will appear on the page indicating that the new timeout value is set.
3HAC031360-001 Revision: A
109
2 Using ABB WebWare Client 2.4.14. Backup Results Page
2.4.14. Backup Results Page Overview
xx0500001710
Screen Components Component
Function
Refresh Button
Click to update the system and display the latest backup sessions available. You may need to use this button if you navigate to the Backup Results page before a backup session has completed.
Backup Results list
From this list you can select to display the results for all backups or backups related to a specific device set.
Results for Selected Devices Click to display the backups related to the device set selected button in the Device Tree. An additional page will be displayed.
Continues on next page 110
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
The upper table (A), referred to as the Backup Results Tableshown on the Backup Results page. It provides a summary of the backup sessions that have been performed. Each entry in the Backup Results Table provides a hyperlink to additional details pertaining to that session. These additional details are displayed in the second table (B), referred to as the Device Detail Result Table shown on the Backup Results page.
2 Using ABB WebWare Client 2.4.14. Backup Results Page Continued
Component
Function
Table Entries
Each row in the Results table becomes a hyperlink to a second table containing detailed information on the results of the backup session. Result codes are listed in Return Status Codes in the System Reference section.
Page Number Hyperlinks
Click the hyperlinks, displayed at the botton left corner of the table, to display additional pages of the backup results table.
Backup Error Detail Tables
© Copyright 2008 ABB. All rights reserved.
If you click on an entry in the Backup Results Table (A) and the Device Detail Result Table (B) is blank, the backup was successful for all devices selected at that time. If the Device Detail Result Table shows a list of devices, errors occurred on the backups for the listed devices. Click on the device line to open up the Detailed Error Table (C) for the selected device. The figure below shows a list of errors for a backup that contained errors.
xx0500001711
Continues on next page 3HAC031360-001 Revision: A
111
2 Using ABB WebWare Client 2.4.14. Backup Results Page Continued
Backup Results for Selected Devices Table
© Copyright 2008 ABB. All rights reserved.
When you click the Results for Selected Devices button on the Backup Results page, and you have selected one or more devices on the device tree, the Backup Results - Selected Device page will be displayed. This page contains information about the date of the last backup, the status of the last backup, the ratio of successful backups for the last ten attempts, and the number of days since the last successful backup. You can view detailed specifics for the last ten backups.
xx0500001712
112
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.15. How to Display Backup Results
2.4.15. How to Display Backup Results Displaying Backup Results Follow the steps below to display the Backup Results page. 1. Open the browser and point it to the WebWare web site. 2. Click on the Backup menu.
© Copyright 2008 ABB. All rights reserved.
3. From the Backup submenu, select Backup Results. The Backup Results page will appear.
xx0500001711
The upper table (A) shown in the Backup Results window provides a summary of the backup sessions that have been performed. Numbered hyperlinks at the bottom left of the table lead to any additional pages of backup sessions available. Each entry in the upper table provides a hyperlink to the Device Detail Result Table (B). The Device Detail Result Table provides details for all of the devices that were backed up during the selected session. The table includes the initiation time interval, the backup time interval and the storage time interval. The values are in seconds. The figure earlier illustrates the relationship between the three tables that can appear on Continues on next page 3HAC031360-001 Revision: A
113
2 Using ABB WebWare Client 2.4.15. How to Display Backup Results Continued the Backup Results page. Each of the red-highlighted entries in the upper tables are hyperlinked to the table below it on the page. The bottom table (C) is the Error Detail table. This table provides a list of all of the errors that occurred on the backup. It provides a good place to start troubleshooting problems with a backup session.
© Copyright 2008 ABB. All rights reserved.
For a complete list of WebWare error codes, see Return Status Codes in the System Reference section.
114
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.16. Backup Restore Page
2.4.16. Backup Restore Page Overview The Backup Restore page provides access to WebWare Device file stores. For real or virtual controllers, this file store can include a mirror image of the controller RamDisk, backup images of the controller files, or any other files stored in the controller file space on the WebWare network server. Many of the elements found on the Backup Restore page are similar to those found on the file handling windows and dialogs in standard PC applications. This also includes the possibility to "drag and drop" files or folders.
© Copyright 2008 ABB. All rights reserved.
Restored files and folders are copied to different folder locations at the robot controller depending if the controller’s RamDisk is mirrored or not.
xx0500001715
Continues on next page 3HAC031360-001 Revision: A
115
2 Using ABB WebWare Client 2.4.16. Backup Restore Page Continued
Screen Components - Action Buttons The buttons above and right of the table headers may be disabled (grayed out), or enabled, depending on the current path and focus of the Backup Restore page. Component
Function Read-/Write mode – Makes it possible to change the read-/ write mode on the selected file.
xx0600003084
Restore – Copies the selected backup files to the robot controller’s RamDisk. xx0500001717
Set Master Backup– Marks the selected backup as "Master".
xx0500001718
Up Directory – Moves the Backup Restore page’s target directory up one level in the current path. xx0500001719
New Folder – Create a new folder in the currently selected path.
Cut – Cut the selected file.
xx0500001721
Copy – Copy the selected file. xx0500001722
Paste – Paste the selected file. xx0500001723
Delete – Permanently deletes the selected file or directory from the device’s file store on the WebWare Server. xx0500001724
Continues on next page 116
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
xx0500001720
2 Using ABB WebWare Client 2.4.16. Backup Restore Page Continued
Component
Function History – Displays a page listing all of the versions of a file.
xx0500001725
Differences – Displays a page showing all of the additions, changes and deletions between two selected files. xx0500001726
Screen Components - Icons The icons that appear in the file manager are briefly described in the table below. Component
Function Folder icon.
xx0500001727
Successful Backup Folder icon. xx0500001728
© Copyright 2008 ABB. All rights reserved.
Unsuccessful Backup Folder icon.
xx0500001729
Master Backup icon.
xx0500001730
Folder icon with Visual SourceSafe enabled. xx0500001731
Successful Backup Folder icon with Visual SourceSafe enabled. xx0500001732
Unsuccessful Backup Folder icon with Visual SourceSafe enabled. xx0500001733
Continues on next page 3HAC031360-001 Revision: A
117
2 Using ABB WebWare Client 2.4.16. Backup Restore Page Continued
Component
Function Master Backup icon with Visual SourceSafe enabled.
© Copyright 2008 ABB. All rights reserved.
xx0500001734
118
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.17. How to Use the WebWare File Manager
2.4.17. How to Use the WebWare File Manager Expand Folder Function To expand all folders in the device tree pane (left hand side of WebWare Page), select (highlight) a folder and press the multiplication key (*) on the numerical keypad. Be careful - if you expand a folder on the server computer that has many sub-folders, it may take some time to open all of the sub-folders. To expand the highlighted folder, press the plus key (+) on the numerical keypad. To collapse the highlighted folder, press the minus key (-) on the numerical keypad. NOTE: The “expand all” function is limited to the top level below the drive node for system drives and robots (only the top level of folders will appear). If you highlight one of the nodes on the tree below the system drive or the robot, the entire folder structure will open. File Open Function You can double click on a file in the file manager page and open the file in its native application, if the application is installed on the computer you are browsing from.
© Copyright 2008 ABB. All rights reserved.
File Rename Function You can “slow-click” a file name to activate the Rename dialog. Type the new name in the dialog and click OK to rename the file.
3HAC031360-001 Revision: A
119
2 Using ABB WebWare Client 2.4.18. How to Use the Restore Page
2.4.18. How to Use the Restore Page Introduction You can use the WebWare Server Backup Restore page to browse the backup file sets to look for a particular file or to get an idea of what backup file sets are available and where they are located. Local File System
xx0500001735
Notice the red and green icons - the red ones represent backups that contain errors. The content pane shows the contents of the highlighted folder. The Master Backup is depicted with a yellow circle. Backups are stored on the Backup Disk (0:/Backup folder) . This directory is read-only. Local Disk (1:) is visible only when RamDisk Mirroring is enabled.
Continues on next page 120
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
The illustration below shows the WebWare Server Backup Restore page after running a backup that is placed on the local file system (Microsoft Visual SourceSafe is not enabled on the system).
2 Using ABB WebWare Client 2.4.18. How to Use the Restore Page Continued
Last Successful Backup Folder To make it easier to locate the last backup run on the system, you can use the Admin Backup page to configure WebWare Server to save the last backup in a folder that you name. This is depicted as the folder Last Successful in the figure below.
xx0500001736
Remember, the contents of the last successful backup folder are overwritten each time a new backup is run.
© Copyright 2008 ABB. All rights reserved.
Master Backup Folder You can mark a backup as Master by selecting a backup folder and clicking the Master Backup icon on the toolbar.
xx0500001737
Continues on next page 3HAC031360-001 Revision: A
121
2 Using ABB WebWare Client 2.4.18. How to Use the Restore Page Continued
Using Visual SourceSafe The illustration below shows how the user interface changes when SourceSafe is installed, configured and started on the system.
The icons for the backup folders have changed, but the red/green schema is still in place - red icons indicate backups that are incomplete or contain errors. The last successful backup folder schema is also still in place - the contents of that folder will be overwritten each time a new backup is run. The master backup folder schema is also still in place.
122
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
xx0500001738
2 Using ABB WebWare Client 2.4.19. How to Restore a Backup Using WebWare
2.4.19. How to Restore a Backup Using WebWare Introduction You can restore files to the robot controller´s ramdisk using the restore function provided at the WebWare Server web site. Using this feature allows you to transfer any backup set to the robot controller and in the second phase restore the backed up files using the teach pendant. This function is specially valuable if you have not implemented the WebWare RAPID Restore feature in your RAPID robot program. Procedure The following procedure describes how to restore files and folders to a robot controller using WebWare. 1. Browse to the Backup Restore page at the WebWare web site. 2. Browse in the device tree to the backup file set you will restore, e.g. the Master backup. Click the on the folder name to highlight it.
© Copyright 2008 ABB. All rights reserved.
3. Click the Restore button on the toolbar.
xx0500001739
Continues on next page 3HAC031360-001 Revision: A
123
2 Using ABB WebWare Client 2.4.19. How to Restore a Backup Using WebWare Continued 4. If you are required to enter a restore password, a dialog will appear. Enter the four digit password and click OK to continue.
xx0500001740
5. The restore procedure will begin copying files to the robot controller.
© Copyright 2008 ABB. All rights reserved.
6. To complete the procedure you need restore the files into the robot controller. This is done at the teach pendant. For details, see the robot controller documentation.
124
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure
2.4.20. WebWare RAPID Restore Procedure Overview The following restore procedures decribe two main restore scenarios: •
Restore a Complete Backup Set on page 126
•
Restore a Single File in a Backup Set on page 130
© Copyright 2008 ABB. All rights reserved.
NOTE: Screen captures are valid for S4 controllers.
Continues on next page 3HAC031360-001 Revision: A
125
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued
Restore a Complete Backup Set 1. If you have enabled the WebWare RAPID Restore Password feature, the password screen will be displayed first. Enter the four-digit password and press OK to continue.
xx0500001770
If you have not enabled the WebWare RAPID Restore Password feature, the startup screen is displayed first. © Copyright 2008 ABB. All rights reserved.
Press OK to continue.
xx0500001771
2. A screen with the number of backup sets currently stored on the WebWare Server is Continues on next page 126
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued displayed. In this example there are 12 backup sets available. Press VIEW to continue.
© Copyright 2008 ABB. All rights reserved.
xx0500001772
3. A list of available backup sets stored on the WebWare Server is displayed. Four backup sets are displayed at a time. The first listed backup set is the Master Backup. The second listed backup set is the Last Successful Backup. Each backup set is described with its folder or project name (for Visual SourceSafe) and the backup date and time. When more than four backup sets are available, the PREV and NEXT function keys appear that are used to display the four previous or four next backup sets in the list. Press RESTORE to restore a complete backup set.
xx0500001773
Continues on next page 3HAC031360-001 Revision: A
127
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued 4. When you press RESTORE, you are prompted to choose which of the displayed backup sets you want to restore. Press the function key labeled with the number of the backup set you want to restore.
xx0500001774
© Copyright 2008 ABB. All rights reserved.
5. Wait a few minutes while the backup set is transferred to the robot controller’s ramdisk. In this example 66 files are transferred.
xx0500001775
Continues on next page 128
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued 6. When the restore procedure has completed the following screen is displayed. Press EXIT to leave the WebWare RAPID Restore Procedure. Press BACK to select more backup sets or files to restore.
xx0500001776
© Copyright 2008 ABB. All rights reserved.
7. To complete the restore procedure, load the file into the robot controller. For details, see the robot controller documentation.
Continues on next page 3HAC031360-001 Revision: A
129
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued
Restore a Single File in a Backup Set 1. If you have enabled the WebWare RAPID Restore Password feature, the password screen will be displayed first. Enter the four-digit password and press OK to continue.
xx0500001770
If you have not enabled the WebWare RAPID Restore Password feature, the startup screen is displayed first. © Copyright 2008 ABB. All rights reserved.
Press OK to continue.
xx0500001771
2. A screen with the number of backup sets currently stored on the WebWare Server is Continues on next page 130
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued displayed. In this example there are 12 backup sets available. Press VIEW to continue.
xx0500001772
© Copyright 2008 ABB. All rights reserved.
3. A list of available backup sets stored on the WebWare Server is displayed. Four backup sets are displayed at a time. The first listed backup set is the Master Backup. The second listed backup set is the Last Successful Backup. Each backup set is described with its
Continues on next page 3HAC031360-001 Revision: A
131
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued folder or project name (for Visual SourceSafe) and the backup date and time. When more than four backup sets are available, the PREV and NEXT function keys appear that are used to display the four previous or four next backup sets in the list. Press VIEW to restore a single file in a backup set.
xx0500001773
4. When you press VIEW, you are prompted to choose which of the displayed backup sets you want view the file contents of. © Copyright 2008 ABB. All rights reserved.
Press the function key labeled with the number of the backup set you want to view.
xx0500001777
Continues on next page 132
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued 5. A list of available files in the backup set stored on the WebWare Server is displayed. Four files are displayed at a time. Each file is described with its folder path and filename. When more than four files are available, the PREV and NEXT function keys appear that are used to display the previous or next four files in the list. Press RESTORE to continue.
xx0500001778
© Copyright 2008 ABB. All rights reserved.
6. When you press RESTORE, you are prompted to choose which of the displayed files you want to restore. Press the function key labeled with the number of the file you want to restore.
xx0500001779
Continues on next page 3HAC031360-001 Revision: A
133
2 Using ABB WebWare Client 2.4.20. WebWare RAPID Restore Procedure Continued 7. When the restore procedure has completed the following screen is displayed. Press EXIT to leave the WebWare RAPID Restore Procedure. Press BACK to select more files to restore.
xx0500001780
© Copyright 2008 ABB. All rights reserved.
8. To complete the restore procedure, load the file into the robot controller. For details, see the robot controller documentation.
134
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.21. How to Restore Files from an NFS Mount Using the Robot Teach Pendant
2.4.21. How to Restore Files from an NFS Mount Using the Robot Teach Pendant Introduction It is possible to restore Webware backups from an NFS mount using the robot teach/flex pendant, if NFS is enabled, and Microsoft Visual SourceSafe is disabled. It is also possible to restore robot backups from an NFS mount that were initiated from the robot teach/flex pendant. It is not possible to restore Webware backups with Microsoft Visual SourceSafe enabled or if NFS is disabled as the files are invisible to the robot controller. In this case the restore function available in the WebWare RAPID module (WEBWARE.SYS) must be used. In this case, use the RAPID command, WWRestore. To enable the WWRestore procedure, a program needs to be written that restores named files or folders to a specified controller location (on the ramdisk). For more information, see WebWare RAPID Restore Procedure on page 125. Using the NFS restore command from the robot teach/flex pendant, all files in a backup are loaded into controller memory using a single command.
© Copyright 2008 ABB. All rights reserved.
Procedure Follow the steps below to restore a backup file set to a controller using the NFS Restore command at the robot TPU. 1. From the robot teach pendant, press the Other Windows button. 2. Highlight the Service menu and press the ↵ button.
Continues on next page 3HAC031360-001 Revision: A
135
2 Using ABB WebWare Client 2.4.21. How to Restore Files from an NFS Mount Using the Robot Teach Pendant Continued 3. Select File and then Restore from the teach pendant menu. The restore screen will appear.
xx0500001696
© Copyright 2008 ABB. All rights reserved.
4. Press the ↵ button. The following teach pendant screen will appear.
xx0500001697
Continues on next page 136
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.21. How to Restore Files from an NFS Mount Using the Robot Teach Pendant Continued Press the Unit button until the Massmemory Unit is: PC:. The teach pendant will display a list of directories available on the NFS mount. NOTE: All the NFS backups initiated from WebWare Server will be located under the “backup” directory on the NFS mount. The backup folder will contain subfolders in the following format: “DD-MM-YYYY HH_MM”. 5. Select a directory to restore from and press the OK button.
© Copyright 2008 ABB. All rights reserved.
6. Press the OK button at the following teach pendant screen to initiate the restore.
xx0500001698
7. The robot will begin restoring files beginning with the system parameters. Once the system parameters are restored the robot will perform a warm start and continuing restoring the program and any system or program modules. 8. Upon completion of the restore verify that all files have successfully restored.
3HAC031360-001 Revision: A
137
2 Using ABB WebWare Client 2.4.22. How to Restore Files from an NFS Mount Using the Robot Flex Pendant
2.4.22. How to Restore Files from an NFS Mount Using the Robot Flex Pendant Introduction It is possible to restore Webware backups from an NFS mount using the robot teach/flex pendant, if NFS is enabled, and Microsoft Visual SourceSafe is disabled. It is also possible to restore robot backups from an NFS mount that were initiated from the robot teach/flex pendant. It is not possible to restore Webware backups with Microsoft Visual SourceSafe enabled or if NFS is disabled as the files are invisible to the robot controller. In this case the restore function available in the WebWare RAPID module (WEBWARE.SYS) must be used. In this case, use the RAPID command, WWRestore. To enable the WWRestore procedure, a program needs to be written that restores named files or folders to a specified controller location (on the ramdisk). For more information, see WebWare RAPID Restore Procedure on page 125. Using the NFS restore command from the robot teach/flex pendant, all files in a backup are loaded into controller memory using a single command.
Follow the steps below to restore a backup file set to a controller using the NFS Restore command at the robot flex pendant. 1. From the robot flex pendant press the ABB logo. 2. The main menu appears. Select Backup and Restore.
Continues on next page 138
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Procedure
2 Using ABB WebWare Client 2.4.22. How to Restore Files from an NFS Mount Using the Robot Flex Pendant Continued 3. The Backup and Restore screen appears. Select Restore System...
xx0600003104
© Copyright 2008 ABB. All rights reserved.
4. The Restore System screen appears. Press the "..." browse button.
xx0600003105
Continues on next page 3HAC031360-001 Revision: A
139
2 Using ABB WebWare Client 2.4.22. How to Restore Files from an NFS Mount Using the Robot Flex Pendant Continued 5. The Select Folder screen appears. Press the browse-up-icon until the Massmemory Units are displayed (e.g. Hard Drive etc.). NOTE: All the NFS backups initiated from WebWare Server will be located under the “backup” directory on the NFS mount. The backup folder will contain subfolders in the following format: “Backup_ YYYY MM_DD”. 6. Press PC:. The flex pendant will display a list of directories available on the NFS mount. 7. Select a directory to restore from and press OK. 8. The robot will begin restoring files beginning with the system parameters. Once the system parameters are restored the robot will perform a warm start and continuing restoring the program and any system or program modules.
© Copyright 2008 ABB. All rights reserved.
9. Upon completion of the restore verify that all files have successfully restored.
140
3HAC031360-001 Revision: A
2 Using ABB WebWare Client 2.4.23. Backup Summary Page
2.4.23. Backup Summary Page Overview
© Copyright 2008 ABB. All rights reserved.
The Backup Summary page displays the Backup Summary Table containing information for the selected device such as project name, backup name, date and time for the backup, user name and the backup comment.
xx05001716
3HAC031360-001 Revision: A
141
2 Using ABB WebWare Client
© Copyright 2008 ABB. All rights reserved.
2.4.23. Backup Summary Page
142
3HAC031360-001 Revision: A
3 System Reference 3.1.1. Return Status Codes
3 System Reference 3.1 Return Status Codes 3.1.1. Return Status Codes Introduction Most of the InterLink automation methods return status codes to denote error conditions or successful method execution. The successful execution of any InterLink method is always returned as a value greater than or equal to zero. Any negative status code denotes an error condition.
© Copyright 2008 ABB. All rights reserved.
The error codes are either generated from the RAP interface or the InterLink interface.
3HAC031360-001 Revision: A
143
3 System Reference 3.1.2. RPC Communications Errors
3.1.2. RPC Communications Errors Introduction These errors are generated by the RPC interface. Any positive error code returned from InterLink is an RPC error. When one of these errors is received, it usually means that either the interface to the robot controller is broken, the robot controller is down, the robot controller is not configured correctly, or the robot controller does not support the requested method. Local Errors 1
Can't encode arguments.
2
Can't decode results.
3
Failure in sending call.
4
Failure in receiving result.
5
Call timed out. This signifies that the robot controller is no longer responding to requests or the specified communications timeout is too low.
Remote Errors
144
6
Rpc versions not compatible.
7
Authentication error.
8
Program not available.
9
Program version mismatched.
10
Procedure unavailable. This usually means that the software loaded in the robot controller does not support the requested method.
11
Decode arguments error.
12
Generic“ other problem”.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Not all of the possible RPC errors are included in this table.
3 System Reference 3.1.3. InterLink Module Communication Errors
3.1.3. InterLink Module Communication Errors Introduction These error codes are a result of InterLink failing to successfully communicate with the robot controller. These errors signify that either the interface to the robot controller is broken, the robot controller is down, the robot controller is not configured correctly, or the robot controller does not support the requested method.
© Copyright 2008 ABB. All rights reserved.
Error Codes Code
Description
-1
Unable to contact robot controller.
-2
Internal connection error.
-3
Variable read error.
-4
Variable write error.
-5
Internal connection failure due to invalid handle.
-6
Spontaneous message support failed.
-7
Invalid communications timeout value specified.
-8
Program module load error.
-9
Program module save error.
-10
Program load error.
-11
Program save error.
-12
Program prep error.
-13
Program delete error.
-14
Mode set error.
-15
Mode get error.
-16
Program start error.
-17
Program stop error.
-18
File open error.
-19
File close error.
-20
File rename error.
-21
File delete error.
-22
PC file access error.
Continues on next page 3HAC031360-001 Revision: A
145
3 System Reference 3.1.3. InterLink Module Communication Errors Continued
Description
-23
File read error.
-24
File write error.
-25
Directory access error.
-26
Communications timeout.
-27
Module delete error.
-28
RAP test read error.
-29
Internal error. Blocking call in progress.
-30
No reply from RAP server.
-31
Protection key access error.
-32
Read block error.
-33
Read device list error.
-34
Restart error.
-35
Load parameters error.
-36
Save parameters error.
© Copyright 2008 ABB. All rights reserved.
Code
146
3HAC031360-001 Revision: A
3 System Reference 3.1.4. General Error Messages
3.1.4. General Error Messages Introduction These error codes are generated by the robot controller.
© Copyright 2008 ABB. All rights reserved.
Error Codes Code
Description
-100
Too many concurrent services (= Max poll 10100).
-101
No available communication buffers (= Max poll 10101).
-102
Master request rejected (= Max poll 10102). • The requested resource is used by another master. • Wrong operating mode for requested service. Try again.
-103
File not found or could not be opened fro reading (= Max poll 10103).
-104
Not right privilege (= Max poll 10104). • Wrong program controller id. • Wrong operating mode for requested service. • Controller is busy. Try again later.
-105
Invalid program state (= Max poll 10105). • Not right program state for requested service. • Operation is illegal in current execution or task state.
-106
Invalid program controller state. Not right program controller state for requested service (= Max poll 10106).
-107
Cannot find spontaneous message response program in client. The specified port number may be wrong (= Max poll 10107).
-108
Too many concurrent connections (= Max poll 10108).
-109
No such host defined. The host was not defined in the system parameters or opened with rapgen_open (= Max poll 10109).
-110
Initialization not finished. The initialization is not finished. Please retry (= Max poll 10110).
-111
Invalid program number or invalid task name. Helper initialized with invalid URL (= Max poll 10111).
3HAC031360-001 Revision: A
147
3 System Reference 3.1.5. InterLink FTP Error Codes
3.1.5. InterLink FTP Error Codes Introduction The error codes are generated by InterLink.
148
Code
Description
-400
FTP General Failure.
-401
FTP Local File Error.
-402
FTP Invalid Operation.
-403
FTP Login Failure.
-404
FTP Invalid Username.
-405
FTP Invalid Password.
-406
FTP Cannot Connect.
-407
FTP Connection Aborted.
-408
FTP Connection Reset.
-409
FTP Host Not Found.
-410
FTP Path Not Found.
-411
FTP Timeout.
-412
FTP Force Retry.
-413
FTP Busy.
-414
FTP Path Exists.
-415
FTP Bad Logon Parameter.
-416
FTP Syntax Error.
-417
FTP Host File Error.
-418
FTP Host File Not Found.
-419
FTP Network Failure.
-420
FTP Not Connected.
© Copyright 2008 ABB. All rights reserved.
Error Codes
3HAC031360-001 Revision: A
3 System Reference 3.1.6. InterLink Error Code Definitions
3.1.6. InterLink Error Code Definitions Introduction These error codes are generated by InterLink.
© Copyright 2008 ABB. All rights reserved.
Error Codes Code
Description
-501
The robot alias list is full, unable to add new alias.
-502
Invalid handle passed to RIM function.
-503
Invalid robot id passed to RIM function.
-504
InterLink robot interface task is dead.
-505
Invalid signal name referenced. Signal name not found in the I/O configuration file.
-506
Invalid period referenced in subscription.
-507
Unable to locate event in event table.
-508
Invalid IO number passed to S4IOCfg.
-509
Invalid result spec number.
-510
Invalid board number passed to S4IOCfg.
-511
Invalid contact type passed to S4IOCfg.
-512
Missing IO configuration table.
-513
Invalid variable reference.
-514
Internal error reading S4 or IRC5 variable.
-515
Invalid variable object reference.
-516
XData variable data is too large for InterLink to handle.
-517
Invalid license encountered/no license found.
-518
Invalid alias object reference.
-519
Invalid linked alias operation.
-520
Invalid S4 array dimensions.
-521
Invalid S4 array element size.
-522
S4 array memory allocation failed.
-523
Invalid index passed to method.
-524
Array object data was corrupted.
Continues on next page 3HAC031360-001 Revision: A
149
3 System Reference 3.1.6. InterLink Error Code Definitions
Code
Description
-525
RAPID array object type has not been set.
-526
Function is not supported using the specified interface.
-527
The InterLink Module is currently disabled, because it hasn’t finished initializing the interface.
-528
An attempt has been made to access a device managed by InterLink that has not been properly opened or initialized.
-529
InterLink request has been aborted. InterLink returns this error when it cannot complete a request.
-530
A reference has been made to an invalid or missing Profile.
-531
An attempt has been made to delete a Profile that is still being used by an Alias. Use the Device Configuration Utility to determine which Alias definitions are using the Profile.
-532
InterLink was unable to delete the specified Profile file.
-533
An invalid custom database table definition has been received. The table definition parameters are incorrect.
-534
An invalid custom database table definition has been received. The table definition does not match the existing custom database table format.
-535
An attempt has been made to access a WebWare Server function when the WebWare Serevr interface is not enabled or connected.
-536
An internal InterLink error has been detected. Contact ABB Customer Service with the details. Returned or invalid variable objects.
-537
Unspecified error creating a custom table. WebWare Server reports this error. Possible causes are incorrect server configuration, directory access permission settings, or disk full.
-538
Unspecified error writing to a custom table. WebWare Server reports this error. Possible causes are incorrect server configuration, directory access permission settings, or disk full.
-539
InterLink detected a file access error while performing a file operation. The file is read-only.
-540
Command is not Asynchronous (USED by FWEB_ISAPI and StateManager).
-541
The Plant Model is already checked out.
-542
Create failed, name already exists and is in use.
-543
Function timeout/did not complete.
-544
Cannot read the System.DIR file (for S4C+).
-545
Unable to communicate with web site/ISAPI error.
Continues on next page 150
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Continued
3 System Reference 3.1.6. InterLink Error Code Definitions Continued
Description
-546
Error communicating with ABB WebWare Service.
-547
Error communicating from WWService to Data Collector.
-548
Error accessing Visual SourceSafe.
-549
Error accessing the WebWare Data Engine.
-550
Undefined Error was returned from the robot.
-600
Invalid restart mode. An invalid restart mode has been specified in the rapgen_restart command.
© Copyright 2008 ABB. All rights reserved.
Code
3HAC031360-001 Revision: A
151
3 System Reference 3.1.7. InterLink Monitor Connecting Failure
3.1.7. InterLink Monitor Connecting Failure Introduction These error codes are generated by InterLink.
Code
Description
50200
S4SubReset
50300
S4SubLog
50400
S4SubSCWrite
50600
S4CtlVersionGet
50700
S4CtlIdGet
51000
S4PageDelete
51001
S4FileDevices
51100
VarPage.RemoveAll
51200
BuildIOPollList
51300
BuildpageDefinition
51400
S4BIOFCloseAll
51500
ResetSISPolling
51600
ReadCurrentSystemName
65536
See S4 InterLink Monitor max poll on page 152.
© Copyright 2008 ABB. All rights reserved.
S4 InterLink Monitor min poll
S4 InterLink Monitor max poll Code
Description
2
Unknown host
4
Unable to contact controller
5
Unable to contact controller
6
Too many connections (>256)
>10000
If the max poll exceeds 10000, subtract it from 10000 to get the error code, and then see General Error Messages on page 147.
Continues on next page 152
3HAC031360-001 Revision: A
3 System Reference 3.1.7. InterLink Monitor Connecting Failure Continued
© Copyright 2008 ABB. All rights reserved.
IRC5 InterLink Monitor max poll Code
Description
0
No response
1
IRC5CONFAIL_BADNETSCAN
2
IRC5CONFAIL_CLIENTREG
3
IRC5CONFAIL_BADUAS
4
IRC5CONFAIL_CTRLINIT
5
IRC5CONFAIL_NOPCINTERFACE
6
IRC5CONFAIL_ENVVARINIT
7
IRC5CONFAIL_CTLVERGET
8
IRC5CONFAIL_CTLIDGET
9
IRC5CONFAIL_ROBDATAINIT
10
IRC5CONFAIL_ROBRAPIDINIT
11
IRC5CONFAIL_INITTASKLIST
12
IRC5CONFAIL_ROBRAPIDTASKINIT
13
IRC5CONFAIL_IOSYSTEMINIT
14
IRC5CONFAIL_IOSIGNALINIT
15
IRC5CONFAIL_IOSIGNALSUB
16
IRC5CONFAIL_RAPIDNAMESPACEINIT
17
IRC5CONFAIL_ROBFILEBROWSERINIT
18
IRC5CONFAIL_ROBEVENTLOGINIT
19
IRC5CONFAIL_ELOGTEXTINIT
20
IRC5CONFAIL_GETLASTLOGNUM
21
IRC5CONFAIL_GETLASTLOGNUM2
22
IRC5CONFAIL_GETDEVICELIST
3HAC031360-001 Revision: A
153
3 System Reference 3.1.8. Variable Handling Error Messages
3.1.8. Variable Handling Error Messages Introduction These error codes are generated by the robot controller.
Code
Description
-1013
No program to store.
-1100
Invalid program controller state.
-1101
Invalid program state.
-1102
Invalid controller state.
-1103
Invalid operating state not in Auto mode.
-1104
Too many concurrent variable services.
-1105
Invalid variable name, or invalid domain.
-1106
Invalid type name, or invalid domain.
-1107
Missing the work or tool frame definition.
-1108
Invalid domain number.
-1109
Invalid transfer type number.
-1110
Invalid subscribe parameters.
-1111
Invalid cancel parameters.
-1112
Mastership request rejected - requests mastership RAPID domain.
-1113
The parameter value is too large.
-1114
Invalid system state.
-1115
Invalid write parameters. Write request was sent to the controller, but the controller returned an error.
-1116
Invalid signal name.
-1117
Invalid value.
-1118
Invalid parameter.
-1119
Too many subscriptions.
-1120
Invalid subscription log group.
-1121
Clockdata does not correspond to a valid date and time.
-1122
The system clock could not be read.
Continues on next page 154
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Error Codes
3 System Reference 3.1.8. Variable Handling Error Messages
© Copyright 2008 ABB. All rights reserved.
Continued
Code
Description
-1123
The system clock could not be written.
-1124
Variable and type mismatch. The variable exists but is not of the specified type.
-1125
Variable not persistent. The variable exists but is not persistent.
-1126
Illegal dimension. The specified dimension must be in the range 0 to 3.
-1127
Illegal array index. Array index must be larger than 0, and the second index must be larger than the first.
-1128
Array index out of bounds. Array index not within the bounds defined for the array.
-1129
Array size violation. The requested array size is too large to be handled in one call. Divide the array into smaller parts and read or write them with more than one call.
-1130
Dimension violation. The array dimension of the requested variable does not correspond to the request parameters.
-1131
Variable is not an array. The requested variable is not an array.
-1132
Variable is an array. The requested variable is an array.
-1133
Illegal structure. The XData structure does not correspond to the structure of the requested data type.
-1134
Too many page descriptions. The maximum number of page descriptions has already been used.
-1135
Non-existing page definition. No page definitions with the specified number exists.
-1136
Illegal page definition number. The specified page definition number is either larger than the maximum number of page definitions or smaller than 1.
-1137
Illegal number of page elements. The number of page elements is either larger than the maximum number of page elements or less than 1.
-1138
Illegal variable type for page. The specified variable type is not possible to read or write in a page.
-1139
Invalid domain for arrays. Variables in the specified domain cannot be arrays. Arrays can only exist in the RAPID domain.
-1140
The variable can not be written. This variable is read-only.
-1141
The variable can not be read. This variable is write-only.
3HAC031360-001 Revision: A
155
3 System Reference 3.1.9. Program Handling Error Messages
3.1.9. Program Handling Error Messages Introduction These error codes are generated by the robot controller.
156
Code
Description
-2101
Invalid module. • Operation completed but with syntax error(s). • The filename does not comply to the ISO-8859-1 (ISO-Latin-1) encoding. • Module is read proteced.
-2102
Invalid module name. RAPID symbol was not found. Ambiguous module name.
-2103
Invalid program.
-2104
Invalid run mode.
-2105
Invalid stop mode.
-2106
Invalid procedure name.
-2107
Invalid parameters. • Helper initialized with invalid URL. • Unable to initiate the helper for the specified task/invalid pgmId value.
-2108
No program deleted.
-2109
Robot not on path. The robot is not on the path. To regain path answer the dialog on the teach pendant. Start the program from the teach pendant.
-2110
Break during start order. The robot was stopped during path regain.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Error Codes
3 System Reference 3.1.10. File Handling Error Messages
3.1.10. File Handling Error Messages Introduction These error codes are generated by the robot controller.
© Copyright 2008 ABB. All rights reserved.
Error Codes Code
Description
-3100
General file handling error.
-3101
Too many files open.
-3102
No such path or too long file name (8.3).
-3103
Write error.
-3104
Device full. The RAPID heap memory is full.
-3105
Error when opening device.
-3106
Invalid file descriptor.
-3107
End of file.
-3108
Invalid open flags.
-3109
Illegal access mode.
-3110
File exists. RAPFIL_RENAME returns this error code if a file with the new file name exists.
-3111
Directory exist.
-3112
Directory not empty.
-3113
Directory does not exist.
-3114
Service is not supported. The service is not supported in this version of the controller.
3HAC031360-001 Revision: A
157
3 System Reference 3.1.11. Configuration Handling Error Messages
3.1.11. Configuration Handling Error Messages Introduction These error codes are generated by the robot controller.
158
Code
Description
-4100
General configuration handling error.
-4101
Invalid topic.
-4102
Unable to open file for writing.
-4103
Invalid path name.
-4104
Topic name invalid.
-4105
Wrong operating mode. The robot must be in auto mode when loading and saving parameters.
-4106
Version too old. The version of the parameter file on the disk is too old.
-4107
Invalid type. A type name in the parameter file is invalid.
-4108
Input error. Error in input file or file not found.
-4109
Line error. The length of a line in the parameter file is longer than 80 characters.
-4110
Range error. An input value in the parameter file is out of range.
-4111
Duplicate parameter name. Two or more parameters in the input file has the same name.
-4112
Invalid load mode. The load mode is invalid.
-4113
Invalid attribute. The name of a parameter attribute is invalid.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Error Codes
3 System Reference 3.1.12. Log Error Messages
3.1.12. Log Error Messages Introduction These error codes are generated by the robot controller. These error codes have different definitions, depending on the software version installed.
© Copyright 2008 ABB. All rights reserved.
Error Codes Version 3.2.46 and Earlier Code
Description
-5101
Invalid log type. Valid log types are 0-14. Values outside of this range are rejected.
-5102
The log can’t be read.
-5103
Can’t open file. There was an error creating the temporary file.
-5104
Can't write log.
-5105
Empty log.
-5106
Backup error. • The directory does not exist. • At least one module name is too long. • Tree structure cannot be created. • Error saving or reading config file. • The structure is to deep. • The directory contains items that are to be created. • Error while writing to backinfo file.
-5107
Restore error. • The directory does not exist. • The backup system is not correct. • The backup directory is not a completed backup. • The structure is too deep. • The backinfo file cannot be opened. • Loading of a module failed. • Some configuration error.
-5108
Too long file name.
-5109
The restore service is not supported since the option is missing.
-5110
General error for log.
Continues on next page 3HAC031360-001 Revision: A
159
3 System Reference 3.1.12. Log Error Messages Continued
160
Code
Description
-5101
Invalid log type. Valid log types are 0-14. Values outside of this range are rejected.
-5102
The log can’t be read.
-5103
Can’t open file. There was an error creating the temporary file.
-5104
Empty log.
-5105
Backup error. • The directory does not exist. • At least one module name is too long. • Tree structure cannot be created.‘ • Error saving or reading config file. • The structure is to deep. • The directory contains items that are to be created. • Error while writing to backinfo file.
-5106
Restore error. • The directory does not exist. • The backup system is not correct. • The backup directory is not a completed backup. • The structure is to deep. • The backinfo file cannot be opened. • Loading of a module failed. • Some configuration error.
-5107
Too long file name.
-5108
General error for log.
-5109
The restore service is not supported since the option is missing.
-5110
Can’t write to log file.
3HAC031360-001 Revision: A
© Copyright 2008 ABB. All rights reserved.
Error Codes Versions 3.2.50 and Later
3 System Reference 3.2. WebWare Server Error Codes
3.2. WebWare Server Error Codes Introduction These error codes are generated by the WebWare server and written into the event log database by the Data Collectors.
© Copyright 2008 ABB. All rights reserved.
WebWare SCWrite Command Error The following error codes originate in InterLink: Code
Description
15001
Incorrect number of parameters sent to %.
15002
Invalid counter name sent to IncrCounter.
15003
Invalid timer name sent to StartTimer.
15003
Invalid timer name sent to StopTimer.
15003
Invalid timer name sent to LogTimedEvent.
15004
Invalid timer duration sent to LogTimedEvent.
15005
Failed to create WebWare table. Incorrect SCWrite type definition variable.
15006
Failed to create WebWare table. Invalid field name SCWrite definition.
15007
Failed to create WebWare table. Unable to access table status variable.
15008
Table write request failed. Invalid record data received.
WebWare Service Command Error The following error codes originate in WWServer: Code
Description
15013
DC COM pointer invalid. HR=%x.
15014
DC disconnected due to heartbeat timeout.
15015
Unable to locate %d in Timer Table.
15015
EndTime parameter is NULL or invalid.
15015
StartTime of %s is later then EndTime of %s.
15015
CWWTimerRs::TimerRecordUpdate(TimerKey) Error number: 0x%x %s.
15015
%s : %s.
15015
Timer %s with start time of %s has been removed by update timer.
Continues on next page 3HAC031360-001 Revision: A
161
3 System Reference 3.2. WebWare Server Error Codes
© Copyright 2008 ABB. All rights reserved.
Continued
162
3HAC031360-001 Revision: A