FactoryLink ECS

Fundamentals

FactoryLink ECS 6.0 / March / 1996

F I


Copyright 1984 - 1996 United States Data Corporation. All rights reserved. - NOTICE The information contained herein is confidential information of United States Data Corporation, a Delaware corporation, and is protected by United States copyright and trade secret law and international treaties. This document may refer to United States Data Corporation as USDATA. Information in this document is subject to change without notice and does not represent a commitment on the part of United States Data Corporation (USDATA). Although the software programs described in this document (the Software Programs) are intended to operate substantially in accordance with the descriptions herein, USDATA does not represent or warrant that (a) the Software Programs will operate in any way other than in accordance with the most current operating instructions available from USDATA, (b) the functions performed by the Software Programs will meet the user's requirements or will operate in the combinations that may be selected for use by the user or any third person, (c) the operation of the Software Programs will be error free in all circumstances, (d) any defect in a Software Program that is not material with respect to the functionality thereof as set forth herein will be corrected, (e) the operation of a Software Program will not be interrupted for short periods of time by reason of a defect therein or by reason of fault on the part of USDATA, or (f) the Software Programs will achieve the results desired by the user or any third person. U.S. GOVERNMENT RESTRICTED RIGHTS. The Software is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the government of the United States is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or in subparagraphs (c)(1) and (2) of the Commercial Computer SoftwareRestricted Rights clause at 48 CFR 52.227-19, as applicable. Contractor/Manufacturer is United States Data Corporation, 2435 North Central Expressway, Suite 100, Richardson, TX 75080-2722. To the extent Customer transfers Software to any federal, state or local government agency, Customer shall take all acts necessary to protect the rights of USDATA in Software, including without limitation all acts described in the regulations referenced above. The Software Programs are furnished under a software license or other software agreement and may be used or copied only in accordance with the terms of the applicable agreement. It is against the law to copy the software on any medium except as specifically allowed in the applicable agreement. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written permission of USDATA. Trademarks. USDATA, FactoryLink and FactoryLink ECS are registered trademarks of United States Data Corporation. Open Software Bus is a registered trademark licensed to United States Data Corporation. All other brand or product names are trademarks or registered trademarks of their respective holders.

FactoryLink Part title variable Fundamentals applied here in the Fundamen- Part title variable applied here in this book tals

Table of Contents

Fundamentals

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Development Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Run-time Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Real-time Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generating Data in Real-time Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reading Data from the Real-time Database . . . . . . . . . . . . . . . . . . . . . . . . . FactoryLink Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modules for Accessing Stored Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modules for Logging and Retrieving Data . . . . . . . . . . . . . . . . . . . . . . . Modules for Communicating Across the Network . . . . . . . . . . . . . . . . . . Two Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Domain Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Domains for Run-time Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiple-user Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiple Shared Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multiple Separate Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FactoryLink Directory Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TFactoryLink Application Directory Subdirectories . . . . . . . . . . . . . . . . FactoryLink Application Directory Files . . . . . . . . . . . . . . . . . . . . . . . . . FactoryLink System Directory Subdirectories . . . . . . . . . . . . . . . . . . . . Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Format Specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 12 13 14 15 16 16 16 16 17 18 18 20 21 21 21 22 22 23 23 26 27

Working with Tags in Configuration Manager . . . . . . . . . . . . . . . 31

Defining Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Tags While in the Configuration Manager . . . . . . . . . . . . . . . . Defining Tags While in the Application Editor . . . . . . . . . . . . . . . . . . . Defining Element Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining One-dimensional Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Defining Multi-dimensional Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 32 34 35 36 36

FactoryLink ECS / Fundamentals / 3

Fundamentals

Maximum Number of Arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 Using Tags as Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Predefined Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Using the Configuration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Opening the Configuration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows NT or Windows 95 Platform . . . . . . . . . . . . . . . . . . . . . . . . . . OS/2 Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . UNIX Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuration Manager Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Text-entry Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Structured Configuration Panels . . . . . . . . . . . . . . . . . . . . . . Scrolling a Window or Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vertical Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Horizontal Scroll Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Multiple Development Applications . . . . . . . . . . . . . . . . . . . . Opening a New Development Application . . . . . . . . . . . . . . . . . . . . . . . Sharing Information Between Applications . . . . . . . . . . . . . . . . . . . . . . Opening Multiple Configuration Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Working with Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing the Number of Tags Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing a List of Real-time Database Elements . . . . . . . . . . . . . . . . . . . Viewing Element Cross Reference List . . . . . . . . . . . . . . . . . . . . . . . . . . Searching for a Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting a Tag Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing a Tag Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing Miscellaneous Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing Domain List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Viewing the Current Version of FactoryLink . . . . . . . . . . . . . . . . . . . . . Viewing Field Choices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Editing Configuration Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inserting a Blank Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Deleting a Line Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Copying Contents of a Line Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cutting a Line Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pasting a Copied or Cut Line Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . Searching for a Text String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 42 43 44 45 46 47 49 49 50 51 51 52 54 55 55 56 58 60 62 64 66 66 67 68 70 70 70 71 71 72 72

4 / FactoryLink ECS / Fundamentals

Fundamentals

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Managing Text-entry Panel Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Saving File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Merging a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Checking Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Clearing Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Changing Font Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Configuration Manager Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Using System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Editing Task Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Viewing Domain Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Adding New Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 Changing Domain Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Setting the Run-Time Graphics Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Changing the Windows Color Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Archiving Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Resizing and Moving Screen Components . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Calculating the Number of FactoryLink Processes . . . . . . . . . . . . . . . . . . . 120

Using Run-Time Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Setting Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Accessing Run-Time Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 On Windows NT and Windows 95 Platforms . . . . . . . . . . . . . . . . . . . . 127 On OS/2 Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 On UNIX Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Run-Time Manager User-Interface Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 132 Task Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 Application Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Display Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Run-time Manager Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Text Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Messages with Error Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Correcting Internal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148

FactoryLink ECS / Fundamentals / 5

Fundamentals

Using Run-Time Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Accessing the Run-Time Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 Viewing the Current Value of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 Adding Elements to a Watch List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 Deleting Elements from a Watch List . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Finding Elements in a Watch List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Storing Watch List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 Retrieving Watch List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 Reading and Writing a Real-Time Database Element . . . . . . . . . . . . . . . . . 157 Monitoring FactoryLink Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Using Run-Time Monitor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 Terminating a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Exiting Commands Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Accessing Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164 Reading an Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165 Writing to an Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Working with Batch Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168 Monitoring the Status of the Real-Time Database . . . . . . . . . . . . . . . . . . . 171 Terminating All FactoryLink Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174 Exiting RTMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Run-time Manager Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Text Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 Messages with Error Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182 Correcting Internal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

FactoryLink Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

FLNEW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190 FLTEST and FLDEMO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 On Windows NT and Windows 95 Operating Systems . . . . . . . . . . . . . . . . 192 On OS/2 Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194 On UNIX Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Restoring FLDEMO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Restoring FLTEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196 Module Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 FLCONV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 FLSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

6 / FactoryLink ECS / Fundamentals

Fundamentals

CTGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202 CDBLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203 CTLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204 DBCHK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205 EXPLODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207 keyinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208 flkeyval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209 FLSHM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210 UKEY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 Utility Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212 EXPLODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 FLSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 FLREST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

FactoryLink Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

I/O Element Maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219 Configuration Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 FactoryLink Lite Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

FactoryLink ECS / Fundamentals / 7

Fundamentals

8 / FactoryLink ECS / Fundamentals

Chapter 1

Overview
1

Overview

FactoryLink is a software development tool designed to build a modular, multi-tasking application that automates and controls a process, such as the production of goods at a factory, the movement of liquid or gas down a pipeline, or the periodic collection of data. You use the unlimited capabilities of FactoryLink to build an application that performs the task you want to automate for your processes. FactoryLink has two operating environments. DevelopmentThe activities required to automate and control a process are configured in the development environment creating a practical application. You configure an application using the Configuration Manager Main Menu. Refer to Chapter 3, Using the Configuration Manager, for details on starting and using the Main Menu. Run timeWhen the application created in the development environment is started, it executes in the run-time environment. You control and monitor the status of the application using the Run-Time Manager, which allows you to start, monitor, and stop individual run-time tasks. Refer to Chapter 5, Using Run-Time Manager, for details on starting an application and using the Run-Time Manager. FactoryLink is a set of programs; each program performs a specific activity in the automation process, such as the collection and storage of data, the generation of reports, or the management of files. These programs are called modules in the development environment and tasks in the run-time environment. This chapter describes the concepts necessary to understand how FactoryLink works. It also describes each module that can be configured to automate your process.

FactoryLink ECS / Fundamentals / 9

OVERVIEW
Development Environment

D EVELO PME NT E NV IRON MEN T

A FactoryLink application is configured in the development environment. This environment contains a series of configuration tables for each module. Refer to the FactoryLink Modules on page 16 for a list of modules. You open these tables by choosing a specific menu option from the Main Menu.

Access to configuration tables

Each option is comprised of one or more panels. For example, the Logger table is comprised of two panels: the Database Logging Control panel and the Database Logging Information panel.

10 / FactoryLink ECS / Fundamentals

OVERVIEW
Development Environment

You must fill out these panels to configure the module. Refer to the FactoryLink Configuration Guide for details on configuring each module. The information entered in these panels is stored in dBASE IV compatible files in the directory where the FactoryLink application files are stored. Refer to FactoryLink Directory Organization on page 22 for details on where these files reside. These files are identified by their .cdb extension and their corresponding index files are identified by their .mdx extension.

Overview

FactoryLink ECS / Fundamentals / 11

OVERVIEW
Run-time Environment

R UN - TIM E EN VIRO NM ENT

The run-time environment uses the information provided in the configuration tables to build an application. When the FactoryLink application is started, the contents of the dBASE IV files are translated and stored in binary files containing a .ct extension. Where these files are located depends on the domain associated with the data. Refer to FactoryLink Directory Organization on page 22 for details. The name assigned to each file uses the following form: module_name.CT where
module_name

the name of the task as it is displayed in the system configuration task.

12 / FactoryLink ECS / Fundamentals

OVERVIEW
Real-time Database

R EAL - TIM E D A TABA SE

A real-time database is central to all FactoryLink tasks in real-time mode. This real-time database resides in memory and acts as both a storage device and an interprocess communication mechanism.

Overview

Realtime database

All FactoryLink tasks share information in the real-time database by reading from or writing to the real-time database. Data is never passed directly between two tasks. Each data stored in the real-time database is an element. During application development, each element is assigned a logical name in FactoryLink called a tag. This tag name is used to reference the element in the real-time database.

Tag Names pump1_tmp pump2_tmp pump3_tmp (Logically represents an element in database)

Realtime database
Elements

Refer to Chapter 2, Working with Tags in Configuration Manager for details on assigning tag names and for a list of predefined elements shipped with FactoryLink.

FactoryLink ECS / Fundamentals / 13

OVERVIEW
Generating Data in Real-time Database

GEN ERATI NG D ATA

IN

R EAL - TIM E D ATAB ASE

The database stores data that has been: Collected from a remote device
External Device

Computed by a FactoryLink task

c CBAR = ----k

Manually entered by a user

When data is collected and stored in the database, other tasks can open and manipulate it. A task can write information to an element in the real-time database using one of two types of writes: a normal write or a forced write. Normal writes only write to an element in the real-time database if the new value is different from the existing value. In this way, system resources are not used unnecessarily. Forced writes write to an element whether or not it has changed. Use this type of write if you want to set the change-status flag even if the data has not changed. Refer to Reading Data from the Real-time Database on page 15 for a discussion on the change-status flag.

14 / FactoryLink ECS / Fundamentals

OVERVIEW
Reading Data from the Real-time Database

R EADIN G D ATA

FRO M THE

R EAL - TIM E D ATABA SE

A task gets the value of an element in the real-time database using a read operation. Once the task has this value, it can perform functions on it, such as displaying on a graphical user-interface, transmitting to an external device, or sending it to a relational database for archiving.

Overview

Read operations can be triggered by an event (such as when a product passes an electronic eye) or can occur only if the data element changes. A read operation that occurs only when the data changes is referred to as exception processing. Because large blocks of data can be transferred between tasks, and because only the changed values are processed, exception processing significantly optimizes performance. Exception processing is possible because of the structure of the FactoryLink real-time database elements. A real-time database element consists of a number of bits, one or more of which contain the elements value. Thirty-one of these bits are reserved to function as change-status flags. Each FactoryLink task is assigned one of these bits which it uses to determine the elements change status. The change-status flag is either set to 1 (ON) or 0(OFF). One (1) indicates to the task the value of the element has changed since the last time the task read the element. Zero (0) indicates to the task the value of the element has not changed. When an element in the database is written, all the bits are automatically set by FactoryLink.

FactoryLink ECS / Fundamentals / 15

OVERVIEW
FactoryLink Modules

F AC TORY L INK M ODU LES

FactoryLink is comprised of modules with unique functions.

General Modules
Application Editor Draws and animates graphical user-interfaces to the

FactoryLink application. These interfaces can be designed to monitor data in the real-time database, or they can be designed to permit operators to write data to the real-time database. Device Interface Communicates bi-directionally between the real-time database and one or more external devices, such as programmable logic controllers (PLCs) and remote terminal units (RTUs). This is necessary for collecting and storing device data in the real-time database or for sending data back to the external device. RecipeStores recipes on disk for manufacturing a product. These recipes can be sent to an external device at a given time to control the product manufactured.

Modules for Accessing Stored Data

Math and LogicPerforms math on data collected in the real-time database.

The results can be used for writing new data elements, inclusion in reports, or triggering events. Report GeneratorGenerates reports using data from the real-time database. These reports can be archived to disk or sent to a printer.

Modules for Logging and Retrieving Data

Database LoggerCopies data from the memory-based real-time database to

historical disk-based relational databases. TrendingDisplays real-time or historical data on trend charts. Statistical Process ControlDisplays real-time or historical data on statistical charts. Database BrowserRetrieves, updates, deletes, and inserts data into an existing database. Distributed Alarm LoggerChecks real-time data for permitted limits, generates alarms if limits are exceeded, and copies the alarms to historical disk-based relational database. HistorianActs as a conduit for information between FactoryLink tasks that send data to or retrieve data from a relational database.

16 / FactoryLink ECS / Fundamentals

OVERVIEW
FactoryLink Modules

Modules for Communicating Across the Network

FactoryLink Local Area Network Links networked applications providing

transfer of real-time data elements from one station to the next. File ManagerManages files on local drives or remote servers and transfers files from one station to the next. PowerNetShares real-time data between applications across a network. Details on how to configure each module can be found in the FactoryLink Configuration Guide.

Overview

FactoryLink ECS / Fundamentals / 17

OVERVIEW
Two Domains

T W O D OM AIN S
There are two run-time environments called domains. These are the SHARED domain and the USER domain. During configuration, you associate tasks, tables, and elements with a specific domain so you can configure a FactoryLink application to suit your needs. You can give a group of users independent access to the same FactoryLink run-time tasks such as Graphics, Math and Logic, and Statistical Process Control. This lets users access the same data at the same time with two different tasks. You can create an application that lets multiple users of a single run-time system use the tasks independently without the users sharing data; that is, users can simultaneously run the same tasks, but each users data is unique. For example, one user can employ the Statistical Process Control task to evaluate the consistency of an assembly sequence while another uses it to report anomalies in a packaging process elsewhere in the factory. You can set up multiple FactoryLink applications to run on one operating system. For example, applications for development, testing, and production, can all run on one machine.

Domain Structure
Domains exist in a parent/child hierarchy. The following illustrates the shared domain is like a parent upon which a child domain (user) is based.

18 / FactoryLink ECS / Fundamentals

OVERVIEW
Two Domains

A SHARED domain has the following characteristics: AccessibilityAll operators within a user domain can access data existing in a shared domain. Frequent useFrequently used items need only be defined once in the shared area. This characteristic eliminates duplication of effort and reduces configuration time. Automatic data changesData changes are passed immediately to all users who are accessing the modified data in a user domain. Global data processingProcessing activities, such as computations, data accessing, and data logging, are performed once and then are available to all users accessing the shared area. A USER domain has the following characteristics: Private copies of dataYou can configure a single application and then specify the number of instances (copies) of that domain to be executed at run time. The number of instances allowed is the number of users that can simultaneously interact with the run-time system. Task IndependenceEach user has access to the same FactoryLink run-time tasks such as Graphics, Math and Logic, and Statistical Process Control but is able to run these tasks independently from the tasks other users are running. Users can share data to perform different real-time tasks within the same application.

Overview

FactoryLink ECS / Fundamentals / 19

OVERVIEW
Two Domains

Domains for Run-time Tasks

Run-time tasks are associated with a domain. The domain controls whether or not the run-time task can share data and which task uses data unique to a user. Choosing the appropriate domain for a task in a multi-user application is critical. The defaults that provide the best performance for most applications are listed in the following table.
Table 1-1 Optimal Domain Selection

Task Timer Graphics Batch Recipe File Manager Server External Device Interface LAN Historian Logger SPC Logger Print Spooler

Shared Domain Graphics File Manager Trending Browser SPC View SPR

User Domains Run Manager Math & Logic Counter Persistence RTMON DALOG

During application planning, review these domain defaults to verify compatibility with a specific applications needs. When an application has special requirements, you can run the task in a different domain, except for the EDI task which must be run in the shared domain. In addition to these domain defaults, the Main Menu has a domain selection feature you must set before configuring each task. If the domain chosen during configuration does not match the default set for the domain at run time, the application will not run as intended. You must configure trending in the user domain if it is going to run in the user domain.

20 / FactoryLink ECS / Fundamentals

OVERVIEW
Multiple-user Environments

MU LTIPLE - US ER E NV IRON MEN TS

The UNIX operating system supports multiple users. You can configure use by multiple users in one of two ways: Multiple users can share the same application Multiple users can access separate applications. FactoryLinks platform independence lets you create applications on single-user computer systems, such as Windows and OS/2, and port them to run on multi-user systems.

Overview

Multiple Shared Applications

In a multi-user application each user executes in their own user domain; each user domain has its own copy of user data but shares data from the shared domain.

Multiple Separate Applications

In a multi-user application, each application has its own real-time database and does not share data between them.

FactoryLink ECS / Fundamentals / 21

OVERVIEW
FactoryLink Directory Organization

F AC TORY L INK D IREC TORY O RGA NIZATIO N

All FactoryLink files are organized into two main directories. FactoryLink application directoryContains all FactoryLink application files. FactoryLink system directoryContains all FactoryLink program files.

TFactoryLink Application Directory Subdirectories

The FactoryLink application directory contains FactoryLink application files. The default name of this directory depends on your operating system platform. On UNIX platforms, the default directory is /usr/flapp. On all other platforms, the default directory is \FLAPP. The application files are organized into the following subdirectories. Any subdirectories found in the application directory not listed here are reserved for future use.
ASC

ASCII configuration database files that store information about the elements. The files in this subdirectory contain a .asc extension. They are used to import/export configuration data from one application directory to another, typically from one platform to another during multi-platform saves and restores. Binary files produced at run time containing non-domain specific data extracted from the database tables. The files in this subdirectory contain a .ct extension. Domain-specific ct files exist in the FactoryLink domain subdirectory. Communication support tables. The files in this subdirectory contain a .dct extension. Local and group files used by the FactoryLink Local Area Networking task to determine communication parameters and remote node logical groupings. Report Generator format files that define the format for reports. The files in this subdirectory contain a .fmt extension. Files specific to the shared domain. Files specific to the user domain.

CT

DCT NET

RPT SHARED USER

22 / FactoryLink ECS / Fundamentals

OVERVIEW
FactoryLink Directory Organization

FactoryLink Application Directory Files

The application directory also contains the following files.
FLAPP.ID *.cdb

Application identification file. Configuration database files that store information about elements, such as name, type, number of writes specified by the defining task, and number of references. Index files used by the Main Menu in conjunction with the .cdb files. Main Menu cut and paste work files. Main Menu import/export output files.

Overview

*.mdx *.cnp *.exp

FactoryLink System Directory Subdirectories

The FactoryLink system directory contains all FactoryLink program files. The default name of this directory depends on your operating system. On Windows NT platforms, the default directory is \FLNT. On Windows 95 platforms, the default directory is \FLWIN. On OS/2 platforms, the default directory is \FLOS2. On UNIX platforms, the default directory is /usr/flink. The program files in this directory are organized under the following subdirectories.
AC

Text files that function as attribute catalogs to inform the Main Menu of the format of the configuration tables. They also control entry criteria. Files used by FactoryLink utilities that manage applications, such as flnew, flsave, flrest, and flconv. Command script files and executable program files for each FactoryLink task. Default make file for Compiled Math and Logic task. Configuration database conversion script files. System files used by the Graphics task and by the Application Editor. Subdirectory for External Device Interface protocol modules.

BLANK BIN CML CTGEN DRW EDI

FactoryLink ECS / Fundamentals / 23

OVERVIEW
FactoryLink Directory Organization

INC KEY LIB MPS MSG OPT SRC

C-language include files for options such as Compiled Math and Logic and the Programmers Access Kit. Text files used by the Main Menu to translate text table entries into binary values to be placed in configuration tables. Library files and objects. Demo application, new application, and test application files. Help files used with the Main Menu and Application Editor and error message files for FactoryLink tasks. Files needed to control the FactoryLink options available with your application. External Device Interface Programmer's Access Kit C-source files, libraries, and sample protocol module and sample Programmers Access Kit source and makefiles.

Windows NT and Windows 95 Platforms The Windows NT and Windows 95 platforms contain the following subdirectories under the application directory.
BIN

FactoryLink command files (.bat extension) and executable program files for each FactoryLink task (.exe extension) and dynamic link library files (.dll extension). Object, image library, and object library files (.obj extension).

LIB

OS/2 Platform The OS/2 platform contains the following subdirectories under the application directory.
BIN INSTALL LIB

FactoryLink command files (.cmd extension) and executable program files for each FactoryLink task (.exe extension). Files used during FactoryLink installation. Object files (.obj extension), library files (.lib extension) and dynamic link library files (.dll extension).

24 / FactoryLink ECS / Fundamentals

OVERVIEW
FactoryLink Directory Organization

UNIX Platforms The UNIX platform contains the following subdirectories under the application directory.
BIN LIB

FactoryLink command files and executable program files. Some protocol module executable files have an .exe extension. Object (.o extension) and library (.a extension) files.

Overview

FactoryLink ECS / Fundamentals / 25

OVERVIEW
Environment Variables

EN VIRO NM ENT VAR IABLE S

Because multiple copies of FactoryLink can be running concurrently, the system uniquely identifies an application by a combination of its application name, domain name and user name. These names are defined as environment variables. You can set these environment variables either in a system configuration file so they are automatically supplied when you start the application or at the system prompt before starting the application. The environment variables you can set are listed in the following table.
Table 1-2 Environmental Variables

Variable FLINK = flink_dir

Description Where flink_dir defines the full path, including the drive name, of the directory containing the FactoryLink program files. Where flapp_dir defines the full path, including the drive name, of the directory containing your application files. Where domain defines the domain you are starting. This can either be shared or user. On single-user platforms, domain should be user. This starts both domains. On multi-user platforms, domain is the domain you want started in the window. You must specify two windows, one for each domain. Where app_name defines the name of the application to start, which points to a real-time database. Where user_name defines the logical user name. Where opt_dir defines the full path, including the drive name, of the directory containing the FactoryLinks license information.

FLAPP = flapp_dir

FLDOMAIN = domain

FLNAME = app_name

FLUSER = user_name FLOPT = opt_dir

When using environment variables in path names, you can enter the name of the environment variable surrounded by braces { } and FactoryLink extends the pathname using the default setting.

26 / FactoryLink ECS / Fundamentals

OVERVIEW
Using Format Specifiers

U SING F O RM AT S PEC IFIERS

Format specifiers allow you to define the format for all or part of an output string. The following FactoryLink tasks support the use of format specifiers: File Manager Batch Recipe Report Generator Alarm Supervisor Format specifiers permit you to define a variable when a literal is expected. Variable specifiers can consist of two types of objects. Ordinary characters, which are copied literally to the output stream Format specifiers, which indicate the format in which variable information will be displayed Format specifiers use the following form: % [flags][width][.prec]type where
%

Overview

Always precedes a format specifier. Controls the format of the output. This can be one of the following. Left-justifies within the field. If you do not specify this flag, the field is right-justified.

flags

0 Fills the spaces to the left of the value with zeros until it reaches the specified width.
width

Specifies minimum field width, in decimal. This field is not valid for floating point notations. Floating point fields are always padded with spaces. Controls the precision of the numeric field. What precision defines depends on the format type specified by the type variable. For exponential (type e) or floating point (type f) notations, specify the number of digits to be printed after the decimal point. For short version of exponential or floating point notations (type g), specify the maximum number of significant digits. For all other types, specify the minimum number of digits to print. Leading 0s are added to make up the necessary width.

.prec

FactoryLink ECS / Fundamentals / 27

OVERVIEW
Using Format Specifiers

type

Specifies the character or numeric type for the value. This can be one of the following. d = decimal s = string ld = long decimal e = exponential notation of the following form [-]m.nnnnnnE[+-]xx f = floating-point notation of the following form [-]mmmm.nnnnnn g= use shorter of e or f u = unsigned decimal o = unsigned octal x = unsigned hexadecimal using a - f X = unsigned hexadecimal using A - F

Examples of valid format specifiers for each FactoryLink data type are displayed in the following table. For additional information about format specifiers, see any ANSI-C reference manual.

28 / FactoryLink ECS / Fundamentals

OVERVIEW
Using Format Specifiers

Table 1-3 :Format Specifiers

1
Description For example, %04d specifies a right-justified decimal value with a minimum field width of 4 digits. The 0 specifies the value is padded with zeros. For example, %3u specifies a right-justified unsigned decimal value with a minimum field width of 3 digits. The value is padded with spaces. For example, %-3u specifies the same as the example above, except the hyphen (-) before the width specifies the value is left-justified. Sample Output

Type of Element Analog d

Default Type

Valid Types d, u, o, x, X

Overview

0005 0015 0150 2400 5 15 150 2400

5 15 150 2400 5 15 2400 20000 1000000 00005 00015 02400 20000 1000000

Long Analog

ld

d, ld, u, o, x, X

For example, %-7ld specifies a left-justified long decimal value with a minimum field width of 7 digits. The value is padded to the right with spaces. For example, %05ld specifies a right-justified long decimal value with a minimum field width of 5. A 0 before the width specifies the value is padded with zeros.

FactoryLink ECS / Fundamentals / 29

OVERVIEW
Using Format Specifiers

Table 1-3 :Format Specifiers

Type of Element Floatingpoint f

Default Type

Valid Types e, f, g

Description

Sample Output

For example, %6.2f specifies a 5.51 right-justified floating-point 150.08 value with a minimum total 24000.65 field width of 6 digits. (The decimal point counts as 1 digit.) This means two digits are displayed after the decimal point and at least three digits are displayed before the decimal point. The value is padded with spaces. For example, %5s specifies a on right-justified message string off with a minimum field width of alarm 5 characters. The value is padded with spaces. For example, %-5s is the same on as the example above, except off the hyphen (-) before the alarm width specifies the value is left-justified.

Message

30 / FactoryLink ECS / Fundamentals

Chapter 2

Working with Tags in Configuration Manager

Each data stored in the real-time database is an element. Each element is assigned a logical name in FactoryLink called a tag. This tag name is used to reference the element in the real-time database.

Tag Names pump1_tmp pump2_tmp pump3_tmp (Logically represents an element in database) Realtime database

2
Working With Tags in Configuration Manager
Elements

Once an element is defined, you can make unlimited references to this element. Any FactoryLink tasks containing a reference to an element can read and write data to and from the element at run time. During development, FactoryLink stores tag names in the FLAPP directory in the object database table. This information is updated to the .ct files when the run-time application is started. This chapter describes how to define tag names for database elements and provides some suggestions on how to use tags in your application.

FactoryLink ECS / Fundamentals / 31

WORKING WITH TAGS IN CONFIGU RATION MANAGER

Defining Tags

D EFININ G T AG S
Each element stored in the real-time database must be assigned a logical name called a tag name. This tag name is used to logically reference an element in the real-time database. Some tags are already defined in FactoryLink when it is shipped. Others are defined during application development either within the Configuration Manager or the Application Editor.

Defining Tags While in the Configuration Manager

When using the Configuration Manager during application development, some fields require the name of a tag. If you enter the name of a tag not already defined in the application, the following Tag Definition dialog box is displayed.
Name assigned to tag

If you specified multiple tags on a configuration panel, this panel will display each tag name in turn until all tags are defined. Complete the following information for each tag.
Tag Name

This field displays the name of the tag you are defining. Tag names can be up to 32 alphanumeric characters with no embedded spaces or periods. Do not start the name with a number. Enter a description of up to 79 characters that defines the purpose of the tag.

Description

32 / FactoryLink ECS / Fundamentals

WORKING WITH TAGS IN CONFIGURATION MANAGER

Defining Tags

Type

Enter the type of data that will be stored in this tag. This can be one of the following, although you may be restricted to a subset of these depending on where the tag is specified. Refer to the appropriate FactoryLink Configuration Guide for valid data types for specific fields. digital Digital is a binary data type. Its value can be 0 or 1. analog Analog is a 16-bit, signed integer. Its value can range between plus or minus 32,768. longana Long analog is a 16-bit, signed integer. Its value can range between plus or minus 2 billion. float Floating-point is an IEEE double precision number with 31 places to the right of the decimal. message A message can be any combination of alphanumeric characters. Its length is controlled by its tag definition. mailbox Variable length data organized as a queue.

2
Working With Tags in Configuration Manager

Domain

Choose the domain where this tag should be created. This can be one of the following: SHARED Choose SHARED if you want the tag to be available from the shared or user environment. USER Choose USER if you want the tag to be available only from the user environment.

Array Dimension

If this tag will be used to reference an array, enter the number of elements to include in the array. If you are not defining an array, leave this field blank. Do not enter a 0 in this field as this causes errors. Refer to Defining Element Arrays on page 35 for details on defining arrays. This field defines the maximum length for message tags. If you do not specify a length, it is calculated by FactoryLink. This field defines the value written to the tag when FactoryLink is started.

Length Default Value

FactoryLink ECS / Fundamentals / 33

WORKING WITH TAGS IN CONFIGU RATION MANAGER

Defining Tags

The remaining fields on the Tag Definition dialog box are used for defining tag persistence. With tag persistence activated, the value of the tag is periodically saved to a disk file. If a value exists in this file for a tag, it is written to the tag when the task is started if the -r flag is set for FLRUN. In this way, you do not lose important information by exiting the task.
Use Domain Settings

Choose this option if you want to use persistent settings defined for the domain. If you want to define tag-specific persistence, deselect this option (box does not contain an x). Then set the following persistent options for this tag. Controls how often the elements value is saved to a disk file. This can be one or both of the following. If you choose both options, the elements value is saved based on a time trigger and when it changes.
On TimeChoose this option if you want the tag value saved based

Saving

on a time trigger.
On ExceptionChoose this option if you want the tag value saved if

the tag value changes.

Restoring

Controls whether the elements change status flag is set to on or off when restoring the saved value to the element. This can be one of the following.
Set Change Status OnThe elements change status flag is set to on

when restoring the saved value.

Set Change Status OffThe elements change status flag is set to off

when restoring the saved value. Use this option to prevent activation of digital triggers on restart.

Defining Tags While in the Application Editor

You can also define a tag name while developing the application within the Application Editor. The same information is included in the dialog as well as many additional items configured in the various Configuration Manager tasks. Refer to the Application Editor manual for details.

34 / FactoryLink ECS / Fundamentals

WORKING WITH TAGS IN CONFIGURATION MANAGER

Defining Element Arrays

D EFINING E LEM ENT A RRA YS

A tag name can be assigned to a single element or a group of elements (sometimes called an array). This permits you to create multiple tags with a single operation. All the tags receive the same tag definition. You specify an array by entering a value in the Array Dimensions field of the Tag Definition dialog box. This value defines the number of elements included in the array.

Specifies the number of elements in the array

2
Working With Tags in Configuration Manager

If you specify a value in the Array Dimensions field, multiple elements are created in the real-time database. Once created, each element can be referenced individually. The value you specify in the Array Dimensions field depends on whether you are defining a single-dimensional or multi-dimensional array.

FactoryLink ECS / Fundamentals / 35

WORKING WITH TAGS IN CONFIGU RATION MANAGER

Defining Element Arrays

Defining One-dimensional Arrays

For one-dimensional arrays, specify a single number in the Array Dimensions field. One-dimensional array names take the form tagname[n] where
tagname [n]

is the name defined in the Tagname field of the Tag Definition dialog box. is a unique number assigned to each element in the array starting with 0. Each number is surrounded with brackets [ ].

For example, if you specify 3 in the Array Dimensions field for a tag named temp, the following three elements are created in the real-time database. temp[0] temp[1] temp[2] The array numbering starts counting at 0 . If you specify 4, you receive 5 elements: 0, 1, 2, 3, 4. Therefore, you must specify a number less than the actual number you would like to define.

Defining Multi-dimensional Arrays

For multi-dimensional arrays, specify multiple numbers separated by a comma in the Array Dimensions field. Multi-dimensional array names take the form tagname[n,1][n,2]... where
tagname [ n,1]

is the name defined in the Tagname field of the Tag Definition dialog box. is a unique number representing the first dimension in the array, assigned to each element starting with 0. Each number is surrounded by brackets [ ]. is a unique number representing the second dimension in the array assigned to each element starting with 0. Each number is surrounded by brackets [ ].

[ n,2]

36 / FactoryLink ECS / Fundamentals

WORKING WITH TAGS IN CONFIGURATION MANAGER

Defining Element Arrays

For example, if you specify 3,2 in the Array Dimensions field for a tag named msg_tag, the following six elements are created in the real-time database. msg_tag[0][0] msg_tag[1][0] msg_tag[2][0] msg_tag[0][1] msg_tag[1][1] msg_tag[2][1] The array numbering starts counting at 0 . If you specify 4, you receive 5 elements: 0, 1, 2, 3, 4. Therefore, you must specify a number one less than the actual number you would like to define.

Maximum Number of Arrays

This section describes the largest number of elements that can be created for each array. This depends on the platform and on the elements data type. For Windows NT, OS/2, and UNIX Each array can have up to 65,535 elements. For Windows 95 An array can have as many elements as will fit into a 65,535-byte memory segment. This number depends on the elements data type. The following table lists the maximum number of elements permitted in an array for each data type.
Table 2-1 Table 2-1: Windows Array Maximums

2
Working With Tags in Configuration Manager

Data Type Digital Analog Long analog Floating-point Message Mailbox

Maximum Elements 4,095 3,640 3,276 2,730 2,730 + storage of data

FactoryLink ECS / Fundamentals / 37

WORKING WITH TAGS IN CONFIGU RATION MANAGER

Using Tags as Triggers

U SING T A GS

AS

T RIG GE RS

Many FactoryLink tasks use tags to trigger actions. The examples below are just a few of the possibilities: You can use the complete status tag in a logger operation to initiate a different logging operation. You can use the same tag to trigger multiple operations. For example, you can define a single tag that triggers multiple operations at the start of each hour. Triggering can be based on the fact that an elements value has changed. Triggering can be based on a combination of the trigger elements value and the value of its change-status flag. For example, if you are using a digital element to trigger an action, its change-status flag must be 1 (ON) and its value must be 1 (ON) for the operation to be triggered. You can define triggers using the Interval and Event timer module. You can configure function keys as triggers. You can use the Math and Logic task to set triggers of any data type, except mailbox, to start an operation.

38 / FactoryLink ECS / Fundamentals

WORKING WITH TAGS IN CONFIGURATION MANAGER

Predefined Elements

PRE DEFINE D E LEM ENTS

See the current FactoryLink Release Notes for a complete listing of the FactoryLink pre-defined elements.

2
Working With Tags in Configuration Manager
FactoryLink ECS / Fundamentals / 39

WORKING WITH TAGS IN CONFIGU RATION MANAGER

Predefined Elements

40 / FactoryLink ECS / Fundamentals

Chapter 3

Using the Configuration Manager

The Configuration Manager is the user interface to the development environment. You can use the Configuration Manager to perform the following actions: Designate how tasks and elements are used at run time Specify elements to be used by each task at run time Review and modify elements during configuration Review and modify application data The development environment is a series of configuration tables; one or more tables exist for each FactoryLink module. You enter data in these configuration tables through panels. There are two types of panels in FactoryLink. StructuredStructured panels contain rows and columns. Each row represents an entry in the table (sometimes called a record). Each column has a heading, and represents a field in a record. Text-entryText-entry panels have an open form in which ASCII text can be entered. This chapter describes how to open and use the Configuration Manager. The discussion in this chapter assumes you know how to use a mouse or other pointing device to: Position the cursor Choose an item Choose a range of text

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 41

USING THE CONFIGURATION MANAGER

Opening the Configuration Manager

OPE NING

TH E

C O NFIG URATI ON M ANA GER

How you open the Configuration Manager depends on your operating system platform. Once opened, the Configuration Manager acts the same for all platforms.

Windows NT or Windows 95 Platform

From the Program Manager
1 Click the FactoryLink icon from the Program Manager window to display the

FactoryLink IV program group.

Double-click here to open the Configuration Manager

If you have more than one FactoryLink application, you may have more than one FactoryLink IV program group. Be sure to open the program group for the desired application.
2 Double-click on the FactoryLink Configuration icon.

From the Command Line

1 Set the FactoryLink application environment variable by entering the following

command at the system prompt. Set FLAPP = c:/flapp

2 Enter the following command to open the Configuration Manager.

flcm

42 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Opening the Configuration Manager

OS/2 Platform
Open the Configuration Manager in one of two ways: either from the Desktop Manager or from the command line if you are running FactoryLink on an OS/2 operating system. Both methods are described below. From the Desktop Manager
1 Choose FactoryLink OS/2 from the Desktop Manager menu to display the applications

available with the FactoryLink group.

Double-click here to open the Configuration Manager

2 Double-click the left button to open the Configuration Manager.

From the Command Line

1 Set the FactoryLink application environment variable by entering the following

command from the system prompt. Set FLAPP = c:/flapp

2 Enter the following command to open the Configuration Manager.

flcm

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 43

USING THE CONFIGURATION MANAGER

Opening the Configuration Manager

UNIX Platform
1 Be sure the FactoryLink application directory environment variable, FLAPP, is set

to the full path name of the directory containing the application you are running. If it is not, set it using the following instructions. If you are using a C shell, enter the following command at the system prompt. setenv FLAPP flapp_dir where flapp_dir is the full path of the directory containing the application. For example, setenv FLAPP /usr/newapp If you are using a Korn or Bourne shell, enter the following command set at the system prompt. FLAPP=flapp_dir export FLAPP where flapp_dir is the full path of the directory containing the application. For example, FLAPP=/usr/newapp export FLAPP
2 Enter the following command at the system prompt to open the Configuration

Manager. flcm

44 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Display

C ONFIG URA TION M AN AGE R D I SPLAY

When you open the Configuration Manager, the following screen is displayed.
Menu Bar

Domain Selection Main Menu

This screen has three major components: Menu bar The menu bar provides access to a group of tools you can use to manipulate or review application data. Main MenuThe Main Menu provides access to configuration tables for each FactoryLink module installed on your system. Double-click the name to choose a module. Refer to Chapter 1, Overview, for a list of possible modules. Domain selectionThe domain selection menu controls which domain you are opening when you choose a module from the Main Menu. This can either be shared or user. The default is the same as the domain specified in the FLDOMAIN environment variable. Refer to Chapter 1, Overview, for a discussion on FactoryLink environment variables. Double-click on the desired domain or be sure to press Enter after choosing a domain, or the domain does not change. Refer to Chapter 1, Overview, for details on which domain to select for each application.

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 45

USING THE CONFIGURATION MANAGER

Working with Text-entry Panels

W ORK ING

W ITH

T EXT - EN TRY PA NELS

Open configuration tables by selecting a module from the Main Menu. Data is entered in configuration tables through either structured panels or text-entry panels. This section discusses text-entry panels and their characteristics. Text-entry panels do not have defined data-entry fields.

Menu Bar

Data Entry

Text-entry configuration panels contain the following areas: Menu barThe menu bar provides access to a group of tools you can use to manipulate or review configuration and application data. Data entryType ASCII text in the data entry area.

46 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Structured Configuration Panels

WO RKIN G

W ITH

STRU CTUR ED C ONFI GUR ATION P ANE LS

You open configuration tables by choosing a module from the Main Menu. Data is entered in configuration tables through either structured panels or text-entry panels. This section discusses structured panels and their characteristics. Configuration tables are typically built using structured panels. Each table has one or more panels. Each panel contains a number of data entry fields formatted in columns.
Menu Bar Field Names

Data Entry

Command Buttons

Structured configuration panels contain the following areas: Menu bar The menu bar provides access to a group of tools you can use to manipulate or review configuration and application data. Field namesThis area lists the names of fields pertaining to the configuration table. Data entry You type data for each table entry in this area. Use the following keypad keys to move around in the data entry section. Press TAB to move forward from one field to the next. If the current field is the last field in a row, the cursor moves to the first field of the next row. Press SHIFT + TAB to move backward from one field to the next. If the current field is the first field in a row, the cursor moves to the last field of the previous row. Use the and keys to move up or down within a column in a panel. You can optionally use a mouse to choose a field.

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 47

USING THE CONFIGURATION MANAGER

Working with Structured Configuration Panels

There are two ways to update information entered on this panel to the configuration table. Press the ENTER key on the keyboard. All line entries are updated to the configuration table. Press the TAB key at the end of each line rather than ENTER if you want to fill out the entire table before adding the data to the configuration table. Choose the Enter command button. All line entries are updated to the configuration table. Command buttonsButtons that execute commands when you choose them. CancelCancels any data entered that has not already been updated to the configuration table. EnterUpdates the configuration table with any data entered since the last update. ExitReturns you to the Main Menu. If you have not saved changes, FactoryLink asks you if you want to save or discard. NextDisplays the next panel in a sequence of panels. If the current panel displayed is the last panel in the sequence, the first panel is displayed. PrevDisplays the previous panel in a sequence of panels. If the current panel displayed is the first panel in the sequence, the last panel is displayed.

48 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Scrolling a Window or Panel

SCR OLLIN G

W IN DOW

OR

P ANEL

If a window or panel contains more rows or columns than can be displayed in the available area, it contains a scroll bar which indicates more data is available for viewing. A window or panel can contain both or either a vertical and horizontal scroll bar.

Vertical Scroll Bar

Slider Bar

Horizontal Scroll Bar

Push Button

Scroll bars end in small buttons with arrows, called push buttons. Use these buttons to move the data in the window up and down one line at a time, or left and right one column at a time. A scroll bar also contains a rectangle called a slider box. The slider box indicates the area of data to display. You can drag the slider anywhere along the horizontal scroll bar.

3
Using the Configuration Manager

Vertical Scroll Bar

Use the vertical scroll bar to move the windows contents up and down in two ways. Point to the pushbutton at either end of the scroll bar and click the left button to move up or down one line. Position the pointer above or below the slider box and click the left button to move up or down one page.

FactoryLink ECS / Fundamentals / 49

USING THE CONFIGURATION MANAGER

Scrolling a Window or Panel

This scroll bar does not reflect the relative position in a panel and its slider box remains in a fixed position. Do not attempt to select this slider box and move it with the mouse. The results are unpredictable.

Horizontal Scroll Bar

Use the horizontal scroll bar to move the windows contents to the right or to the left in three ways: Point to the push button at either end of the scroll bar and click the left button to move to the left or right one column at a time. Choose the slider box and press and hold the left button while moving slider box along the vertical scroll bar to scroll horizontally. Release the left button when you finish. Point to the left or right of the slider box and click the left button to jump left or right.

50 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Multiple Development Applications

WO RKIN G

W ITH

MU LTIPLE D EVELO PME NT A P PLICATIO NS

You can use the Configuration Manager to develop any number of applications simultaneously; however, each application requires a unique directory for storing configuration tables. For example, assume you are building two applications: one for collecting data from a station in the Southern part of town and another for collecting data from a station in the Northern area. Both applications are located on the C: drive. The path to the Southern development application is \station\south; the path to the Northern development application is \station\north. The following sections describe how to open different applications and share information between them.

Opening a New Development Application

Although you can develop multiple FactoryLink applications simultaneously, you can actively work on only one at a time. When you open the Configuration Manager, the application located in the default FLAPP directory is active. Perform the following steps to open a development application other than the default application.
1 Choose Close from the Configuration Manager Application pull-down menu to close

the active application. Only one application can be open at a time.

2 Choose Open from the Application menu. You are prompted for the directory

containing the application you wish to open.

3
Using the Configuration Manager

Click here if you need help

3 Enter the full pathname of the directory containing the application you want to open. 4 Choose the command button of the operation you want to perform. Enter

To open the application. For example, if you want to open the Southern application, enter C:\station\south.

FactoryLink ECS / Fundamentals / 51

USING THE CONFIGURATION MANAGER

Working with Multiple Development Applications

Cancel Help

To return to the Configuration Manager without choosing an application. To get help.

Sharing Information Between Applications

Often, two applications are similar. When this is the case, you can save development time by exporting database files from one application and importing them into another application. This section describes how to export and import application database files. Exporting an Application Exporting converts all database files into ASCII text files in preparation for being imported into another application. Once files are exported, they are saved in the FLAPP default directory. Tables in the shared domain are saved in the FLAPP/SHARED directory; tables in the user domain are saved in the FLAPP/USER directory. Each table generates its own file; each file name includes an .exp extension. The .exp files can be edited using an ASCII text editor; however, any editing error can cause cascading errors in a FactoryLink application, so use care when editing these files. Perform the following steps to export database files from one application so they can be imported to another application.
1 Open the application you want to export. Refer to the Opening a New

Development Application on page 3-51 for details on opening an application.

2 Choose Utilities from the Configuration Manager or configuration panel menu bar. If

you open it from the Configuration Manager, the entire application is exported. If you open it from a configuration panel, only that panels information is exported.

The following pulldown menu is displayed.

3 Choose Export from the pulldown menu. The database files are exported.

52 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Multiple Development Applications

Importing an Application Importing converts ASCII text files created using the export function to database files in a new application. If a file with the same name already exists in the application when you import a file, the contents of the imported file are placed at the end of the existing file. Use care when doing this as no merging occurs. Duplicate records may be inserted. Perform the following steps to import database files to an application.
1 Export the database files for the application you want to import to a new application.

Refer to the Exporting an Application on page 3-52 for details on how to do this.
2 Open the application where you want to import the exported application data. Refer

to the Opening a New Development Application on page 3-51 for details on opening an application.
3 Choose Utilities from the Main Menu or configuration panel menu bar. If you choose it

from the Main Menu, the entire application is imported. If you choose it from a configuration panel, only that panels information is imported.

The following pulldown menu is displayed.

4 Choose Import. The following dialog box is displayed requesting the name of the file

you want to import.

3
Using the Configuration Manager

5 Enter the full pathname of the directory containing the file(s) you want to import.

FactoryLink ECS / Fundamentals / 53

USING THE CONFIGURATION MANAGER

Opening Multiple Configuration Tables

OPE NING M ULTI PLE C O NFIG URA TION T AB LES

When you are configuring an application, sometimes you must fill out configuration tables for multiple modules. For example, if you are configuring logging of data from the real-time database to a relational database, you must define tables in the Historian, Schema, and Logger modules. It can be beneficial in these cases to open configuration tables for multiple modules at the same time. Perform the following steps to open multiple configuration tables.
1 Choose View from the Main Menu or configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose Main Menu. This makes the Main Menu the active panel. 3 Choose the module you want to open. This displays the panels comprising the

configuration table for the selected module.

54 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

WO RKIN G

W ITH

T AGS

This section describes how to manipulate tags defined in the application.

Viewing the Number of Tags Defined

1 Choose Application from the Main Menu menu bar.

The following pulldown menu is displayed.

2 Choose Size to display information about the number of tags defined in the

FactoryLink application. The following screen is displayed.

Total Number of Tags Efficiency of Memory Used by the Real-time Database Number of Tags Defined by User

3 Choose OK to cancel this screen.

3
Using the Configuration Manager

As the memory used by the real-time database becomes less efficient, the efficiency percentage drops, indicating wasted space. You can improve this by running the following command. ctgen -r -c

FactoryLink ECS / Fundamentals / 55

USING THE CONFIGURATION MANAGER

Working with Tags

Viewing a List of Real-time Database Elements

When a tag referencing a real-time database element is created in the application, it is added to an element list. Perform the following steps to view the real-time database elements configured for this application.
1 Choose View from the Main Menu bar or from the configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose Object List. The following list is displayed.

56 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

This list contains an entry for each tag defined in the application. Tags are listed in alphabetical order. The list contains the following information for each entry.
Tag Domain Type Description Task Value Seg.

Logical name assigned to reference the real-time database element. Domain in which the element is configured. This can be either shared or user. Data type of the element. Refer to Chapter 2, Working with Tags in Configuration Manager, for a complete list of data types. Description of the purpose of the element. You can modify the entry in this field. Unused. Start up value for the tag. You can modify the entry in this field. Segment number where element is stored in the real-time database. FactoryLink uses the entry in this field in combination with the entry in the Offs. field to determine the location of the element. Offset number assigned to the element by FactoryLink. FactoryLink uses the entry in this field in combination with the entry in the Seg. field to determine the location of the element. Unused. This field is currently not used. Array dimension size, if this entry is part of an array. Sizes are 1-based and are separated by commas. If the element is not an array, this field is blank. Used only for message elements, indicates maximum number of characters permitted in the message. You can modify the entry in this field. Type of persistence assigned to this element. You can modify the entry in this field. Refer to Persistence in the Core Tasks Configuration Guide for more information on the options. Indicates whether or not an elements change status flags are set to 1 (ON) or 0 (OFF) during a warm start. This column is blank if NONE is present in the Persistence field. You can modify the entry in this field.

Offs.

Size Flags Dimension

Msg LEN.

3
Using the Configuration Manager

Persistence

Change Bits

3 Choose Exit to exit this list.

FactoryLink ECS / Fundamentals / 57

USING THE CONFIGURATION MANAGER

Working with Tags

Viewing Element Cross Reference List

A tag referencing a real-time database element can be used multiple times throughout the application. The element cross reference list defines each instance where the tag is used in the application. Perform the following steps to view where references to real-time database elements are displayed in the application.
1 Choose View from the main menu bar or from the configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose X-ref List. The following list is displayed on the screen.

58 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

This list contains an entry for each instance a tag is referenced in the application. The information displayed for each instance is described below.
Tag Name

Logical name assigned to reference the element in the real-time database. Each element will be displayed in this list as many times as it is referenced. Dimension of the tag if the tag is part of an array. Domain where element is referenced. FactoryLink module using element. Panel name referencing element. If this is a drawing, type of animation applied to element. Table name referencing element. If this is a drawing, name of drawing referencing element. Record number referencing element. If this is a drawing, object name assigned to object referencing element. Column name referencing the element. If this is a drawing, name of field in Animation dialog box referencing element. Sub-record referencing element. If animation type is Pen, name of pen referencing element.

Tag Dimension CT Domain Task Name CT Name/Anim Type Table Name/ Drawing Record/ Object Name Column Name/Anim Field Sub-record/ Pen Name

3 Select Exit to exit this list.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 59

USING THE CONFIGURATION MANAGER

Working with Tags

Searching for a Tag

Typically there are a large number of tags defined in an application. Therefore, a mechanism for searching for a tag by name is provided. Use the following procedure to search for a specific tag in either the element list or element cross reference list.
1 Choose View from the main menu bar or from the configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose either Object List or X-ref List , depending on the kind of information you want to obtain about the element. For example, choose Object List to display the following

element list.

60 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

3 Choose View from the configuration panel menu bar. The following pulldown menu is

displayed.

4 Choose Search. You are prompted for the name of the tag you want to find.

5 Enter the name of the tag you want to find and choose Enter . You can use an asterisk

(*) in the name as a wildcard.

6 Choose Next from the View pulldown menu if you want to find the next occurrence of

the search pattern .

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 61

USING THE CONFIGURATION MANAGER

Working with Tags

Deleting a Tag Definition

When you delete a tag from a graphics picture or configuration panel, the tag definition is not deleted from the element list. Perform the following steps to delete a tag definition.
1 Choose View from the main menu bar or from the configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose X-ref List. The following list is displayed on the screen.

3 Check this list to be sure the tag you are deleting is not used anywhere else in the

application. If it is, you will not be able to delete the definition from the elements list until each reference is deleted.

62 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

4 Choose Object List from the View pulldown menu once all references to the tag are

removed.

5 Position the cursor on the line representing the tag you want to delete. 6 Choose File from the configuration panel menu bar. The following pulldown menu is

displayed.

7 Choose Delete from this pulldown menu. The tag is deleted from the application.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 63

USING THE CONFIGURATION MANAGER

Working with Tags

Changing a Tag Definition

Once a tag has been defined, perform the following steps to change its definition.
1 Position the cursor in a configuration panel field containing the tag name you want

to edit.
2 Choose View from the Configuration Manager menu bar.

The following pulldown menu is displayed.

3 Choose Tag Attributes. The Tag Definition dialog box is displayed.

64 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Working with Tags

4 Choose the Edit command button. 5 Edit the fields you want to change. Refer to Chapter 2, Working with Tags in

Configuration Manager, for descriptions of fields on this panel. Or, you can press Ctrl+T to display this panel.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 65

USING THE CONFIGURATION MANAGER

Viewing Miscellaneous Information

VIE W ING M ISCELLA NEO US IN FO RM ATIO N

The Configuration Manager provides the following tools to view information about the FactoryLink application you are developing. Using these tools, you can view the following. Current version of FactoryLink Number of domains defined for an application

Viewing Domain List

1 Choose View from the main menu bar or from the configuration panel menu bar.

One of the following pulldown menus is displayed.

View pulldown menu from configuration View pulldown menu from Main Menu

2 Choose Domain. The following list is displayed on the screen.

66 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Viewing Miscellaneous Information

This list contains an entry for each domain defined. This will be one shared domain and one user domain. The information displayed for each domain is described below.
Domain Parent #INST

Domains configured for the application. The parent of the domain. For user domain, this is shared. The shared domain does not have a parent. Number of users that can open the domain at any one time. For shared domain, this defaults to 1 and should not be changed. For user domain, this defaults to 2 and should be changed to the maximum number of users you want to open the application at any one time. Type of persistence assigned to this element. You can modify the entry in this field. Refer to Persistence in the Core Tasks Configuration Guide for more information on the options. Indicates whether or not an elements change status flags are set to 1 (ON) or 0 (OFF) during a warm start. This column is blank if NONE is present in the Persistence field. You can modify the entry in this field.

Persistence

Change Bits

3 Choose Exit to exit this panel.

Viewing the Current Version of FactoryLink

1 Choose Help from the main menu bar or configuration panel menu bar.

The following pulldown menu is displayed.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 67

USING THE CONFIGURATION MANAGER

Viewing Miscellaneous Information

2 Choose About to display the current version of FactoryLink. The following screen is

displayed.

3 Choose Enter to cancel this screen.

Viewing Field Choices

When you are filling out a field on the configuration panel that has a predetermined set of valid entries, you can view those entries using the following procedure.
1 Position the cursor in a configuration panel field that has a predefined set of valid

entries.
2 Choose View from the Configuration Manager menu bar.

The following pulldown menu is displayed.

68 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Viewing Miscellaneous Information

3 Choose Field Choices. This displays a list of your choices.

4 Choose your option and press Esc. Your choice is updated to the field. Or, you can press Ctrl+K to display this list.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 69

USING THE CONFIGURATION MANAGER

Editing Configuration Panels

ED ITING C O NFIGU RATIO N PA NELS

FactoryLink provides some editing tools to aid in editing configuration panels. Access these tools by choosing Edit from the configuration panel menu bar. One of the following pulldown menus is displayed.

Edit pulldown menu from text-entry panels

Edit pulldown menu from Structured Panels

The following sections describe the available editing functions.

Inserting a Blank Line

1 Position the cursor on the line below where you want the blank line. 2 Choose Insert from the Edit pulldown menu.

A blank line is inserted above the current line.

Deleting a Line Entry

1 Position the cursor on the line you want to delete. 2 Choose Delete from the Edit pulldown menu.

Before deleting the line, the system validates the display and reports any validation errors encountered. If none are encountered, it updates the real-time database.

70 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Editing Configuration Panels

3 Correct any validation errors and try again.

CAUTION If you want to delete a line entry from a control panel that has information defined on the corresponding information panel, you must first delete the information panel definition. If you do not, the data defined on the information panel becomes orphaned and cannot be deleted, although it will still be displayed on the cross-reference list. This is also true if you change the table name on the control panel.

Copying Contents of a Line Entry

.
1 Position the cursor in the first line of the block to be copied. 2 Choose Copy from the Edit pulldown menu. 3 Move the cursor to the last line in the block to be copied. The selected block is

highlighted.
4 Choose Copy from the Edit pulldown menu. The selected block is copied to the Paste

buffer. Choose Reset Mark from the Edit pulldown menu to cancel the copy operation in a text-entry panel .

Cutting a Line Entry

1 Position the cursor in the first line of the block to cut. 2 Choose Cut from the Edit pulldown menu. 3 Move the cursor to the last line in the block to cut. The selected block becomes

3
Using the Configuration Manager

highlighted.
4 Choose Cut from the Edit pulldown menu. The selected block is cut from the panel

and copied to the paste buffer. Choose Reset Mark from the Edit pulldown menu to cancel the cut operation in a text-entry panel.

FactoryLink ECS / Fundamentals / 71

USING THE CONFIGURATION MANAGER

Editing Configuration Panels

Although the cut option resembles the delete option in that the selected data is removed from the panel, the delete option does not move the data to the paste buffer. Unlike material that has been cut, deleted material cannot be reinserted in the panel.

Pasting a Copied or Cut Line Entry

1 Perform a copy or cut operation as described above. 2 Position the cursor where you want the copied or cut data inserted. 3 Choose Paste from the Edit pulldown menu.

You can paste the block more than once because the Paste operation does not clear the paste buffer.

Searching for a Text String

1 Choose Search from the Edit pulldown menu. The following panel is displayed.

2 Enter the text you want to find. 3 Choose the Enter button to start the search. FactoryLink locates the next occurrence

of the text in the current file, starting at the cursor position and searching downward. Repeat this action to search for any additional entries of the text. Choose Cancel to end the search and return to the Configuration Manager.

72 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Getting Help

GETTIN G H ELP
1 Choose Help from the main menu bar or configuration panel menu bar.

One of the following pulldown menus is displayed.

Help pulldown menu from text-entry panels

Help pulldown menu from Structured Panels

2 Choose one of the following, depending on the kind of help you want. Panel Help Extended Help Field Help Field Error Help

Provides a brief explanation of the active configuration panel. Provides general information about using the Configuration Manager. Provides a brief explanation of the current field. Provides help on errors. Provides information on any errors reported for this panel.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 73

USING THE CONFIGURATION MANAGER

Managing Text-entry Panel Files

M ANA GING T EXT - ENTR Y P ANE L F ILE S

FactoryLink provides tools to aid in managing the files created using text-entry panels, such as in Math & Logic or Report Generator. Perform the following steps to access these tools.
1 Choose File from the text-entry panel menu bar.

The following pulldown menus is displayed.

The following section describes the available file management functions.

Saving File Contents

Choose Save from the File pulldown menu to save the file as it is currently displayed. To avoid losing large amounts of data as the result of a power failure or other unexpected occurrence, save the file often. The Save operation does not validate the data.

Merging a File
1 Position the cursor on the line above the line where you want to insert the text file. 2 Choose Merge from the File pulldown menu. The following dialog box is displayed.

74 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Managing Text-entry Panel Files

3 Specify the name of the file to merge with the current file and press the Enter key.

Checking Syntax
Choose Validate from the File pulldown menu to check the current file for correct syntax. If invalid entries exist, an error message is displayed and the errors are highlighted.

Clearing Errors
Choose Clear Err from the File pulldown menu to clear all validation error flags from the current file. Clear Err does not remove or correct the errors. It simply removes the highlighting from the errors and makes it easier to read the display.

Changing Font Size

The default font for text-entry panels is Courier and the font size is 20. You can change the font size using the FLFONT environment variable. For example, to change the font size to 30, enter the following command at the system prompt. set FLFONT=30

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 75

USING THE CONFIGURATION MANAGER

Reporting

R EPO RTING
1 Choose Utilities from the main menu bar or from the configuration panel menu bar. If

you choose it from the main menu bar, the report is generated for the entire application. If you choose it from a configuration panel menu bar, the report is generated for that panel.

The following pulldown menu is displayed.

2 Choose Report . The following dialog box is displayed requesting information about

how and where to generate the output.

3 Define the following fields. Heading Filename Columns Lines

Name of the table to include in the report. Enter the name as it is displayed on the Main Menu. Name of the file to receive the output. The default file name is FLAPP\ALL.TXT. Width of the report in number of characters permitted on a single line. The default is 80 characters. Length of the report in number of lines permitted on a single page. The default is 60.

76 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Reporting

4 Choose Enter to process the report. FactoryLink converts the specified table to ASCII and sends it to the specified disk file. Or, choose Cancel to return to the

Configuration Manager without generating a report.

5 View or print the report using any text editor. The report has a title page, a table of

contents, and a section for each task configured in your application. A portion of a sample report is shown below. The sample shows the information provided for each task.

3
Using the Configuration Manager
FactoryLink ECS / Fundamentals / 77

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

C ON FIGUR ATIO N M A NAG ER M ESSAG ES

If errors occur while you are configuring a table, the Configuration Manager Main Menu error messages are displayed on the screen. This section lists these messages, describes their cause, and provides suggested actions. AC file doesn't exist for domain file Cause: The FLINK /AC/DOMAIN.AC does not exist or cannot be opened. If it does not exist, FactoryLink installation may have not completed normally. If the file cannot be opened, it may already be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

AC file doesn't exist for tag file Cause: The FLINK /AC/OBJECT.AC does not exist or cannot be opened. If it does not exist, FactoryLink installation may have not completed normally. If the file cannot be opened, it may already be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

AC file doesn't exist for type file Cause: The FLINK /AC/TYPE.AC does not exist or cannot be opened. If it does not exist, FactoryLink installation may have not completed normally. If the file cannot be opened, it may already be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

AC file doesn't exist for XREF file Cause: The FLINK /AC/XREF.AC does not exist or cannot be opened. If it does not exist, FactoryLink installation may have not completed normally. If the file cannot be opened, it may already be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

78 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't copy, cut block in progress Cause: Action: A copy operation was attempted while a cut block was in progress. Complete the cut or cancel it with the Esc key or the CANCEL button.

Can't create database file Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred or your hard drive is full. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Cant create edit window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 79

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't create help dialog box Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Can't Cut, Copy Block in progress Cause: Action: A cut operation was attempted while a copy block was in progress. Complete the copy or cancel it with Esc or Cancel.

Can't cut/copy without an enter Cause: Action: A cut or copy operation was attempted, but Enter key was not pressed. Complete the operation by pressing the Enter key or cancel it with Esc or Cancel .

Can't delete database rows without an enter Cause: Action: The current panel contains invalid information. The system will not function further until the validation errors are removed. Choose Cancel to correct the validation errors, or press the Esc key to erase all input since the last validation, .

Can't delete from read-only table Cause: Action: A delete operation was attempted on a read-only table. Do not attempt to perform a delete operation.

80 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't delete, block operation in progress Cause: Action: Can't execute Cause: Action: Can't find AC Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. The specified file does not exist or has been damaged. Re-install FactoryLink. A delete operation was attempted while a block operation was in progress. Complete the deletion or cancel it with Esc or Cancel.

Action:

Can't find tag to be deleted from x-ref database Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible.

3
Using the Configuration Manager

Action:

FactoryLink ECS / Fundamentals / 81

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Can't find window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Can't insert at this point in database file Cause: You tried to insert a row in a configuration panel between consecutively numbered rows; rows cannot be inserted between consecutively numbered rows. Insert the row either before or after the two consecutive rows or resequence the panel. To resequence the panel, use the Configuration Manger Cut function to cut the consecutively numbered rows from the panel. Then, use the Paste function to reinsert the rows. Now, you can insert a row between the two rows. You can also resequence all the rows of data you can view in the panel at one time, or even resequence all of the data in the panel.

Action:

Can't insert into read-only table Cause: Action: An insert operation was attempted on a read-only table. Do not attempt to perform an insert operation.

82 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't insert/delete while cut/copy is in progress Cause: Action: An insert or delete operation was attempted while a cut or copy operation was in progress. Complete the cut or copy operation or cancel it with the Esc key or Cancel box. Retry the insert or delete operation.

Can't load external validation module Cause: Action: The module may not exist in the specified path or may have been damaged. Re-install FactoryLink.

Can't locate options key Cause: Action: The option key may not be installed, or the license may not be enabled. Check that the key is installed. Verify the license is enabled by running the KEYINST and FLKEYVAL utilities.

Can't make frame window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

3
Using the Configuration Manager

FactoryLink ECS / Fundamentals / 83

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't make subframe window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Can't make task list window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Can't open AC file Cause: The specified AC file does not exist or cannot be opened. If it does not exist, FactoryLink installation may not have completed normally. If the file cannot be opened, it may be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

84 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Can't open file Cause: Action: The system cannot open an output file. The disk may be full, or the path may not exist. Delete any unnecessary files if the disk is full. Create the path if it does not exist.

Can't open FL.OPT file Cause: Action: The FL.OPT file has become corrupt or been deleted. Or the FLINK environment variable is not set. Check the value of the FLINK environment variable. Also, verify the FL.OPT file exists in the directory FLINK/OPT.

Can't paste - paste buffer is empty Cause: Action: An attempt has been made to perform a paste operation, but the block to be pasted was not moved to the paste buffer. Move the block to be pasted to the paste buffer by performing a copy or cut operation. Then, retry the paste operation.

Can't paste at this point in database file Cause: Action: You tried to paste a row between consecutively numbered rows; you cannot insert rows between consecutively numbered rows. Paste the row either before or after the two consecutive rows or resequence the panel. To resequence the panel, use the Main Menu Cut function to cut the consecutively numbered rows from the panel. Then, use the Paste function to reinsert the rows. Now, you can insert a row between the two rows. You can also resequence all the rows of data you can view in the panel at one time, or even resequence all of the data in the panel.

3
Using the Configuration Manager

Can't process command line Cause: Action: The command line you entered to the Main Menu has an invalid argument. Enter a valid command line argument.
Command Description

-Pxxxxxxxx -Axxxxxxxx

xxxxxxxx = name of Program directory xxxxxxxx = name of Application directory

FactoryLink ECS / Fundamentals / 85

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

-Lxxxxxxxx -Txxxxxxxx Can't read domain database Cause: Action:

xxxxxxxx = name of Log device/file xxxxxxxx = name of Program Title

The file DOMAIN.CDB is either missing or corrupted. Copy the DOMAIN.CDB file from another application. If you do not have another application, run FLNEW to create one. (However, make sure the new one is created in a different directory.) Refer to the Installation Guide for information about running FLNEW. After you copy the file, re-start the application. The FLAPP is not set to a valid application. Set the FLAPP to a valid application.

Cause: Action:

Can't read options key Cause: Action: The option key file FL.OPT has become corrupt. Copy the file FLNEW.OPT from the installation diskette to the file FLINK/OPT/FL.OPT.

Can't read type database Cause: Action: The file DOMAIN.CDB is either missing or corrupted. Copy the DOMAIN.CDB file from another application. If you do not have another application, run FLNEW to create a one. (However, make sure the new one is created in a different directory.) Refer to the Installation Guide for information about running FLNEW. The FLAPP is not set to a valid application. Set the FLAPP to a valid application.

Cause: Action:

Can't update with null table name Cause: Action: No Table Name for this panel. Return to the Control panel and move the cursor to the line containing the correct table name. Return to the Information panel. The correct table name should now be displayed in the Table Name field.

86 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Col number filename Cause: Action: The specified column contains an invalid entry. Open the column and correct the entry.

Configuration Manager must be closed before exiting Windows Cause: Action: You attempted to exit the Windows operating system before exiting the Main Menu. Exit the Main Menu before exiting Windows.

Couldn't create input window Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Couldn't get external module address Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible.

3
Using the Configuration Manager

Action:

FactoryLink ECS / Fundamentals / 87

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Couldn't start text editor Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Database error Cause: Action: A .CDB or .CDX file is corrupt. Run the utility DBCHK to locate and repair corrupt .CDB and CDX files. For information about DBCHK, see Chapter 7, FactoryLink Utilities, in this manual. The operating system, third-party software, or hardware setup on your system is incorrect or incompatible. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. An internal error has occurred. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Cause: Action:

Cause: Action:

88 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Database doesn't contain any printable records Cause: Action: A report or export operation was attempted on an empty database file. Do not attempt to export or report this database file.

Error allocating panel. Maximum = 12 Cause: Action: Twelve panels are already created and displayed. Close some panels and then reopen the desired panel.

Error allocating table structure Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Error closing database Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible.

Action:

3
Using the Configuration Manager

Action:

FactoryLink ECS / Fundamentals / 89

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Error opening database file Cause: The specified .CDB database file does not exist. The user does not have sufficient privilege to access the file. The file is corrupted. Verify the following: 1. The existence of the database file. 2. The user has proper privilege to access the file. 3. The integrity of the database and index files using the DBCHK utility. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Error opening index file Cause: The specified .MDX database file does not exist. The user does not have sufficient privilege to access the file. The file is corrupted. Verify the following: 1. The existence of the index file. 2. The user has proper privilege to access the file. 3. The integrity of the index file using the DBCHK utility. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Error selecting index Cause: Action: The specified index name does not exist. The file is corrupted. Verify the following: 1. The existence of the index file. 2. The integrity of the index file using the DBCHK utility. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Expected xxxxx Cause: Action: The .AC parser did not find what it expected. Fix the .AC and try again.

90 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Expected:expected record length /Found:actual record length Cause: The record read was longer than expected. The file being imported may not have come from an export of the same database. The wrong file may have entered. Ensure the correct file is being used.

Action:

External command line too long Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

External modules not supported at this time Cause: This error is displayed only on FactoryLink for OS/2 or Windows. The Main Menu cannot load an external module. Either the module may not exist in the path or it may have been damaged. Run CHKDSK. If there are no problems with the disk files, re-install FactoryLink.

Action:

3
Using the Configuration Manager

Field not in key list Cause: Action: A string has been entered that is not in the key file (FLINK/KEY/xxx.KEY) specified in the .AC file. Modify the string to match, or add the string to the key file. The string must be in the same case as it is in the key file.

FactoryLink ECS / Fundamentals / 91

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

File has been modified since last save. Select OK to destroy changes or CANCEL to return to the edit session. Cause: Action: An exit was attempted from a window in which the changes have not been written to the database. Choose OK to disregard the changes and exit the window . Choose Cancel to return to the edit window.

File is too big Cause: Action: Not enough available memory to load the text file. Close any unnecessary windows or programs. Add memory to the system if this happens often.

filename not in key list

Cause: Action: A string has been entered that is not in the key file FLINK/KEY/xxx.KEY specified in the .AC file. Modify the string to match, or add the string to the key file. The string must be in the same case as it is in the key file.

Flag must be vbru Cause: Action: A flag of other than v, b, r, or u was found in the .AC file. Delete the invalid flag.

Grace period has expired. Software must be registered Cause: Action: FactoryLink was installed without registering it within the 10 day grace period. Run FLKEYVAL and follow the instructions for registration.

I/O error while trying to access the domain file Cause: Action: The index or file may be damaged. Contact Customer Support.

92 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

I/O error while trying to access the tag file Cause: Action: The index or file may be damaged. Exit the Main Menu and try again. If this doesn't work, delete the index file (.MDX) and rebuild it.

I/O error while trying to access the XREF file Cause: Action: Internal error Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. The index or file may be damaged. Contact Customer Support.

Action:

Invalid dimension definition Cause: Action: The screen contains an invalid definition for dimension. Move the cursor to this field and choose Error Help or press the Alt-E key sequence to find out the reason for the failure.

3
Using the Configuration Manager

Invalid dimension size Cause: Action: The screen contains an invalid definition for dimension. The specified dimension may exceed size limitations. A dimension cannot exceed 16 characters.

FactoryLink ECS / Fundamentals / 93

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Invalid dimension syntax Cause: Action: The screen contains an invalid definition for dimension. Move the cursor to this field and choose Error Help or press the Alt-E key sequence to find out the reason for the failure .

Invalid fields Cause: Action: The screen contains invalid information. Move the cursor to this field and choose Error Help or press the Alt-E key sequence to find out the reason for the failure.

Invalid file name Cause: Action: The specified file name is missing, too long, or has the wrong format. Enter a valid file name.

Invalid tag or dimension string length Cause: Action: The screen contains an tag or dimension string that exceeds the allowable size. The specified item exceeds size limitations. An element name cannot exceed 32 characters and a dimension cannot exceed 16 characters (total 48 characters). Correct the item that exceeds the size limitations.

Missing KEY file Cause: Action: Multiple panels Cause: Action: There is more than one panel statement in the AC window definition. Delete unnecessary panel statements. The system can't find the KEY file FLINK/KEY/xxx.KEY. Enter the correct key file name in AC or create the desired key file.

94 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

No dialog for file selection Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

No dialog for tag selection Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

3
Using the Configuration Manager

No error Cause: Action: The current error field contains a valid entry. No action required.

FactoryLink ECS / Fundamentals / 95

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

No help yet Cause: Action: A .hlp file was not present for this field. Verify the related .hlp file is present in the FLINK /MSG directory and then run MKHELP.EXE.

No names in TITLES file Cause: Action: The file FLINK /AC/TITLES does not contain any .AC file names. FactoryLink installation may not have completed normally. Re-run the FactoryLink installation.

No message queue Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

No panel is defined Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible.

Action:

96 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. No RAM for ... Cause: Action: There is no more available RAM. Close any unnecessary windows or programs. Add RAM to the system if this happens often.

No TITLES file Cause: The specified .AC file does not exist or cannot be opened. If it does not exist, FactoryLink installation may not have completed normally. If the file cannot be opened, it may already be opened by another process. Re-run the FactoryLink installation if the file does not exist.

Action:

No window for tag selection Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

3
Using the Configuration Manager

No window system Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.).

Action:

FactoryLink ECS / Fundamentals / 97

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Non-numeric character in a numeric field Cause: Action: A non-numeric character has been entered in a numeric field. Only characters 0-9, +, -, and . may exist in a numeric field. Delete the non-numeric characters from the field.

(Number of rows) rows were not imported due to errors Cause: Action: Invalid information has been entered. As a result, the system did not import the rows that contained errors. Correct the errors and retry the operation.

Numeric field is greater than maximum Cause: Action: A numeric value has been specified for a field greater than the maximum in the AC. Specify a value smaller than the maximum.

Numeric field is less than minimum Cause: Action: The specified numeric value for a field is less than the minimum in the AC. Specify a value larger than the minimum.

Open edit sessions exist Cause: An attempt has been made to close the Main Menu window while one or more Edit windows were still open. If the Main Menu window is closed while Edit windows are still open, data not written to the database will be lost. Choose OK to exit. Choose Cancel to abort the exit.

Action:

98 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Out of RAM Cause: Action: No more memory is available. Close any unnecessary windows or programs. Add more virtual memory to the system if this error occurs often.

Records can't be deleted from this file Cause: Action: An attempt has been made to delete records from a read-only file. Do not attempt to delete records from this file.

Records can't be pasted to this file Cause: Action: An attempt has been made to paste records to a read-only file. Do not attempt to paste records to this file.

Required field is blank Cause: Action: A field requiring entry is blank. Enter something other than spaces in this field.

Run-time only license. Development option not installed Cause: Action: A task may not be loaded and/or configured because it is not in the option key. Check the option key contents by typing UKEY -l.

Software has not been enabled Cause: Action: An error has occurred with the f1.key file in the opt directory. 1. Run KEYINST and if an invalid or archaic agreement is found, re-enter the configuration information. 2. Run FLKEYVAL and follow the instructions for registration.

3
Using the Configuration Manager

Tag already exists, but is not defined in, or above, the current domain level Cause: Action: You tried to define or reference a user domain element in the shared domain. Assign the element a new name or delete all references to the existing element.

FactoryLink ECS / Fundamentals / 99

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Task is not installed properly Cause: Action: A task may not be loaded and/or configured because it is not in the option key. Check the master and option key contents by typing UKEY -l.

The system couldn't open the object, xref, or type database Cause: Action: Cause: Action: FLAPP is not set to a valid application directory. Set FLAPP to a valid application directory. The index or file specified may be damaged. Exit the Main Menu and try again. If this doesn't work, run DBCHK to identify the corrupt index file. Then, delete the index file (.MDX and rebuild it. For information about DBCHK, see Chapter 7, FactoryLink Utilities, in this manual.

The Tag name element name contains one or more invalid characters Cause: Action: The element name specified contains one or more invalid characters. Correct the element name. The first character of the element name must be alphabetic or one of the following characters: @, $, _. The remaining characters can be numeric also.

The Tag name element name is undefined Cause: The element name specified does not exist. Either a wrong name for an element has been entered, or the specified element has not been defined. Change the string to the name of an existing element or define the element when the system requests a definition.

Action:

The Tag type is invalid Cause: If you are trying to import a file using the Import function, this error can occur if one of the elements being imported has the same name but is of a different data type than one of the elements that already exists in the current application. Either delete the element(s) with the same name from the file to be imported or rename the element. Then, re-import the file.

Action:

100 / FactoryLink ECS / Fundamentals

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Cause: If you are not attempting an Import operation, either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have The correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. There are no errors because the file has not been validated Cause: The VALIDATE function has not yet been used on this file. The standard edit window may mean the Enter key has not yet been entered for this window. It may also mean no validation exists for this application. No action required.

Action:

Action:

Too many keys! Using only 100. Cause: Action: There are too many keys in the key file. The maximum number of keys allowed is 100. Remove enough keys from the key file so there will be only 100.

3
Using the Configuration Manager

Unknown error: error number Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and

Action:

FactoryLink ECS / Fundamentals / 101

USING THE CONFIGURATION MANAGER

Configuration Manager Messages

you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Validation error! Select OK to continue exiting Cause: Action: The text file contains invalid lines. Choose OK to exit with validation errors. Choose Cancel to abort the exit.

102 / FactoryLink ECS / Fundamentals

Chapter 4

Using System Configuration

FactoryLink sets up default run-time parameters in the System Configuration Information panel during FLNEW. The default values displayed on the System Configuration Information panel (as set up within an application newly created by FLNEW) establish the following parameters for the run-time FactoryLink system: Tasks that start up when the application is running Tasks allowed to run as foreground tasks Order in which tasks start up and shut down Priority of each task Domain associated with each task Use this panel if you want to make the following modifications: Change task settings, such as flags and program arguments Re-sequence the order in which tasks start up Change foreground and background task identification Add a new task to an existing application

4
Using System Configuration

FactoryLink ECS / Fundamentals / 103

USING SYSTEM CONFIGURATION

Choose System Configuration from the Configuration Manager Main Menu. The System Configuration Information panel is displayed:

Specify the following information:

Flags

Process to be performed by the system. A task can have multiple flags with flag values entered in any order. The entries and descriptions are as follows: S Session flag - Provides the process with its own window. Any output to that process or task is directed to this window rather than to the Run-Time Manager window. The RUNMGR, RTMON, and GRAPHICS processes require their own windows. R Run flag - Activates this task at FactoryLink startup. To allow a task to be started manually by an operator, do not enter the R flag. F Foreground flag - Puts this task in the foreground at startup. Use the F flag if the task has neither the S nor the R flags.

104 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Task Name

Enter an alphanumeric string of between 1 to 32 characters to define the name of the process (task), such as RECIPE, ALOG, or TIMER. Do not modify these default names. For an external program, define a program name. Enter an alphanumeric string of between 1 to 80 characters to define the description of the task listed in the Task Name field. For example, the description of the SPOOL task is Print Spooler.

4
Using System Configuration

Description

The next six elements contain information about the task at run time. This information is displayed on the Run-Time Manager screen.
Start Trigger

Name of an element that triggers (provides the mechanism for starting) the task. If the Flags field contains an R for this task, at run time a 1 (ON) is written to this element. This causes FactoryLink to start the task automatically. If the Flags field for this task does not contain an R, the task does not start until the operator writes a 1 (ON) to this element by clicking on the task name on the Run-Time Manager screen. The data type for this tag can be digital or analog depending on the kind of data stored in the tag. The default is digital.

Task Status

Name of an element that contains the analog status of the task. This element can have the following analog values: 0 Inactive 1 Active 2 Error 3 Starting 4 Stopping The data type for this tag is analog.

Task Message

Name of an element to which the task listed in the Task Name field writes any run-time messages. These messages appear in the Message column of the Run-Time Manager screen. This element can have the following message values: Inactive Starting Active Stopping Error

The data type for this tag is message.

FactoryLink ECS / Fundamentals / 105

USING SYSTEM CONFIGURATION

Display Status

Name of an element that contains a text version of the status of the process. The task status is displayed in the Status column on the Run-Time Manager screen. The data type for this tag is message. Name of an element that contains the string entered in the Task Name field. This task name is displayed in the Task column on the Run-Time Manager screen. The data type for this tag is message. Name of an element that contains the string entered in the Description field on this panel. The data type for this tag is message. Enter an alphanumeric string of between 0 to 31 characters to define the order in which tasks are started at run time. The task defined with Start Order 0 starts first. Start Order 1 starts next, and so on, until Start Order 31, which starts last. Tasks with the same start order number will start consecutively. The default Start Order for the Run-Time Manager task is 0. Use the following guidelines to determine the Start Order for certain tasks:
Set the Start Order for... To start...

Display Name

Display Description Start Order

Historian Logger Math and Logic

before Logger before Trending coordinated with the functions defined in the procedures. For example, if a procedure is dependent on data from an external device, start EDI before Math and Logic.

Priority

Processing priority for the task. The priority is a three-digit hexadecimal value which is divided into two parts:

CAUTION Unless you are knowledgeable and experienced in setting priorities in the operating system, you might decide to leave the priority at the default value.

106 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

First part (the 2 in 201): Hex value that specifies the operating system class of priority as listed below. This part is inactive in Windows. 0 Current class unchanged 1 Idle 2 (default) Regular 3 Time-critical Note Do not set any FactoryLink task to priority class 0 or 1. Use caution in assigning a task with priority class 3 because a time-critical task takes priority over a foreground task. A foreground task takes priority over regular tasks at run time. Second part (the 01 in 201): Two-digit hexadecimal value (00 to 1F [0 - 31 decimal]) that specifies the priority within the priority class listed above. The higher the number, the higher the priority within the class. Hexadecimal value 00 to 1F (default = 01) Refer to the appropriate operating system guide for programming for further information about processing priority within an operating system. Third part (the 01 in 201): Two-digit hexadecimal value (00 to 1F [0 - 31 decimal]) that specifies the priority within the priority class listed above. The higher the number, the higher the priority within the class. Hexadecimal value 00 to 1F (default = 01) Refer to the appropriate operating system guide for programming for further information about processing priority within an operating system.
Executable File

4
Using System Configuration

Location of the executable file. If this is a relative path name to FLINK, do not use leading spaces. Any path name which has the following format: \DIRECTORY\SUBDIRECTORY\FILENAME For example, bin\iml

FactoryLink ECS / Fundamentals / 107

USING SYSTEM CONFIGURATION

Note Do not use a file extension of .exe for this entry. It is not required and can cause undesirable results if the application is ported to UNIX.
Application Directory Program Directory Program Arguments

This field is reserved for future use. This field is reserved for future use. Values used as the arguments to the process. If this field is blank, no arguments are passed to the task. Program arguments are not case-sensitive. The table below shows valid arguments for applicable tasks:

Table 4-1 Valid Program Arguments

FactoryLink Task Data Alarm Logger

Valid Entries -T

Descriptions Enables the limit value to be written to the limit tag. If the -T option is not specified, the limit value is not initialized upon Data Alarm Logger startup.

# is 2, 3, or 4. The greater the number, the more information you will receive. + is any number between 100 and 2000. * is any number from 2 to 22. The greater the number, the more information you will receive.

108 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Table 4-1 Valid Program Arguments (Continued)

4
FactoryLink Task Batch Recipe Database Browser Historians Math and Logic (Interpreted mode only) SPC Log, SPC View, and SPR Trending Database Logger -L -L -V# -Q+ Log error messages to a file Log error messages with more information (increased verbose level) to a file Increase the size of the Loggers buffer Performs redraw for static objects Uses objects animated value Performs redraw of symbol background Send print requests (except for alarm logs and binary files) to Windows Print Manager instead of directly to the printer. Valid Entries -L -L -V# Descriptions

Using System Configuration

Log error messages to a file Log error messages with more information (increased verbose level) to a file

Run-Time Graphics

-o1 (letter o) -T -P -M

Print Spooler

# is 2, 3, or 4. The greater the number, the more information you will receive. + is any number between 100 and 2000. * is any number from 2 to 22. The greater the number, the more information you will receive.

FactoryLink ECS / Fundamentals / 109

USING SYSTEM CONFIGURATION

Table 4-1 Valid Program Arguments (Continued)

FactoryLink Task FactoryLink Local Area Networking (FLLAN)

Valid Entries -L -L -D*

Descriptions Log FactoryLink FLLAN error messages to a file Log FactoryLink FLLAN error messages with more information (increased verbose level) to a file Log underlying network softwares error messages to a log file Prevents FactoryLink from automatically setting FLLANs Enable/Disable tag to 1 (ON). Log error messages to a file Log error messages with more information (increased verbose level) to a file

-X -R

File Manager

-L -L -D*

# is 2, 3, or 4. The greater the number, the more information you will receive. + is any number between 100 and 2000. * is any number from 2 to 22. The greater the number, the more information you will receive.

110 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Editing Task Information

EDI TING T ASK I NFO RMA TION

The new application utility, FLNEW, establishes default values for tasks in the System Configuration Information panel and associates each task with a specific domain. These defaults and associations are based on evaluation of task performance and are recommended for most applications. You may edit this panel to identify an external program to the system. Although you can make changes in some fields, it is better not to change any fields except Flags and Display Status.

4
Using System Configuration

Viewing Domain Associations

Complete the following steps to view the tasks associated with a specific domain:
1 Ensure the current domain selected is correct in the Configuration Manager

Domain Selection box.

2 Choose System Configuration from the Main Menu.

Double-click on System Configuration to open System Configuration Information panel.

3 Change the domain specified in the Domain Selection box to see the tasks in the

System Configuration Information panel associated with the other domain. Refer to Domains for Run-time Tasks on page 20 for information about domain defaults.

Adding New Tasks

The Run-Time Manager uses pre-defined elements and array dimensions to automatically display items onscreen. These element names and array dimensions appear in the System Configuration Information panel for each task displayed on the Run-Time Manager screen. If you add another task to the Run-Time Manager screen, use the next available array dimension. Determining the Next Array Dimension The next available array dimension is determined by a tasks position in the display sequence. If you view the System Configuration table associated with the SHARED domain, you will find all element names associated with Run-Time Manager end with a dimension of [0], Persistence element names end with a dimension of [1], Timer elements end in [2], and so on. For example, the complete

FactoryLink ECS / Fundamentals / 111

USING SYSTEM CONFIGURATION

Editing Task Information

entry in the Task Status field for the Run-Time Manager task is TASKSTATUS_S[0]. If the information in a field is longer than the number of characters that fit in the allotted space on the screen, part of the entry will scroll out of sight, as shown below: If this is the complete data in the field: Programmable_Counter[7] Then This Is Displayed in the 16-Character Space: Programmable_Cou

To see characters that have scrolled out of sight, press the and keys. The field scrolls to display the text. The bracketed number represents an array dimension. Complete the following steps to add a task to the Run-Time Manager screen:
1 Choose the appropriate domain for the task on the Main Menu. 2 Double-click on System Configuration to open the System Configuration

Information panel.
3 Starting under the last row of information in the System Configuration

Information panel, add the required information about the new task to each field. Use the Copy and Paste functions to copy duplicate information, such as element names, from the previous row.
4 Review the previous task in the task list to determine its dimension. Assign the

new task's element names the next available array dimension. If you used the Copy and Paste functions to copy information from an existing row, modify each array dimension to be the correct value.
5 Choose Enter to save the information when the panel is complete.

The next time you run the application, the new task and its related information is displayed at the bottom of the specified domain's Run-Time Manager screen.

112 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Changing Domain Associations

C HANG ING D O MA IN A SSOC IATIO NS

If an application has special task requirements, you can change its domain associations. Use the Main Menus Delete, Copy, and Paste options from the Edit menu as outlined below.
1 Ensure the current domain selected is correct in the Configuration Manager

4
Using System Configuration

Domain Selection box.

2 Open the System Configuration Information panel from the Main Menu. 3 Choose the task information you want to move. 4 Use the Edit menus Delete function to remove the task information. 5 Modify the row for the last task in the current domain to use the array dimensions

of the deleted task to prevent a blank line from appearing on the Run-Time Manager screen.
6 Choose Enter to save the changes. 7 Ensure the current domain selected is correct in the Configuration Manager

Domain Selection box.

8 Open the System Configuration Information panel. 9 Starting under the last row of information in the System Configuration

Information panel, add the required information about the new task to each field. You can use the Main Menus Copy and Paste functions to copy duplicate information, such as element names, from the previous row.
10 Review the previous task in the task list to determine its dimension. Assign the

new task's element names the next available array dimension.

11 Choose Enter to save the information when the panel is complete.

Note You must add new items to the end of the panel to reflect the appropriate display sequence. See the previous section for more information about adding tasks to the System Configuration Information panel.

FactoryLink ECS / Fundamentals / 113

USING SYSTEM CONFIGURATION

Setting the Run-Time Graphics Windows

SE TTING

THE

R UN -T IME GR APH ICS WIN DO WS

You can determine which window should appear first (top) when the Run-Time Graphics task starts up. Use the Window Management Control panel to specify the top screen. Choose the Windows Management option from the Main Menu. The Windows Manager Control panel is displayed with all fields visible:

Specify the following information:

Top TAG

Name of the element used to determine the top window. The default is TOPWINDOW_U. The valid data type is message. Enter an alphanumeric string of between 1 to 8 characters to define the name of the default top window. This name must also be defined in the Application Editor window configuration. The default is FL_MAIN.

Default

Note New applications created with FLNEW use the default values.

114 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Changing the Windows Color Scheme

C HANG ING

TH E

W IND OW S C OLO R SC HEM E

4
Using System Configuration

If some fields on configuration panels are difficult to read, you can edit the Windows color scheme to make them more legible. Complete the following steps to do this: Note Configuration panels should be easy to read if you use the Windows default color scheme.
1 Choose Control Panel from the Main window in the Windows Program Manager.

The Control Panel dialog is displayed.

2 Choose Color from the Control Panel dialog. The Color dialog is displayed. 3 Choose the Color Palette button. 4 Choose the desired item from the Screen Element list box and choose a new color.

You might change the Highlight, Highlighted Text, and Disabled Text colors so they contrast.
5 Choose OK. 6 Choose Save Scheme to save the changes. The Save Scheme dialog is displayed

with the current color scheme name.

7 Choose OK to save the changes to the current color scheme.

Delete the current color scheme name and enter a new one to save the changes to another name. Then, choose OK. The new color scheme is displayed.

FactoryLink ECS / Fundamentals / 115

USING SYSTEM CONFIGURATION

Archiving Error Messages

A RCH IVING E RR OR M ESSA GES

This section contains information about setting up FactoryLink to create error message log files. Whenever an error occurs in a FactoryLink task at run time, FactoryLink sends a message for display to the Run-Time Manager screen. FactoryLink also sends a longer, more descriptive message to the log file (if the file has been set up). The following FactoryLink tasks can create an error message log file: Batch Recipe Database Logger Database Browser FactoryLink Local Area Networking (FLLAN) File Manager Any Historian Math and Logic (Interpreted mode only) Statistical Process Control (SPC Log, SPC View, and SPR) Trending You can configure FactoryLink to automatically create an error message .LOG file at startup. In Windows NT, .LOG files are stored in the FLAPP/FLNAME/FLDOMAIN/FLUSER/LOG directory. In Windows 95, for tasks configured in the USER domain, the .LOG files are stored in the FLAPP/FLNAME/FLDOMAIN/FLUSER/LOG directory; for tasks in the SHARED domain, the .LOG files are stored in the FLAPP/FLNAME/ FLDOMAIN/SHAREUSR/LOG directory. where
FLAPP FLNAME FLDOMAIN FLUSER

is the environment variable for the application directory. is the environment variable for the application name. is the environment variable for the domain. is the environment variable for the user name.

116 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Archiving Error Messages

FactoryLink creates the log file name using the following format: XXMMDDYY.LOG where

4
Using System Configuration
indicates the FactoryLink task. is the month of the year (1-12). is the day of the month (1-31) is the year since 1900 (00-99).

XX MM DD YY

If you specified during installation you wanted to install the Old version of FLLAN, FLLANs .LOG files will have the following path and file names: FLAPP\NET\FLLANSND.LOG and FLAPP\NET\FLLANRCV.LOG If you configure FactoryLink to create a log file for a task, FactoryLink logs a message in its log file whenever that task generates an error. The messages in the log file are more descriptive than those that appear on the Run-Time Manager screen. For debugging purposes, configure FactoryLink to create log files automatically at startup. Complete the following steps to configure FactoryLink to do this:
1 Choose System Configuration from the Main Menu. The System Configuration

Information panel is displayed.

2 Ensure the current domain selected is correct in the Configuration Manager

Domain Selection box. Locate the corresponding entry for the task in the Task Name field.
3 Place the cursor on the corresponding entry. 4 Tab over to the Program Arguments field. 5 Enter -L, -V# (not case-sensitive) where # is 2, 3, or 4 in the Program Arguments

field. The greater the number, the more information you receive. (Enter -L, -D# where # is any number from 2 to 22 for the File Manager and FLLAN tasks.)
6 Choose Enter to save the information. 7 Repeat steps 2 through 7 for each task that needs a log file.

FactoryLink ECS / Fundamentals / 117

USING SYSTEM CONFIGURATION

Archiving Error Messages

The log files continue to grow at run time as messages are logged to them until the operator shuts down and restarts each task. Then, FactoryLink creates new log files. However, FactoryLink creates only one log file per task per day no matter how many times each task is shut down and re-started in one day. Delete old log files periodically to prevent log files from using too much disk space. You can configure the File Manager task to delete files for you. For example, File Manager can delete them each day at midnight or when the files specified reach a specified size. CAUTION Do not delete the current log file if the task is still running. This causes errors. When you are finished debugging your application, you can remove the Program Arguments from the System Configuration Information panel to eliminate the creation of extra files.

118 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Resizing and Moving Screen Components

R ESIZING

A ND

M OVIN G SC REEN C O MPO NENTS

4
Using System Configuration

You can modify and move the following FactoryLink screen components: Task panels Configuration Manager: the screen, the Main Menu, and the Domain Selection box Application Editor windows The size and position of the screen components will return to their original default values when you exit. Resizing a Screen Complete the following steps to resize a screen component:
1 Position the cursor anywhere on the bounding borders. The cursor changes to a

double-arrow.
2 Move the pointing device in either direction, as indicated by the arrow, to stretch

or shrink the size. Moving a Screen Complete the following steps to move a screen component:
1 Position the cursor on the title bar. Press and hold the left button. If the file was

inactive, it is now active.

2 Move the pointing device to the new location and release the left button.

FactoryLink ECS / Fundamentals / 119

USING SYSTEM CONFIGURATION

Calculating the Number of FactoryLink Processes

C ALCU LATING

TH E

N U MB ER

OF

F ACTO RY L IN K PRO CES SES

Use the following chart to calculate the processes required by FactoryLink. The total number of processes used by FactoryLink is the number of USER domain processes multiplied by the number of users plus the number of SHARED domain processes.
Table 4-2

FactoryLink Processes # of Processes for the USER Domain 1 1 NA 1 1 1 # of Processes for the SHARED Domain 1 1 1 1 1 NA NA NA NA *2 1 NA 2 *2 NA 1

FactoryLink IV Task Run-Time Manager Programmable Counters Event & Interval Timers Interpreted Math & Logic Alarm Supervisor Application Editor

Real-Time & Historical Trending 1 Statistical Process Control: SPCVIEW SPR SPCLOG Print Spooler File Manager: CLIENT SERVER Historian Database Browser Database Logger *2 *2 NA NA 2 NA NA *2 NA

120 / FactoryLink ECS / Fundamentals

USING SYSTEM CONFIGURATION

Calculating the Number of FactoryLink Processes

.
Table 4-3

4
FactoryLink Processes # of Processes for the USER Domain 1 NA NA NA 1 1 NA 1+1 per protocol module # of Processes for the SHARED Domain NA 1 1

Using System Configuration

FactoryLink IV Task Run-Time Monitor Report Generator Batch Recipe Local Area Networking: FLLANRCV FLLANSND External Device Interface

*Unless you are using INGRES, SYBASE, or dBASE IV, only one process is used. If you are using ORACLE, one of the processes counts as an ORACLE user license. NA indicates the USER or SHARED FactoryLink task does not need a process.

FactoryLink ECS / Fundamentals / 121

USING SYSTEM CONFIGURATION

Calculating the Number of FactoryLink Processes

122 / FactoryLink ECS / Fundamentals

Chapter 5

Using Run-Time Manager

Run-Time Manager is the user interface to the run-time environment. You run the application using the Run-Time Manager which allows you to start, monitor, and stop individual FactoryLink tasks. This chapter describes how to open and use the Run-Time Manager.

5
Using Run-Time Manager
FactoryLink ECS / Fundamentals / 123

USING RUN-TIME MANAGER

Setting Command Line Options

SE TTING C OM M AND L IN E O PTION S

There are several run-time options you can use to control how the tasks running in Run-Time Manager execute. These options are listed in the following table.
Table 5-1

Option -d

Action Turns on debug mode. Any errors encountered are logged to the log file. If you specify this option, you can use Ctrl+c to shutdown Run-Time Manager. Defines the full path of the directory containing the application files. This path overrides any path set by the FLAPP environment variable. Defines the full path of the directory containing the FactoryLink programs. This path overrides any path set by the FLINK environment variable. Logs error and other data to log_file. Defines the start/stop timeout, in seconds, for the Run-Time Manager error report process. Starts only the shared domain on a PC platform. The user domain is not started. Turns on verbose mode for .CT generation. Defines the domain name, where domain can either be shared or user. If you specify shared, only the shared domain is started. This overrides the FLDOMAIN environment variable. Defines the name of the application to start. This overrides the FLNAME environment variable. Defines the user name. This overrides the FLUSER environment variable.

-a flapp_dir

-p flink_dir

-l log_file -t timeout -s -v -n fldomain

-i flname -u fluser

124 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Setting Command Line Options

Table 5-1

Option -w warm_start

Action Turns on the warm start mode to reload persistent values. If you specify this option, FactoryLink loads persistent tags with the last value saved for them.

The options you specify using the procedures in this chapter apply to all tasks started for the application. You can set options for individual tasks that override these defaults using the System Configuration module which is accessible from the Configuration Manager Main Menu. Where you define the default run-time options depends on whether you are starting the Run-Time Manager from a FactoryLink icon or from an operating system command line. If you are starting Run-Time Manager from a command line, use the following syntax. flrun options where options is one or more of the options specified in the previous table. Each option is separated by a space. Refer to Accessing Run-Time Manager on page 127 for platform-specific details on starting Run-Time Manager from the command line.

5
Using Run-Time Manager

FactoryLink ECS / Fundamentals / 125

USING RUN-TIME MANAGER

Setting Command Line Options

If you are starting Run-Time Manager from a Windows icon, you must add the desired options on the properties page for the Run-Time Manager icon using the following procedure.
1 Choose the Start FactoryLink icon in the FactoryLink program group. 2 Choose Properties from the File menu on the Windows Program Manager. The

Program Item Properties dialog box opens.

3 Add the desired options at the end of the Command Line field.

126 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Accessing Run-Time Manager

A CCESS ING R UN -T IME M AN AGE R

How you open the Run-Time Manager depends on your operating system platform. Once opened, Run-Time Manager acts the same for all platforms. The method for starting Run-Time Manager for each platform follows.

On Windows NT and Windows 95 Platforms

1 Click on the FactoryLink icon from the Program Manager window to display the

FactoryLink IV program group.

5
Double-click here to start the Run-Time Manager

Using Run-Time Manager

If you have more than one FactoryLink application, be sure to open the program group for the desired application.
2 Click on the Start FactoryLink icon. This starts both the shared and user domains.

On OS/2 Platform
If you are running FactoryLink on an OS/2 Windows operating system, you can open the Run-Time Manager from either the Desktop Manager or the command line. Both methods start the shared and user domains. The two methods are described below.

FactoryLink ECS / Fundamentals / 127

USING RUN-TIME MANAGER

Accessing Run-Time Manager

From Desktop Manager

1 Choose FactoryLink OS/2 from the Desktop Manager menu to display the

applications available with the FactoryLink group.

Double-click here to start the Run-Time Manager

2 Double-click the left button to open Run-Time Manager.

From a Command Line Enter the following command at the system prompt to open Run-Time Manager from an OS/2 command line. flrun options where options is one or more of the options specified in the table on page 5-124.

On UNIX Platform
Perform the following procedure to open the Run-Time Manager if you are running FactoryLink on a UNIX platform.
1 Open two operating system windows, one to run FactoryLink in the shared

domain and another to run it in the user domain. You must open the shared domain before you open the user domain.
2 Ensure the FLAPP, FLINK, FLDOMAIN, FLNAME, AND FLUSER environment

variables are set for the shared domain. If not, set them. How you do this depends on whether you are using a C shell or a Korn or Bourne shell.

128 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Accessing Run-Time Manager

If you are using a C shell, enter the following commands at the system prompt of the shell where you are starting the shared domain. setenv setenv setenv setenv setenv FLINK flink_dir FLAPP flapp_dir FLDOMAIN domain FLNAME app_name FLUSER user_name

If you are using a Korn or Bourne shell, enter the following commands at the system prompt of the shell where you are starting the shared domain. FLINK=flink_dir FLAPP=flapp_dir export FLAPP FLDOMAIN=domain export FLDOMAIN FLNAME=app_name export FLNAME FLUSER=user_name export FLUSER where
flink_dir flapp_dir

5
Using Run-Time Manager

defines the full path to the directory containing the FactoryLink program files. defines the full path to the directory containing your application files. defines the domain you are starting. This should be shared for the window where you are starting the shared domain. defines the full path to the directory containing your application files. defines the log on name of the user starting the application.

domain
app_name user_name

3 Enter the following command at the system prompt.

flrun options where options is one or more of the options specified in the table on page 5-124. The system starts the Run-Time Manager in the shared domain, but the Run-Time Manager screen is not yet visible.

FactoryLink ECS / Fundamentals / 129

USING RUN-TIME MANAGER

Accessing Run-Time Manager

4 Ensure the FLAPP, FLINK, FLDOMAIN, FLNAME, AND FLUSER environment

variables are set for the user domain. If not, set them. How you do this depends on whether you are using a C shell or a Korn or Bourne shell. If you are using a C shell, enter the following commands at the system prompt of the shell where you are starting the user domain. setenv setenv setenv setenv setenv FLINK flink_dir FLAPP flapp_dir FLDOMAIN domain FLNAME app_name FLUSER user_name

If you are using a Korn or Bourne shell, enter the following commands at the system prompt of the shell where you are starting the user domain. FLINK=flink_dir FLAPP=flapp_dir export FLAPP FLDOMAIN=domain export FLDOMAIN FLNAME=app_name export FLNAME FLUSER=user_name export FLUSER where
flink_dir flapp_dir

defines the full path to the directory containing the FactoryLink program files. defines the full path to the directory containing your application files. defines the domain you are starting. This should be user for the window where you are starting the user domain. defines the full path to the directory containing your application files. defines the log on name of the user starting the application.

domain
app_name user_name

130 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Accessing Run-Time Manager

5 Enter the following command at the system prompt:

flrun options where options is one or more of the options specified in the table on page 5-124. The system starts the Run-Time Manager in the user domain and the Run-Time Manager screen opens. You can toggle between the Run-Time Manager for the shared domain and that for the user domain from the Run-Time Manager screen. Refer to the Run-Time Manager User-Interface Screen on page 132 for more details.

5
Using Run-Time Manager
FactoryLink ECS / Fundamentals / 131

USING RUN-TIME MANAGER

Run-Time Manager User-Interface Screen

R UN -T IME M ANA GER U SE R -IN TERFAC E S CR EEN

When you start the Run-Time Manager, the Run-Time Manager main screen is displayed. This document displays the Run-Time Manager screen as it is shipped with FactoryLink. You can customize it according to your needs using the Application Editor.
Last Message Area

Task Controls

Application Controls

Display Controls

This screen has four major components. Task controlsTurns tasks on or off. Refer to the Task Controls on page 133 for more details. Last message areaShows the last message sent by the task. Refer to the discussion on the task in the FactoryLink Configuration Guide for more details. Application controlsDisplays information about the current application and turns the application off. Refer to the Application Controls on page 134 for more details. Display controlsProvides access to other application screens. Refer to the Run-Time Manager User-Interface Screen on page 132 for more details.

132 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-Time Manager User-Interface Screen

Task Controls
The task control area lists the available tasks for your application. Up to 31 tasks are available in both the shared and user domain. If you are in the shared domain, this area is titled Shared Task. If you are in the user domain, this area is titled User Task.
Indicates current domain

5
Task control button

Using Run-Time Manager

The contents of the button to the left of the task name indicates the status of the task. This can be one of the following.
Empty Green check mark Yellow question mark Blue question mark Red X

Task is not running. If you choose this button when the task is not running, the task starts. Task is running. If you choose this button when the task is running, the task stops. Task is stopping. Task is starting. Task has reported an error.

FactoryLink ECS / Fundamentals / 133

USING RUN-TIME MANAGER

Run-Time Manager User-Interface Screen

Application Controls
The application control area provides information about the application running and provides the ability to stop the application or the user instance.

Indicates current user

Stop Application

Stops the application. Always choose this button if you are running in a single-user environment. If you running in a multi-user environment, this stops the application for all users. Stops the application for the current user. Always choose this button if you are running in a multi-user environment. If this is the shared domain, shareusr is displayed in this field. If this is the user domain, fluser is displayed in this field indicating the instance of the user domain. In a single-user environment, this will always be fluser1. Displays the current FactoryLink directory. Displays the current application directory.

Stop User Name

FactoryLink Directory Application Directory

134 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-Time Manager User-Interface Screen

Display Controls
The display control area provides the ability to open other user-interface screens for the application.

5
Using Run-Time Manager

Alarm Supervisor Next Page

Choose this button to open the alarm summary display. Choose this button to display a second page of tasks. This is necessary only if all the tasks in your application do not fit on a single display. Choose this button to toggle between the user domain and the shared domain. If you are in the user domain, this button is titled Shared Processes. If you choose this button, you open the shared domain. If you are in the shared domain, this button is titled User Processes. If you choose this button, you open the user domain.

Shared Processes

Return to Application

Choose this button to return to the application interface screen. You must animate this button to do this when you are configuring your application.

FactoryLink ECS / Fundamentals / 135

USING RUN-TIME MANAGER

Run-time Manager Messages

R UN - TIM E M ANA GER M ESSA GES

Error messages are displayed on the screen if errors occur while using Run-time Manager. This section lists these messages, describes their cause, and provides suggested actions. Messages are described in two ways: Text messageRefer to the Text Messages on page 136 for text messages. Error numbersRefer to the Messages with Error Numbers on page 142 for error number messages.

Text Messages
Bad command number Cause: Action: An invalid command was written to the global element COMMAND. Verify the external process' compatibility with FactoryLink.

Bad file size for filename Cause: Action: The FLAPP/CT/TYPE.CT file has been damaged. Delete the file and re-start the application to rebuild the file.

Bad index in file filename Cause: Action: Unable to read the index of the FLAPP/CT/TYPE.CT file. Delete the file and re-start the application to rebuild the file.

Can't convert subgroup table name Cause: Action: Tried to convert an older SPC application. See the conversions instructions in the Release Notes.

Can't create appl. filename error error number Cause: Action: Tried to start an application already started. No action required.

136 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

Can't open file filename Cause: Action: The disk may be full, or this may be a log file opened by another process. Delete unnecessary files. If this error occurs often, additional disk space may be required.

Can't read options file FL.OPT Cause: Action: FL.OPT has been damaged. Verify the contents of FL.OPT by running UKEY. Copy flnew.opt to fl.opt.

Can't start process process name Cause: The binary file may not exist, may not be executable, or the filename in the EXECUTABLE FILE field in the System Configuration Table may be incorrect. Under some system platforms this may indicate an insufficient number of processes. Verify the correct file name in the System Configuration Table or see the Fundamentals manual.

5
Using Run-Time Manager

Action:

Can't stop process process name Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Client processes failed to start Cause: Action: One or more processes could not be started. See the error messages for the particular process.

Client processes failed to stop Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Directory directory name does not exist Cause: Action: Can't the find FLAPP directory specified by the environment variable. Set FLAPP to a valid application directory.

FactoryLink ECS / Fundamentals / 137

USING RUN-TIME MANAGER

Run-time Manager Messages

Directory directory name is not a valid FactoryLink directory Cause: Action: FLAPP does not have a valid subdirectory structure. (1) Check the FLAPP directory. Add the missing subdirectories. (2) Set FLAPP to a valid application directory.

Domain domain name can only have one instance Cause: Action: A parent domain has been configured as having more than one instance. A parent domain may only have one instance. Open the Domain Element List and change the entry in the #INST field to 1.

Domain domain name isn't in the domain CT Cause: Action: The specified domain does not exists in the domain .CT. The domain name may have been entered incorrectly or may not exist in the Domain Element List. Verify the domain exists in the Domain Element List and has been entered correctly.

Environment Tag element name has an invalid type Cause: Action: The wrong data type was specified for the field. Enter the correct data type for this field.

FactoryLink initialization failed Cause: Action: FactoryLink system failed to initialize. Ensure the master key is present and properly connected. Run KEYINST and FLKEYVAL.

FactoryLink system monitoring failed Cause: Action: The system was unable to start the monitor task. The system may not contain sufficient memory. Stop unnecessary processes.

Grace period has expired. Software must be registered Cause: FactoryLink was installed without registering it within the 10 day grace period.

138 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

Action:

Run FLKEYVAL and follow the instructions for registration.

Kernel initialization failed Cause: Action: FactoryLink was already initialized. FactoryLink was already running when start-up was attempted. No action required.

Monitor tag array definition failed Cause: A System Configuration Table monitor element (Start Trigger, Task Status, or Task Message) may be undefined or defined incorrectly for one of the tasks being started. Open the System Configuration Table and define the elements correctly.

Action:

5
Number of defined proc process number more than max maximum number Cause: Action: Out of RAM Cause: Action: No more memory is available. Close any unnecessary windows or programs. Add more memory to the system if this error occurs often. More than 31 processes were started. Start fewer processes.

Using Run-Time Manager

Output tag array definition failed Cause: A System Configuration Table output element (Display Status, Display Name, or Display Description) may be undefined or defined incorrectly for one of the tasks being started. Open the System Configuration Table and define the elements correctly.

Action:

Process process name may not have started Cause: Action: The process failed to be come active. It may not have been able to register with FactoryLink. Verify the filename in the EXECUTABLE FILE field in the System Configuration Table. Verify the process' compatibility with FactoryLink.

FactoryLink ECS / Fundamentals / 139

USING RUN-TIME MANAGER

Run-time Manager Messages

Process process name may not have stopped Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Read failed on file filename Cause: Action: A read operation on the named file failed. Verify configuration table entries, communication parameters, hardware identification information, and electrical connections.

Read header failed on file filename Cause: Action: The .CT file may be damaged. Delete the .CT file in the FLINK/ct directory and re-start the application to rebuild the file.

Real-time database isnt initialized Cause: Action: FactoryLink is starting or shutting down. Start FactoryLink again.

Real-time database for application doesnt exist Cause: Action: An attempt was made to start a USER domain when the SHARED domain did not exist. Start the SHARED domain.

Run-time Manager: errno = error number Cause: Action: The Run-time Manager was awakened when there was nothing for it to do. (Internal error.) No action required.

Run-time Manager CT processing failed Cause: One or more of the elements ARGUMENT, COMMAND, PASSWORD, SHUTDOWN, or STARTUP is not defined in the GLOBAL.CDB file. The file has been damaged or installed incorrectly. Contact Customer Support.

Action:

140 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

Run-time Manager failed to start Cause: The Run-time Manager must be the first task started. The Start Order number for RUNMGR must be 0; no other task may have a zero for a Start Order number. Check the System Configuration Table to verify the Start Order.

Action:

Run-time Manager failed to stop Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Run-time Manager is already running Cause: Action: A copy of the Run-time Manager is already running for the DOMAIN and USER name specified. Change the DOMAIN or USER name.

5
Using Run-Time Manager

Software has not been enabled Cause: Action: An error has occurred with the f1.key file in the opt directory. 1. Run KEYINST and if an invalid or archaic agreement is found, re-enter the configuration information. 2. Run FLKEYVAL and follow the instructions for registration.

Write error on log file filename Cause: Action: The disk may be full. Delete unnecessary files.

FactoryLink ECS / Fundamentals / 141

USING RUN-TIME MANAGER

Run-time Manager Messages

Messages with Error Numbers

Two Run-time Manager error messages display error numbers within the message: Can't create appl. filename error error number Run-time Manager: errno = error number The error numbers in these messages are generated by the FactoryLink real-time database. Each error number has a corresponding error keyword. Even though this keyword is not displayed in the error message, knowing the error keyword helps Customer Support engineers identify the cause of the problem. 1 FLE_INTERNAL Cause: Action: Internal Error. See Correcting Internal Errors at the end of this section.

2 FLE_OUT_OF_MEMORY Cause: Action: There is not enough RAM available. Add RAM to the system.

4 FLE_NO_FLINK_INIT Cause: Action: The real-time database has not been created or cannot finish initializing. Shut down FactoryLink and re-start it.

5 FLE_NO_PROC_INIT Cause: One of the following conditions caused this error: The task name of the specified task has not been entered in the System Configuration Table. Perform the corresponding action: Enter the task name in the Task Name field of the System Configuration Table. The task is already running. Nothingthe task will continue to run. The indicated task is not enabled on the FactoryLink key.

Action:

Cause: Action: Cause:

142 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

Action:

Contact your FactoryLink sales representative to obtain the proper key and/or option.

7 FLE_BAD_ARGUMENT Cause: Action: Internal errora task tried to pass an invalid argument to the real-time database. See Correcting Internal Errors at the end of this section.

9 FLE_BAD_TAG Cause: Action: The .CTs need to be rebuilt. Rebuild the .CTs by running CTGEN.

10 FLE_NULL_POINTER Cause: Action: Internal errora task gave out a null pointer. See Correcting Internal Errors at the end of this section.

5
Using Run-Time Manager

12 FLE_PROC_TABLE_FULL Cause: Action: 31 tasks are running in the chosen domain. Only 31 tasks can run in each domain at once. No action requireddo not try to run more than 31 tasks per domain at a time.

13 FLE_BAD_PROC_NAME Cause: Action: One of the following conditions caused this error: The .CTs need to be rebuilt. Perform the corresponding action: Run CTGEN to rebuild the .CTs. If this does not solve the problem, proceed to step 2. A task name used in the application has not been entered in the Task Name field of the System Configuration Table. Open the System Configuration Table from the Configuration Manager Main Menu and ensure the names of all tasks in the application are present in the Task Name field. The requested task is not running.

Cause: Action:

Cause:

FactoryLink ECS / Fundamentals / 143

USING RUN-TIME MANAGER

Run-time Manager Messages

Action:

Ensure you started all tasks needed to run the application.

14 FLE_BAD_USER_NAME Cause: Action: The FLUSER environment variable is not set. Set the environment variables; re-start FactoryLink.

22 FLE_ALREADY_ACTIVE Cause: Action: The task is already running. None-do not start a task already running.

23 FLE_NOT_LOCKED Cause: Action: Internal errora task tried to unlock the real-time database without having locked it first. See Correcting Internal Errors at the end of this section.

24 FLE_LOCK_FAILED Cause: Internal errora task used an invalid Task ID to lock the real-time database. Therefore, the task did not successfully lock the real-time database or perform its function. See Correcting Internal Errors at the end of this section.

Action:

25 FLE_LOCK_EXPIRED Cause: Action: A task has kept the real-time database locked longer than the kernel allows. Nonecurrently, the kernel allows tasks to lock the real-time database for as long as necessary. Therefore, the lock time will not expire.

26 FLE_WAIT_FAILED Cause: Action: Internal errorwhile trying to do a change-wait on an element, a task sent an invalid Task ID to the real-time database. See Correcting Internal Errors at the end of this section.

144 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

28 FLE_QSIZE_TOOBIG Cause: Action: Internal errora task attempted to attach a queue to an element, but there was not enough memory. See Correcting Internal Errors at the end of this section.

29 FLE_QSIZE_CHANGED Cause: Action: Internal errora task attempted to attach a queue to an element, but a queue of a different size was already attached. See Correcting Internal Errors at the end of this section.

30 FLE_NO_TAG_LIST Cause: This error only occurs on custom tasks written using the FactoryLink PAK. If the custom task was set up to access elements by name instead of by ID number, this error can occur if the element list has not been defined. Use the API function FL_SET_TAG_LIST to define the element list. Then, re-start FactoryLink. Refer to the Programmers Access Kit (PAK) manual for information about L_SET_TAG_LIST.

5
Using Run-Time Manager

Action:

31 FLE_TAG_LIST_CHANGED Cause: This message can be displayed only if an application has been set up so one task monitors another tasks element list. If one task modifies the other tasks element list, the task that modified the list will return this message, thus informing the task that its list has been modified. No action required.

Action:

32 FLE_WAKEUP_FAILED Cause: Internal errorThe real-time database tried unsuccessfully to wake a task waiting for the value of a particular element to change. See Correcting Internal Errors at the end of this section.

Action:

FactoryLink ECS / Fundamentals / 145

USING RUN-TIME MANAGER

Run-time Manager Messages

33 FLE_NO_SIGNALS Cause: If a task calls the FL_RECV_SIG function to find out if any signals have been sent to it, the FL_RECV_SIG function returns a message. If no signals have been sent to the task, FL_RECV_SIG returns this message. No action required.

Action:

34 FLE_SIGNALLED Cause: The real-time database sends this message to inform a sleeping task that the task has received a signal, not a change in value of the element for which it is waiting. No action required.

Action:

35 FLE_NOT_MAILBOX Cause: Action: One of the following conditions caused this error: The .CTs need to be rebuilt. Perform the corresponding action: Run CTGEN to rebuild the .CTs. If this does not solve the problem, proceed to step 2. While configuring a task, you entered an element of a data type other than MAILBOX in a field that requires a MAILBOX element. Open the configuration panels from the Main Menu of the task containing the error . Ensure the data types of the elements in all fields requiring MAILBOX elements, are defined as MAILBOX.

Cause:

Action:

36 FLE_NO_MESSAGES Cause: If through the PAK QUERY_MBX function, a task requests to view a message whose queue number falls outside the range of available messages, the QUERY_MBX function returns this message. For example, if a task requests to view the third message waiting in the queue, and only two messages are in the queue, then the task is requesting to view a message outside the range of available messages. No action required.

Action:

146 / FactoryLink ECS / Fundamentals

USING RUN-TIME MANAGER

Run-time Manager Messages

37 FLE_ACCESS_DENIED Cause: If a task tries to read a mailbox element that it is not allowed to read, the real-time database returns this error. If the task is a custom task developed using PAK, the programmer may not have set up ownership of the mailbox element by the task requesting to read from it. Use the PAK function FL_SET_OWNER_MBX to establish the task as owner of the mailbox element. Internal error. See Correcting Internal Errors, at the end of this section.

Action:

Cause: Action:

41 FLE_APP_EXISTS Cause: Action: A real-time database with the same FLNAME but a different number of users or elements already exists. Either shut down the running real-time database or set FLNAME with a different name.

5
Using Run-Time Manager

42 FLE_NO_FLINK_RTDB Cause: Action: A user domain was started for a real-time database for which the shared domain has not been started. Start the shared domain first.

FactoryLink ECS / Fundamentals / 147

USING RUN-TIME MANAGER

Run-time Manager Messages

Correcting Internal Errors

Internal errors are generally caused by one of the tasks in the system in use and not by your application. For this reason, we recommend you use the following guidelines to correct an internal error: 1. Try to determine which task is sending the error by shutting down FactoryLink, restarting it, and starting each task, one at a time. 2. Write down any error messages displayed on the Run-time Manager screen and their corresponding tasks. (The task having the problem may generate a seemingly unrelated error message.) 3. Contact the supplier of the task in error if the task in error is an external task. 4. Contact Customer Support if the task in error is a FactoryLink task. 5. Contact Customer Support if the task cannot be identified.

148 / FactoryLink ECS / Fundamentals

Chapter 6

Using Run-Time Monitor

Run-Time Monitor (RTMON) allows you to monitor how the real-time application is functioning in order to test your application before using it or to debug problems that arise during processing after it is developed. Using RTMON, you can: Simulate input to real-time database elements. Monitor how the values of data elements in the real-time database change. Start, stop, or monitor FactoryLink tasks. In general, any development, testing, or debugging operation that can be aided by directly accessing the FactoryLink real-time database, either by reading from or writing to elements, is made easier with RTMON. While developing an application, periodically run and monitor it using RTMON to ensure the application is functioning as you intended.

6
Using Run-Time Monitor
FactoryLink ECS / Fundamentals / 149

USING RUN-TIME MONITOR

Accessing the Run-Time Monitor

A CCE SSING

TH E

R U N -T IM E M O NITO R

Perform the following steps to open RTMON.

1 Start up the FactoryLink application. How you do this depends on your operating

system platform. Refer to Chapter 5, Using Run-Time Manager, for more details on this operation. The following screen is displayed when you start the application.

2 Choose User Processes from the Display Control area if you want to monitor the

user domain. The best domain in which to run RTMON depends on the type of information you are monitoring. Use the following guidelines to decide on the best domain. If you are monitoring elements, run RTMON in the user domain. This enables you to monitor elements from both the shared and user domains. If you are monitoring FactoryLink tasks, run RTMON in the domain in which the desired task(s) runs. For example, to monitor the status of the Alarm Supervisor task, run RTMON in the shared domain.

150 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Accessing the Run-Time Monitor

3 You may have to choose Next Page from the Display Control area to see the

RTMON task in the Task Control list.

4 Choose the button next to RTMON in the Task Control list. The Run-Time

Monitor panel opens.

This panel consists of two parts: Menu BarProvides access to a group of tools that permit you to use RTMON through the Options menu. The following pulldown menu is displayed when you choose Options from the menu bar..

Each item on this pulldown menu is discussed in the following pages.

Poll Rate Bar The Poll Rate bar is a scroll bar that allows you to indicate the

rate at which RTMON polls the processes it is monitoring. The Poll Rate bar can specify from .10 (one tenth) of a second to 10 seconds. Move the slider bar located on the scroll bar to change the poll rate. The remainder of this chapter describes how to use the Run-Time Monitor.

6
Using Run-Time Monitor

FactoryLink ECS / Fundamentals / 151

USING RUN-TIME MONITOR

Viewing the Current Value of Elements

VIE W ING

THE

C URR ENT VA LUE

OF

ELEM ENTS

You can view the current value of elements using the watch list display. This display is real-time and updates at the selected poll rate.
1 Choose Watch from the Options pulldown menu to open the watch list . The

Monitor Watch List panel is displayed.

You can display multiple watch lists at the same time. Each time you choose
Watch from the Options pulldown menu, a new watch list panel is created. The

watch list panel has one item on its menu bar.

2 Choose Options from the watch list menu bar to display the following pulldown

menu.

The actions you can perform on the watch list are described in the following pages. The order they are discussed is the order you would use them to build and save a watch list rather than the order they are presented in the pulldown menu.

152 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Viewing the Current Value of Elements

Adding Elements to a Watch List

1 Choose Add Watch from the watch list Options pulldown menu. The following dialog

box is displayed.

2 Enter the name of the tag you want to monitor and choose the Enter button. Its

name and current value are added to the watch list display.
Tag name

Tag value

3 Repeat step 2 for each element you want to monitor. If you list an element name

more than once or on more than one watch list panel, only the first entry is updated.
4 Choose Cancel from the dialog box to close it when you are finished adding

6
Using Run-Time Monitor

elements to the watch list.

FactoryLink ECS / Fundamentals / 153

USING RUN-TIME MONITOR

Viewing the Current Value of Elements

Deleting Elements from a Watch List

1 Choose Delete Watch from the watch list Options pulldown menu. The following

dialog box is displayed.

Enter tag name

2 Enter the name of the tag you want to delete and choose the Enter button. Its

name and current value are added to the watch list display.
3 Choose Cancel from the dialog box to close it when you are finished deleting

elements from the watch list.

Finding Elements in a Watch List

1 Choose Find Watch from the watch list Options pulldown menu. The following

dialog box is displayed.

Enter tag name

2 Enter the name of the tag you want to find and choose the Enter button. The first

occurrence of the element is found in the watch list.

3 Choose Cancel from the dialog box to close it after you have finished finding

elements in the watch list.

154 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Viewing the Current Value of Elements

Storing Watch List

The elements added to a watch list remain in the list for as long as the Run-Time Manager is active. Once you close the Run-Time Manager, the watch list is discarded. To prevent the necessity of rebuilding a watch list each time you want to monitor a set of data elements, store the contents of the watch list to a file before exiting the Run-Time Manager. Perform the following steps to store the contents of a watch list.
1 Add the elements you want included in the watch list to the watch list display.

Refer to Adding Elements to a Watch List on page 153, for details on how to do this.
2 Choose one of the following options from the watch list Options pulldown menu. Save TAGS

Saves the tag names of elements defined in the watch list. Use this option if you want to see the values of these tags as they currently exist in the real-time database when you restore this list. Saves the tag names of elements defined in the watch list and their current values. Use this option if, when you restore this list, you want to restore the values of these tags as they exist when the save is made.

Save Data

If you choose Save TAGS, the following dialog box is displayed requesting the name of the file to receive the watch list elements. If you choose Save Data, a similar dialog box is displayed requesting the data filename.

Enter tag name

6
Using Run-Time Monitor
3 Enter the name of the file to receive the tags. 4 Choose Cancel from the dialog box to close it when you have completed saving all

watch lists.

FactoryLink ECS / Fundamentals / 155

USING RUN-TIME MONITOR

Viewing the Current Value of Elements

Retrieving Watch List

Perform the following steps to retrieve the elements in a watch list saved with the Save TAGS or Save Data option.
1 Choose one of the following options from the watch list Options pulldown menu. Load TAGS

Retrieves the tag names of elements saved in a file using the Save TAGS option and writes them to the watch list. The values of these elements display as they currently exist in the real-time database.

Load Data

Retrieves the tag names of elements saved in a file using the Save Data option and writes them to the watch list. The values of these elements display as they existed in the real-time database when the save was made.

If you choose Load TAGS, the following dialog box is displayed requesting the name of the file containing the watch list elements. If you choose Load Data, a similar dialog box is displayed requesting the data filename.

Enter tag name

2 Enter the name of the file containing the tags you want to retrieve. 3 Choose Cancel from the dialog box to close it when you have completed loading all

watch lists.

156 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Reading and Writing a Real-Time Database Element

R EADIN G

AND

W RITIN G

R EAL -T IM E D A TABA SE ELEM ENT

1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Tag Input from the Options pulldown menu. The Tag Input dialog box is

displayed.

You can display multiple tag input panels. Each time you choose Tag Input, a new panel is displayed.
3 Provide the following information. Tag Name

6
Using Run-Time Monitor

Enter the logical name assigned to the real-time database element you want to read or write. When you enter a name, the location of the element in the real-time database referenced by the tag is displayed in the Tag Number field. Enter the value you want written to the element if you want to write a value to the element.

Value

4 Choose the command button that represents the operation you want to perform.

This can be one of the following.

FactoryLink ECS / Fundamentals / 157

USING RUN-TIME MONITOR

Reading and Writing a Real-Time Database Element

Read

Reads the element. The current value of the element is displayed to the right of the Value field.

Write Force

Writes the value in the Value field to the element. Force writes the value in the Value field to the element.

158 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Monitoring FactoryLink Processes

MO NITO RING F ACTO RY L IN K P RO CESS ES

You can use RTMON to monitor the activity of all FactoryLink tasks in an application. This is useful for detecting and diagnosing problems during application development. For example, if you detect most FactoryLink tasks have little or no status changes except Math and Logic, this could indicate one of the following: At least one Math and Logic procedure is using up all CPU resources. Math and Logic is caught in a loop. This can happen if a procedure tests for condition that never occurs. Perform the following steps to monitor FactoryLink tasks.
1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Process from the Options pulldown menu. The Monitor Process List

6
Using Run-Time Monitor

window is displayed.

FactoryLink ECS / Fundamentals / 159

USING RUN-TIME MONITOR

Monitoring FactoryLink Processes

The following information is provided about each FactoryLink task.

Task # FL Name Active TTF Calls

Number and descriptive name of a FactoryLink task. Short name used to reference the FactoryLink task. Indicator of whether or not the specified task is active. Number of times the task has checked its terminate flag since startup. The terminate flag is a bit in the kernel. The task reads the value of its terminate flag periodically to determine whether it should shut down or keep running. If the terminate flag is set to 1 (ON), the FactoryLink task sets its start trigger to 0 (OFF). When the start trigger is set to 0 (OFF), the Run-Time Manager shuts the task down. Each task has its own terminate flag and start trigger.

Read Calls Write Calls Lock Calls

Number of read operations the task has performed since startup. Number of write operations the task has performed since startup. Number of times the task has locked the real-time database since startup. When a task reads from or writes to the real-time database, it locks all other tasks out of the database. When the task has completed its operations, it unlocks the real-time database so another task can open it. Number of times the task has slept while waiting for elements to change since startup. Process ID number (usually decimal) assigned to the task by the operating system. Indicator of whether or not the task's terminate flag is set. Number of times the task has waited for access to the real-time database since startup. Number of elements read by the task since startup. Number of elements the task has written since startup. Number of milliseconds the task has had the real-time database locked. Total number of milliseconds the task has been asleep since task startup. This value is updated after each sleep cycle.

Sleep Calls PID Terminate Waits Elem. Read Elem. Written Lock Time Sleep Time

160 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Monitoring FactoryLink Processes

This panel has one item on its menu bar. Choose Options from the process list menu bar. The following pulldown menu is displayed.

When you choose one of these options, it acts on the task currently displayed in the process list window. These are:
Start Stop Set Terminate Kill

Starts the task. Stops the task immediately. Stops the task the next time it checks its terminate flag. This is the recommended way to stop the task. Force stops a task. Use this option only if both the Set Terminate and Stop options could not stop the task. This usually indicates a task is caught in an infinite loop and is not reading its terminate flag. If you use this option to stop a task and if the task had the real-time database locked at the time you stopped it, no other tasks will be able to access the real-time database until the lock is turned off. For Windows NT and Windows 95, re-boot the computer. For OS/2, run the FLSHM utility with the -d parameter to correct this condition. Refer to Chapter 7, FactoryLink Utilities, for details on using FLSHM. For UNIX, FactoryLink monitors for this condition and attempts to unlock the real-time database.

6
Using Run-Time Monitor

FactoryLink ECS / Fundamentals / 161

USING RUN-TIME MONITOR

Monitoring FactoryLink Processes

Find

Finds a task in the process list. When you choose Find, you are prompted for the task you want to find.

Enter the name of the executable. This locates the first occurrence of the specified FactoryLink task in the current process list window.
Exit

Exits the process list window and returns to the FactoryLink Run-Time Monitor panel.

162 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

U SING R UN -T IM E M O NITOR C O MM AN DS
RTMON provides a window to the operating system in order to execute commands that aid in developing, testing, or debugging the application. Perform the following steps to open this window.
1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Command Input from the Options pulldown menu. The Monitor Commands

panel is displayed.

6
Using Run-Time Monitor

The appearance of this window varies depending on the operating system. When entering commands in the Commands window, use the following guidelines. To recall previous commands, use the and keys. To scroll through the output, use the scroll bar.

FactoryLink ECS / Fundamentals / 163

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

To execute a command in real-time mode, press Enter. To exit the Commands window, choose Exit from the Monitor Commands Options

pulldown menu. This returns you to the Run-Time Monitor panel. The information in the following pages describes how to use the commands available with the Monitor Commands window.

Terminating a Task
Use the t command to terminate a FactoryLink task. The syntax is t name where name is the name of the task to terminate as specified in the Task Name field of the System Configuration Information panel.

Exiting Commands Window

Use the q command to quit the session and exit the commands window. The syntax is q

Accessing Help
Use the ? or h command to open help. The syntax is ? [cmd ] or h [cmd] where cmd is the command you want help for. For example, ?i opens help for the i command. If you do not specify cmd, help is provided for all commands.

164 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

Reading an Element
You can use several commands to read an element. These include: Reading a Single Element Use the r command to display the value for a single element. The syntax is r tag where tag identifies the element you want to read. This can either be the element name or element number. The element number is displayed in output when you read the element. Output is displayed on the screen unless you redirect it to a file using the o command. For example, enter the following command to read the contents of analog element TEST. r TEST This generates the following output. a (1)103 = 4108 where
a (1) 103 4108 x100c

x100C

is the data type of tag. In this case, the data type is analog. is the segment where tag is located in memory. is the number assigned to tag. This number can be used in command syntax in place of the tag name. is the decimal representation of the tags value. is the hexadecimal representation of the tags value.

6
Using Run-Time Monitor

Reading One or More Elements Use the d command to display the values for multiple elements of an array tag with a single command. The syntax is d tag count where
tag

identifies the element to start with. This can either be the element name or element number. The element number is displayed in output when you read the element.

FactoryLink ECS / Fundamentals / 165

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

count

identifies the number of elements in the array to display starting with the element identified by tag.

For example, to display the values of three elements in an array starting with tag, enter the following command. d TEMP [4] 3 This generates the following output. (01)0078: where (01) 0078 15, 5, 2 is the segment where tag is located. is the number assigned tag. This number can be used in command syntax in place of the tag name. are the values of the three elements. 15 5 2

Press any key to stop the display from scrolling. Press any key except s to restart the scroll. Press any key, then press S to stop the display. Redirecting Read Output Read output is sent to the terminal screen unless redirected to a file using the o command. The syntax is o [filename] where filename is the name of the file to receive the output. If you do not supply filename, output is sent to the terminal screen.

Writing to an Element
A number of commands write to an element. If the tag type is message, all text between the last character of the element name and the end of the line or semicolon (;) is written, including any leading or trailing spaces. Newlines and semicolons are not written to message elements. Writing a Value to a Single Element Use the w command to write a value to a single element. The syntax is

166 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

w tag value where

tag

identifies the element to receive value. This can either be the element name or element number. The element number is displayed in output when you read the element. identifies the value to write to tag. You can enter numerical values as hexadecimal numbers by preceding the value with 0x.

value

For example, enter the following command to write a value of 3017 to TEST . w TEST 3017 Force-Writing a Value to a Single Element Use the W command to force write a value to a single element. A force write sets the Change-status flag to 1 (on). The syntax is W tag value where
tag

identifies the element to receive value. This can either be the element name or element number. The element number is displayed in output when you read the element. identifies the value to write to tag. You can enter numerical values as hexadecimal numbers by preceding the value with 0x.

value

Writing a Value to One or More Elements Use the s command to write the same value to multiple elements in an array with a single command. The syntax is s tag count value

6
Using Run-Time Monitor

where
tag

identifies the element to start with. This can either be the element name or element number. The element number is displayed in output when you read the element. identifies the number of elements in the array to display starting with the element identified by tag. identifies the value to write to each tag. You can enter numerical values as hexadecimal numbers by preceding the value with 0x.

count
value

FactoryLink ECS / Fundamentals / 167

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

For example, to set the values of three elements to 100, beginning with TEMPSET, enter the following command. s TEMPSET [0] 3 100 Force Writing a Value to One or More Elements Use the S command to force-write the same value to multiple elements of an array tag with a single command. A force write sets the Change-status flag to 1 (on). The syntax is S tag count value where
tag

identifies the element to start with. This can either be the element name or element number. The element number is displayed in output when you read the element. identifies the number of elements in the array to display starting with the element identified by tag. identifies the value to write to each tag. You can enter numerical values as hexadecimal numbers by preceding the value with 0x.

count value

For example, enter the following command to set the values of three elements beginning with TEMPSET to 100. S TEMPSET [0] 3 100

Working with Batch Files

This section discusses the commands used for creating and executing batch files. You can nest the execution of batch files which means you can have one batch file executed by another batch file. You can nest files four deep. End a line in a batch file with a newline or semicolon (;). Creating a Batch File You can create a batch file by save keyboard input to a file. You can place a series of commands as well as comments in a batch file. Use the f command to create a batch file. The syntax is f [filename]

168 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

where filename is the name of the file to receive the input. If you use the f command without the file name, input is not saved to a file and commands are executed as they are entered. Adding Remarks to a Batch File Use the # command to add a remark to a batch file. The syntax is # [remark] where remark is the text you do not want interpreted as a command. Terminate the remark with either a newline or a semicolon. You should only use remarks in batch files. Echoing a Comment in Output Use the c command to echo comments in output. The syntax is c [comment] where comment is the text you want to be displayed in the output. If you want the comment sent to a file, precede this command with the o command. Otherwise, the output is sent to the terminal screen. Ending Current File Place the e command at the end of the batch file to indicate the end of the file has been reached. The syntax is e If no more files are specified for execution or if the e command is executed from the keyboard, the Commands window exits. Executing a Batch File Once Use the i command to execute a batch file if you want to execute the batch file only once. Use the l command if you want to execute the same batch file multiple times. The syntax is i filename where filename is the name of the batch file to execute. For example, enter the following command to take input from the file TESTOUT .

6
Using Run-Time Monitor

FactoryLink ECS / Fundamentals / 169

USING RUN-TIME MONITOR

Using Run-Time Monitor Commands

i TESTOUT Executing a Batch File Multiple Times Use the l command to execute the same batch file multiple times. The syntax is l count filename where
count filename

is the number of times to execute the file. is the name of the file to execute.

For example, enter the following command to read the commands from the file TESTOUT five times. l 5 testout

170 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Monitoring the Status of the Real-Time Database

MO NITO RING

TH E

S TATU S

O F TH E

R EA L -T IM E D A TABAS E

Perform the following steps to monitor the status of the real-time database.
1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Global Info from the Options pulldown menu. The Global Values window is

displayed.

6
Using Run-Time Monitor
FactoryLink ECS / Fundamentals / 171

USING RUN-TIME MONITOR

Monitoring the Status of the Real-Time Database

The following information is displayed in the window.

Segments

Number of segments in use in the real-time database. A segment is a finite block of space in the real-time database that contains elements of one data type. Elements for each data type are stored in separate segments. When a segment is full, the next time you define an element of that data type, the real-time database creates a new segment to contain the element.

Digitals Floats Message Lock Id.

Total number of digital elements defined. Total number of floating-point elements defined. Total number of message elements defined. Indicator of whether or not the real-time database is locked and, if so, which task has locked it. When a task wakes up to read from or write to the real-time database, it locks all other tasks out of the database. When the task has completed its operations, it unlocks the real-time database so another task can access it. Each task has its own lock ID number. If the real-time database is locked, this field displays the lock ID number of the task that locked it. If the real-time database is not locked, this field displays either -1 or 65,535 depending on the system in use.

Memory

Amount of RAM used by the real-time database. The first number indicates the amount of RAM currently in use. The number in parentheses indicates the amount of RAM allocated to the real-time database. This includes available message space. Total number of analog elements defined. Total number of longana elements defined. Total number of mailbox elements defined. Number identifying the next task that locks the real-time database. FactoryLink keeps a list of tasks waiting on the real-time database. Each task waiting for real-time database access is added to this list. The Link ID field displays only the task in that list with the highest priority.

Analogs Longs Mailboxes Link Id.

172 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Monitoring the Status of the Real-Time Database

The following fields contain only colors to indicate their status. Color indicators are: green = on; red = off.

Each column of colors represents a FactoryLink task. The first column on the left represents the first task that is displayed on the Run-Time Manager screen; the second column represents the second task; and so on. You can monitor the colors to see if all tasks seem to be active and changing states at regular intervals.
Active Sleep

Indicates whether or not the task is active. Green indicates task is active. Red indicates task is not active. Indicates whether or not the task is waiting for the kernel to wake it up to inform of an element's change in status. Green indicates waiting. Red indicates not waiting. Indicates whether or not a task is waiting to lock the real-time database. When a task is reading from or writing to the real-time database, it locks all other tasks out of the database. Green indicates it is waiting. Red indicates it is not waiting. Indicates whether or not a task is waiting for access to the real-time database. Green indicates it is waiting. Red indicates it is not waiting. Indicates whether or not a task is waiting to perform a read operation. Green indicates it is waiting. Red indicates it is not waiting. Indicates whether or not a task is waiting to perform a write operation. Green indicates it is waiting. Red indicates it is not waiting.

Wait Lock

Wait Acc.

6
Using Run-Time Monitor

Wait Read

Wait Write

FactoryLink ECS / Fundamentals / 173

USING RUN-TIME MONITOR

Terminating All FactoryLink Tasks

T ERM INA TING A LL F ACTO RY L IN K T ASK S

Perform the following steps to terminate all FactoryLink tasks in the current domain. Terminate all user domain tasks before terminating shared domain tasks.
1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Shutdown All from the Options pulldown menu.

174 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Exiting RTMON

EXITIN G RTMON
1 Choose Options from the Run-Time Monitor panel.

The following pulldown menu is displayed.

2 Choose Exit from the Options pulldown menu.

6
Using Run-Time Monitor
FactoryLink ECS / Fundamentals / 175

USING RUN-TIME MONITOR

Run-time Manager Messages

R UN - TIM E M ANA GER M ESSA GES

If errors occur while using Run-time Manager, error messages are displayed on screen. This section lists these messages, describes their cause, and provides suggested actions. Messages are described in two ways: Text messageRefer to Text Messages on page 176 for text messages. Error numbersRefer to Messages with Error Numbers on page 182 for error number messages.

Text Messages
Bad command number Cause: Action: An invalid command was written to the global element COMMAND. Verify the external process' compatibility with FactoryLink.

Bad file size for filename Cause: Action: The FLAPP/CT/TYPE.CT file has been damaged. Delete the file and re-start the application to rebuild the file.

Bad index in file filename Cause: Action: Unable to read the index of the FLAPP/CT/TYPE.CT file. Delete the file and re-start the application to rebuild the file.

Can't convert subgroup table name Cause: Action: Tried to convert an older SPC application. See the conversions instructions in the Release Notes.

Can't create appl. filename error error number Cause: Action: Tried to start an application already started. No action required.

176 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

Can't open file filename Cause: Action: The disk may be full, or this may be a log file opened by another process. Delete unnecessary files. If this error occurs often, additional disk space may be required.

Can't read options file FL.OPT Cause: Action: FL.OPT has been damaged. Verify the contents of FL.OPT by running UKEY. Copy flnew.opt to fl.opt.

Can't start process process name Cause: The binary file may not exist, may not be executable, or the filename in the EXECUTABLE FILE field in the System Configuration Table may be incorrect. Under some system platforms this may indicate an insufficient number of processes. Verify the correct file name in the System Configuration Table or see the FactoryLink Fundamentals.

Action:

Can't stop process process name Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Client processes failed to start Cause: Action: One or more processes could not be started. See the error messages for the particular process.

6
Using Run-Time Monitor

Client processes failed to stop Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Directory directory name does not exist Cause: Action: Can't the find FLAPP directory specified by the environment variable. Set FLAPP to a valid application directory.

FactoryLink ECS / Fundamentals / 177

USING RUN-TIME MONITOR

Run-time Manager Messages

Directory directory name is not a valid FactoryLink directory Cause: Action: FLAPP does not have a valid subdirectory structure. (1) Check the FLAPP directory. Add the missing subdirectories. (2) Set FLAPP to a valid application directory.

Domain domain name can only have one instance Cause: Action: A parent domain has been configured as having more than one instance. A parent domain may only have one instance. Open the Domain Element List and change the entry in the #INST field to 1.

Domain domain name isn't in the domain CT Cause: Action: The specified domain does not exists in the domain .CT. The domain name may have been entered incorrectly or may not exist in the Domain Element List. Verify the domain exists in the Domain Element List and has been entered correctly.

Environment Tag element name has an invalid type Cause: Action: The wrong data type was specified for the field. Enter the correct data type for this field.

FactoryLink initialization failed Cause: Action: FactoryLink system failed to initialize. Ensure the master key is present and properly connected. Run KEYINST and FLKEYVAL.

FactoryLink system monitoring failed Cause: Action: The system was unable to start the monitor task. The system may not contain sufficient memory. Stop unnecessary processes.

178 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

Grace period has expired. Software must be registered Cause: Action: FactoryLink was installed without registering it within the 10 day grace period. Run FLKEYVAL and follow the instructions for registration.

Kernel initialization failed Cause: Action: FactoryLink was already initialized. FactoryLink was already running when start-up was attempted. No action required.

Monitor tag array definition failed Cause: A System Configuration Table monitor element (Start Trigger, Task Status, or Task Message) may be undefined or defined incorrectly for one of the tasks being started. Open the System Configuration Table and define the elements correctly.

Action:

Number of defined proc process number more than max maximum number Cause: Action: Out of RAM Cause: Action: No more memory is available. Close any unnecessary windows or programs. Add more memory to the system if this error occurs often. More than 31 processes were started. Start fewer processes.

6
Using Run-Time Monitor

Output tag array definition failed Cause: A System Configuration Table output element (Display Status, Display Name, or Display Description) may be undefined or defined incorrectly for one of the tasks being started. Open the System Configuration Table and define the elements correctly.

Action:

FactoryLink ECS / Fundamentals / 179

USING RUN-TIME MONITOR

Run-time Manager Messages

Process process name may not have started Cause: Action: The process failed to be come active. It may not have been able to register with FactoryLink. Verify the filename in the EXECUTABLE FILE field in the System Configuration Table. Verify the process' compatibility with FactoryLink.

Process process name may not have stopped Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Read failed on file filename Cause: Action: A read operation on the named file failed. Verify configuration table entries, communication parameters, hardware identification information, and electrical connections.

Read header failed on file filename Cause: Action: The .CT file may be damaged. Delete the .CT file in the FLINK/ct directory and re-start the application to rebuild the file.

Real-time database isnt initialized Cause: Action: FactoryLink is starting or shutting down. Start FactoryLink again.

Real-time database for application doesnt exist Cause: Action: An attempt was made to start a USER domain when the SHARED domain did not exist. Start the SHARED domain.

Run-time Manager: errno = error number Cause: Action: The Run-time Manager was awakened when there was nothing for it to do. (Internal error.) No action required.

180 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

Run-time Manager CT processing failed Cause: One or more of the elements ARGUMENT, COMMAND, PASSWORD, SHUTDOWN, or STARTUP is not defined in the GLOBAL.CDB file. The file has been damaged or installed incorrectly. Contact Customer Support.

Action:

Run-time Manager failed to start Cause: The Run-time Manager must be the first task started. The Start Order number for RUNMGR must be 0; no other task may have a zero for a Start Order number. Check the System Configuration Table to verify the Start Order.

Action:

Run-time Manager failed to stop Cause: Action: The process may already have stopped. Attempt to stop the process manually if it has not stopped.

Run-time Manager is already running Cause: Action: A copy of the Run-time Manager is already running for the DOMAIN and USER name specified. Change the DOMAIN or USER name.

Software has not been enabled Cause: Action: An error has occurred with the f1.key file in the opt directory. 1. Run KEYINST and if an invalid or archaic agreement is found, re-enter the configuration information. 2. Run FLKEYVAL and follow the instructions for registration.

6
Using Run-Time Monitor

Write error on log file filename Cause: Action: The disk may be full. Delete unnecessary files.

FactoryLink ECS / Fundamentals / 181

USING RUN-TIME MONITOR

Run-time Manager Messages

Messages with Error Numbers

Two Run-time Manager error messages display error numbers within the message: Can't create appl. filename error error number Run-time Manager: errno = error number The error numbers in these messages are generated by the FactoryLink real-time database. Each error number has a corresponding error keyword. Even though this keyword is not displayed in the error message, knowing the error keyword helps Customer Support engineers identify the cause of the problem. 1 FLE_INTERNAL Cause: Action: Internal Error. See Correcting Internal Errors at the end of this section.

2 FLE_OUT_OF_MEMORY Cause: Action: There is not enough RAM available. Add RAM to the system.

4 FLE_NO_FLINK_INIT Cause: Action: The real-time database has not been created or cannot finish initializing. Shut down FactoryLink and re-start it.

5 FLE_NO_PROC_INIT Cause: One of the following conditions caused this error: The task name of the specified task has not been entered in the System Configuration Table. Perform the corresponding action: Enter the task name in the Task Name field of the System Configuration Table. The task is already running. Nothingthe task will continue to run. The indicated task is not enabled on the FactoryLink key.

Action:

Cause: Action: Cause:

182 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

Action:

Contact your FactoryLink sales representative to obtain the proper key and/or option.

7 FLE_BAD_ARGUMENT Cause: Action: Internal errora task tried to pass an invalid argument to the real-time database. See Correcting Internal Errors at the end of this section.

9 FLE_BAD_TAG Cause: Action: The .CTs need to be rebuilt. Rebuild the .CTs by running CTGEN.

10 FLE_NULL_POINTER Cause: Action: Internal errora task gave out a null pointer. See Correcting Internal Errors at the end of this section.

12 FLE_PROC_TABLE_FULL Cause: Action: 31 tasks are running in the chosen domain. Only 31 tasks can run in each domain at once. No action requireddo not try to run more than 31 tasks per domain at a time.

13 FLE_BAD_PROC_NAME Cause: Action: One of the following conditions caused this error: The .CTs need to be rebuilt. Perform the corresponding action: Run CTGEN to rebuild the .CTs. If this does not solve the problem, proceed to step 2. A task name used in the application has not been entered in the Task Name field of the System Configuration Table. Open the System Configuration Table from the Configuration Manager Main Menu and ensure the names of all tasks in the application are present in the Task Name field. The requested task is not running.

6
Using Run-Time Monitor

Cause: Action:

Cause:

FactoryLink ECS / Fundamentals / 183

USING RUN-TIME MONITOR

Run-time Manager Messages

Action:

Ensure you started all tasks needed to run the application.

14 FLE_BAD_USER_NAME Cause: Action: The FLUSER environment variable is not set. Set the environment variables; re-start FactoryLink.

22 FLE_ALREADY_ACTIVE Cause: Action: The task is already running. None-do not start a task already running.

23 FLE_NOT_LOCKED Cause: Action: Internal errora task tried to unlock the real-time database without having locked it first. See Correcting Internal Errors at the end of this section.

24 FLE_LOCK_FAILED Cause: Internal errora task used an invalid Task ID to lock the real-time database. Therefore, the task did not successfully lock the real-time database or perform its function. See Correcting Internal Errors at the end of this section.

Action:

25 FLE_LOCK_EXPIRED Cause: Action: A task has kept the real-time database locked longer than the kernel allows. Nonecurrently, the kernel allows tasks to lock the real-time database for as long as necessary. Therefore, the lock time will not expire.

26 FLE_WAIT_FAILED Cause: Action: Internal errorwhile trying to do a change-wait on an element, a task sent an invalid Task ID to the real-time database. See Correcting Internal Errors at the end of this section.

184 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

28 FLE_QSIZE_TOOBIG Cause: Action: Internal errora task attempted to attach a queue to an element, but there was not enough memory. See Correcting Internal Errors at the end of this section.

29 FLE_QSIZE_CHANGED Cause: Action: Internal errora task attempted to attach a queue to an element, but a queue of a different size was already attached. See Correcting Internal Errors at the end of this section.

30 FLE_NO_TAG_LIST Cause: This error only occurs on custom tasks written using the FactoryLink PAK. If the custom task was set up to access elements by name instead of by ID number, this error can occur if the element list has not been defined. Use the API function FL_SET_TAG_LIST to define the element list. Then, re-start FactoryLink. Refer to the Programmers Access Kit (PAK) manual for information about L_SET_TAG_LIST.

Action:

31 FLE_TAG_LIST_CHANGED Cause: This message can be displayed only if an application has been set up so one task monitors another tasks element list. If one task modifies the other tasks element list, the task that modified the list will return this message, thus informing the task that its list has been modified. No action required.

Action:

6
Using Run-Time Monitor

32 FLE_WAKEUP_FAILED Cause: Internal errorThe real-time database tried unsuccessfully to wake a task waiting for the value of a particular element to change. See Correcting Internal Errors at the end of this section.

Action:

FactoryLink ECS / Fundamentals / 185

USING RUN-TIME MONITOR

Run-time Manager Messages

33 FLE_NO_SIGNALS Cause: If a task calls the FL_RECV_SIG function to find out if any signals have been sent to it, the FL_RECV_SIG function returns a message. If no signals have been sent to the task, FL_RECV_SIG returns this message. No action required.

Action:

34 FLE_SIGNALLED Cause: The real-time database sends this message to inform a sleeping task that the task has received a signal, not a change in value of the element for which it is waiting. No action required.

Action:

35 FLE_NOT_MAILBOX Cause: Action: One of the following conditions caused this error: The .CTs need to be rebuilt. Perform the corresponding action: Run CTGEN to rebuild the .CTs. If this does not solve the problem, proceed to step 2. While configuring a task, you entered an element of a data type other than MAILBOX in a field that requires a MAILBOX element. Open the configuration panels from the Main Menu of the task containing the error . Ensure the data types of the elements in all fields requiring MAILBOX elements, are defined as MAILBOX.

Cause:

Action:

36 FLE_NO_MESSAGES Cause: If through the PAK QUERY_MBX function, a task requests to view a message whose queue number falls outside the range of available messages, the QUERY_MBX function returns this message. For example, if a task requests to view the third message waiting in the queue, and only two messages are in the queue, then the task is requesting to view a message outside the range of available messages. No action required.

Action:

186 / FactoryLink ECS / Fundamentals

USING RUN-TIME MONITOR

Run-time Manager Messages

37 FLE_ACCESS_DENIED Cause: If a task tries to read a mailbox element that it is not allowed to read, the real-time database returns this error. If the task is a custom task developed using PAK, the programmer may not have set up ownership of the mailbox element by the task requesting to read from it. Use the PAK function FL_SET_OWNER_MBX to establish the task as owner of the mailbox element. Internal error. See Correcting Internal Errors, at the end of this section.

Action:

Cause: Action:

41 FLE_APP_EXISTS Cause: Action: A real-time database with the same FLNAME but a different number of users or elements already exists. Either shut down the running real-time database or set FLNAME with a different name.

42 FLE_NO_FLINK_RTDB Cause: Action: A user domain was started for a real-time database for which the shared domain has not been started. Start the shared domain first.

Correcting Internal Errors

Internal errors are generally caused by one of the tasks in the system in use and not by your application. For this reason, we recommend you use the following guidelines to correct an internal error: 1. Try to determine which task is sending the error by shutting down FactoryLink, restarting it, and starting each task, one at a time. 2. Write down any error messages displayed on the Run-time Manager screen and their corresponding tasks. (The task having the problem may generate a seemingly unrelated error message.) 3. Contact the supplier of the task in error if the task in error is an external task.

6
Using Run-Time Monitor

FactoryLink ECS / Fundamentals / 187

USING RUN-TIME MONITOR

Run-time Manager Messages

4. Contact Customer Support if the task in error is a FactoryLink task. 5. Contact Customer Support if the task cannot be identified.

188 / FactoryLink ECS / Fundamentals

Chapter 7

FactoryLink Utilities
7
FactoryLink Utilities

FactoryLink provides several utilities for general maintenance. These are listed below. FLNEW--Creates a newFactoryLink application with a baseline configuration. FLTEST-- Use for testing the installation FLDEMO--Use for application development ideas FLCONV--Converts an application from its current environment to a new environment when upgrading versions or migrating among operations. FLSAVE--Saves FactoryLink application to diskette or to another directory on the hard drive. CTGENRebuilds CT files. CDBLISTUse to view the binary CDB files in ASCII representation. CTLISTUse to view the binary CT files in ASCII representation. DBCHK--Fixes FactoryLink database index files EXPLODEDecompresses files from the FactoryLink installation disks. KEYINSTInstalls FactoryLink license with specified options. FLKEYVAL Enables FactoryLink software subsequent to installation. FLSHMA memory display utility that lists existing FactoryLink real-time database memory areas. You can use this information to clean up memory if FactoryLink aborts. UKEYDisplays license options. BH_SQLRefer to Data Logging Configuration Guide for details for using this utility to maintain FactoryLink dBASE IV database files. This chapter describes how to use these utilities. Command line formats and case may vary from one platform to the next. Open help using the question mark at the command line prompt to get details for your specific platform.

FactoryLink ECS / Fundamentals / 189

FACTORYLINK UTILITIES
FLNEW

FLNEW
After installing FactoryLink for the first time, you must create a new application using FLNEW to serve as the base upon which to build a FactoryLink application. This utility creates the necessary subdirectories. FLNEW overwrites any FactoryLink application already existing in the destination directory. To preserve an existing application, back it up by performing an FLSAVE before executing the FLNEW utility or ensure you are creating the new application in an empty or new directory. FLNEW supplies a set of libraries consisting of a collection of application components used to perform graphical, logical, process, and communication operations. Refer to the FactoryLink Release Notes for details on the most current libraries.

190 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
FLTEST and FLDEMO

FLTEST

AN D

FLDEMO

7
FactoryLink Utilities

After installing FactoryLink, run the test and demo applications, FLTEST and FLDEMO, to test the FactoryLink installation. FLTEST is a test application for testing the installation of FactoryLink. It also provides examples of common tasks. FLDEMO provides you with application development ideas. You can watch its execution by starting the FactoryLink Run-Time Manager only if restored FLAPP is set. This section describes how to restore the FLTEST or FLDEMO application on each operating system supported by FactoryLink. The process varies for each operating system.

FactoryLink ECS / Fundamentals / 191

FACTORYLINK UTILITIES
On Windows NT and Windows 95 Operating Systems

ON W IND OW S NT

A ND

W INDO W S 95 O PERA TING S YSTEM S

Perform the following steps to restore FLTEST or FLDEMO on a Windows NT or Windows 95 operating system.
1 Choose the Restore Application icon from the FactoryLink group window.

Double-click here to restore

2 The Application Restore dialog is displayed.

192 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
On Windows NT and Windows 95 Operating Systems

3 Provide the following information. Source

Enter the full path name of the applications source directory. If you are restoring FLTEST, enter c:\flink\mps\fltest.mps If you are restoring FLDEMO, enter c:\flink\mps\fldemo.mps

7
FactoryLink Utilities

Destination

Enter the full path name of the applications destination directory.

4 Choose Local Multiplatform Save File as the type of save file you want to restore. 5 Choose OK. FLREST begins restoring the files. 6 Create a program group for the FLTEST application using Additional Install

Functions from the Windows Program Manager. These applications are configured to use the dBASE IV Historian. If you do not use this Historian, configure the application to use the desired Historian before you run any activities accessing a relational database. This application uses most of the FactoryLink tasks you have purchased. Some screens may do nothing if you have not purchased or installed the task that provides the information to that screen.

FactoryLink ECS / Fundamentals / 193

FACTORYLINK UTILITIES
On OS/2 Operating Systems

ON OS/2 O P ERATIN G SY STEMS

This section describes how to restore the FLTEST or FLDEMO application on an OS/2 operating system from the Program Manager and a command line. From the Desktop Manager
1 Choose FactoryLink OS/2 program group from the Desktop Manager menu to

display the applications available with the FactoryLink group.

Double-click here to restore an application

2 Choose Restore Application. 3 Follow the onscreen instructions.

From a Command Line

1 Change to the MPS directory in the FLINK path at the OS/2 system prompt. For

example, CD \FLOS2\MPS
2 Enter the following command if you want to restore the FLTEST application.

FLREST FLTEST.MPS c:\FLTEST /loc Enter the following command if you want to restore the FLDEMO application. FLREST FLTEST.MPS c:\FLDEMO /loc
3 Provide the following information Source

Enter the full path name of the application source directory. If you are restoring FLTEST, enter c:\flink\mps\fltest.mps If you are restoring FLDEMO, enter c:\flink\mps\fldemo.mps

194 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
On OS/2 Operating Systems

Destination

Enter the full path name of the application destination directory.

4 Choose Local Multiplatform Save File as the type of save file you want to restore. 5 Choose OK. FLREST begins restoring the files. 6 Create a program group for the FLTEST application using Additional Install

7
FactoryLink Utilities

Functions from the Windows Program Manager. These application are configured to use the dBASE IV Historian. If you do not use this Historian, configure the application to use the desired Historian before you run any activities opening a relational database. This application uses most of the FactoryLink tasks you have purchased. Some screens may do nothing if you have not purchased or installed the task that provides the information to that screen.

FactoryLink ECS / Fundamentals / 195

FACTORYLINK UTILITIES
On UNIX Operating Systems

ON UNIX O PE RATIN G SYS TEMS

This section describes how to restore the FLDEMO or FLTEST and applications on a UNIX operating system.

Restoring FLDEMO
1 Create a target directory for the test application by entering the following

command at the system prompt. mkdir fldemo

2 Change to the newly created directory by entering the following command at the

system prompt. cd fldemo

3 Enter the following command to restore multiplatform save file for FLDEMO.

flrest FLINK/mps/fldemo.mps /fldemo /loc

Restoring FLTEST
Perform the following steps to restore FLTEST on a UNIX operating system.
1 Create a target directory for the test application by entering the following

command at the system prompt. mkdir fltest

2 Change to the newly created directory by entering the following command at the

system prompt. cd fltest

3 Enter the following command to restore multiplatform save file for FLTEST.

flrest FLINK/mps/fltest.mps /usr/flapps/fltest /loc

196 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
Module Dependencies

MO DU LE D EP ENDEN CIES
Refer to the following chart to determine the tasks required to run the appropriate applications when installing FactoryLink.
Table 7-1

7
FactoryLink Utilities

FLDEMO Alarm Supervisor Configuration Manager Run-Time Color Graphics Database Browser Report Generator Statistical Process Control (SPC) Statistical Process Recalculation Timer Alarm Supervisor

FLTEST Persistence Batch Recipe

Configuration Manager Run-Time Color Graphics Database Browser Database Logger DB4 Historian File Manager Interpreted Math and Logic Counter

Report Generator SPR Statistical Process Control (SPC) Print Spooler Timer Trending

Database Logger Counter

DB4 Historian File Manager Interpreted Math and Logic Batch Recipe

Trending

FactoryLink ECS / Fundamentals / 197

FACTORYLINK UTILITIES
FLCONV

FLCONV
After restoring a FactoryLink application on a new platform or a newFactoryLink version, you must convert it using the FLCONV utility. Once you convert the application, it will not run with the oldFactoryLink. Do not abort the convert after it has started as this can corrupt the application. Perform the following steps to convert an application.
1 Back-up the application using a platform-specific FLSAVE if you have not already

done so. Refer to FLSAVE in this section for more information.

2 Start the FLCONV utility. A dialog is displayed containing the drive and path of

the application to convert. Verify the drive and path are correct.
3 Choose one of the following: OK Cancel

Converts the application Cancels the conversion

The application files are converted.

198 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
FLSAVE

FLSAVE
Use the FLSAVE utility to saveFactoryLink application files. FLSAVE overwrites existing files. Never save to the root directory, the FLINK directory, or any other directory that contains working files. The safest option is to have an independent directory for saves, preferably on a separate disk or partition. FLSAVE saves FactoryLink applications by one of two methods: Platform-specific Multi-platform Platform-specific save The platform-specific method creates a copy of an application that can be restored to other computers running on the same operating system. Use the platform-specific save to save platform-specific files. to back up applications. This creates a complete archive of the entire application. Multiplatform save The multiplatform method transfers an application from a FactoryLink system running on one operating system to a FactoryLink system running on a different operating system. The multiplatform method condenses a FactoryLink application into a single image file of the application. Use the multiplatform save when transporting applications across platforms. If you are converting an application built under a FactoryLink version prior to 4.3, your operating system platform may have allowed file names, directory names, and graphic screens to be longer than 8 characters, not including the file name extension. Starting with 4.3, file names, directory names, and graphic screens cannot exceed 8 characters. If they do, the application will not restore on FactoryLink 4.3 or higher. Never restore a multiplatform save to a FactoryLink version other than the version with which it was saved because configuration data may be lost. Saving an application Perform the following steps to save an application for a platform-specific or multiplatform backup.

7
FactoryLink Utilities

FactoryLink ECS / Fundamentals / 199

FACTORYLINK UTILITIES
FLSAVE

1 Format (initialize) the target diskette before starting FLSAVE. We recommend

using a blank diskette because FLSAVE destroys any applications existing on the diskette.
2 Insert a target diskette into the drive. 3 Start the FLSAVE utility. The FactoryLink Application Save dialog is displayed. 4 Specify the following information in the dialog. Source Destination

Specifies the application drive and path. The default is c:\flapp. Specifies the destination drive and path. The default is a:\. If you do not specify a filename in the destination path, a multiplatform FLSAVE will fail. Specifies whether or not to save all application data files. To use this option, click on the selection box.

Save Application Data Files

5 Choose the type of save to perform. This can be one of the following: Local Backup Local Multiplatform Save File Network Multiplatform Save File

Performs a platform-specific save. Performs a multiplatform save to a local drive. Performs a multiplatform save of the current node to a remote node. Choose this option if you want to restore the application on a node running FactoryLink under another operating system. This option uses the TCP/IP executable rcp to copy multiplatform saves between nodes on the network. This requires the destination node be configured as a network server and the source node hostname exists within the destination HOST.EQU file.

FLSAVE spans diskettes for only the Local Backup format. Local Multiplatform saves do not span diskettes.
6 Choose OK or Cancel when you complete this panel. OK CANCEL

Initiates the save Exits without saving the application.

The following files are saved by both platform-specific and multiplatform FLSAVE operations.

200 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
FLSAVE

Application Editor Graphics Screen Report Format files (RPT/*.FMT) Math & Logic source field (PROCS/ *.PRG, *.INC) CML source files (CML/*.C, *.H, *MAK) Network configuration files (NET/*.*)

7
FactoryLink Utilities

The following files are saved by platform-specific FLSAVE operations. CML binary files (CML/*.OBJ, *.EXE) Log files (LOG/*>*) Recipe files (RCP/*.*)
7 When all files have been copied to the appropriate drive/directory or to diskettes,

the following message is displayed. FactoryLink Application Save Completed

8 Save CML binary, Log, or Recipe files with a multiplatform FLSAVE by copying

them manually onto a backup diskette.

FactoryLink ECS / Fundamentals / 201

FACTORYLINK UTILITIES
CTGEN

CTGEN
The CTGEN utility binds or converts the tagnames specified in the database tables to tag numbers maintained by the real-time database. At run time, the task loads the CT file and builds any internal structures required to perform the job. To improve performance, tasks use the tag number from the CT instead of the tagnames in the database table(s) to access the real-time database. CTGEN uses the CTLIST file to build CTs and rebuild all CTs whose database tables have changed. CTGEN can be run stand-alone or with a combination of parameters. To run CTGEN in stand-alone mode, enter the following command at the system prompt: ctgen <Enter>

202 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
CDBLIST

CDBLIST
This utility is used to debug at the database configuration level. The command line is cdblist [-d] <file.cdb> [<file.mdx] where
-d <file.cdb>

7
FactoryLink Utilities

shows field names is the database file to show contents

FactoryLink ECS / Fundamentals / 203

FACTORYLINK UTILITIES
CTLIST

CTLIST
This utility is used to debug at the binary level. The command line is ctlist <file.ct>

204 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
DBCHK

DBCHK
Use the Database Checking (DBCHK) utility to Check databases for corrupted index files. Remove duplicate entries. Rebuild index files. The syntax is dbchk [options] where options controls how dbchk executes. If you do not specify any command line parameters, the utility only reports on potential problems for the whole application without trying to correct them. options can be one of the following. -Aflapp_dir defines the name of the application directory to check where flapp_dir is the full path to the directory. If you do not specify flapp_dir, the default FLAPP directory is used. Be sure not to use a space between the -A option and flapp_dir. defines the files to check, where titlefile is the name of the file containing the names of the AC files to check. titlefile can be the name of any file you created using a text editor. FLINK\AC\TITLESpath of the file that contains the names of all AC files accessible from the Configuration Manager Main Menu. Use this option if you want to check all the files. FLINK\AC\TTITLESname of the file that contains the names of all AC files not directly accessible from the Main Menu, like the object and cross-reference databases. Be sure not to use a space between the -T option and titlefile. -C reports potential problems but does not try to correct them. If this option is chosen, only reporting occurs even if other options are specified. removes duplicate entries from the database files and generates a new index if any are found. Be careful not to specify a file that permits duplicate entries or they will be removed. generates a new index for the database files. activates verbose mode where n indicates the level of verbosity. This can be one of the following.

7
FactoryLink Utilities

-Ttitlefile

-D

-I -Vn

FactoryLink ECS / Fundamentals / 205

FACTORYLINK UTILITIES
DBCHK

1 provides only record number messages 2 provides text messages -W checks the entire application. This means all AC files listed in titlefile plus OBJECT.AC, XREF.AC, DOMAIN.AC, and TYPE.AC are checked. is the name of the AC file or list of files to check. You can specify up to 200 AC files. Each name must be on a separate line. redirects the output to filename.out where filename.out is the name of the file to receive the output.

ac_file.AC
> filename.out

206 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
EXPLODE

EXPLODE
If a FactoryLink system file, not an application file, becomes corrupt and must be replaced on the hard drive from the installation media, use the explode utility to decompress individual files before replacing them. This is only necessary for Windows NT, Windows 95, and OS/2 platforms. This is necessary because the Installation and System Software media contain compressed files. The syntax is explode infile outfile where
infile

7
FactoryLink Utilities

is the full path of the file you want to copy from the installation disk including the name of the drive where the installation disk is mounted. is the drive and full path name of the directory where you want to write the file.

outfile

FactoryLink ECS / Fundamentals / 207

FACTORYLINK UTILITIES
keyinst

KEYIN ST This is a protection utility usually run during installation; however, you can run it at any time. It is used to create a key without having to go through the entire install process. By entering the serial number followed by the sequence, you open the part of the program where you enter the registration number without having to go through the complete install process.

208 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
flkeyval

FLKEYVA L This is a protection utility usually run during installation; however, you can run it at any time. After you have the registration number, you must contact USDATA within ten days to obtain an authorization number. FLKEYVAL allows you quick access to the system to enter this number. After turning on KEY, you are prompted for the authorization number without having to go through the entire install process.

7
FactoryLink Utilities

FactoryLink ECS / Fundamentals / 209

FACTORYLINK UTILITIES
FLSHM

FLSHM
Use the flshm utility to List memory areas used by multi-user FactoryLink real-time databases. Clean up locked memory areas caused by abnormal shutdown of FactoryLink. This is only necessary in a multi-user environment. The syntax for this command is flshm [option] [rtdb_name] where
option

controls how flshm executes. This can be one or more of the following. If you do not specify any options, you receive a list of available real-time databases. -L Lists existing real-time databases. -U Lists all domain and user names for each real-time database. -M Lists all shared memory segments for each domain. -D Deletes the real-time database. Before using this option, stop the Run-Time Manager. -C Clears the active flag for one or more user names for the indicated application and allows the user to start again without shutting down FactoryLink. Use this option only when an abnormal shutdown of a single domain occurs.

rtdb_name

is the name of the real-time database on which to act. This field is required if you are using the -D option and optional with all the other options. If you do not specify rtdb_name, the actions are taken on the database defined in the FLNAME environment variable.

For example, specify the following command to unlock the shared memory areas for the flapp1 real-time database. flshm -lmu

210 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
UKEY

UKEY
Use the UKEY utility to List licensed options. Check licensed options. Enter this command in lowercase if you are running in a UNIX environment. The syntax is ukey [options] where options can be one of the following. If you do not specify any options, a menu is displayed that includes all of the options available with ukey. -1 lists all the options provided with your license. If there are more options than can fit on one page, the list stops at the end of each page. lists all the options without stopping at the end of each page. list all the options available. If there are more options than can fit on one page, the list stops at the end of each page. lists all the options without stopping at the end of each page. checks if system is properly initialized. If the check is unsuccessful, the following message is displayed. Key not installed If the message above is displayed, install the software protection key or code.

7
FactoryLink Utilities

-lp -d -dp -c

FactoryLink ECS / Fundamentals / 211

FACTORYLINK UTILITIES
Utility Messages

U TILITY M ESSAG ES
If errors occur while FactoryLink is executing a utility, error messages are displayed on the screen. This section lists these messages, describes their cause, and provides suggested actions. Can't open file filename Cause: Action: The system is unable to open an output file. The disk may be full, or the path may not exist. Delete any unnecessary files if the disk is full. Create the path if it does not exist.

Can't create file filename Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

Action:

Can't create directory directory name Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is

Action:

212 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
Utility Messages

compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur. Error writing to file filename Cause: Either the operating system, third-party software, or hardware setup on your system is incorrect or incompatible, or an internal error has occurred. Verify the following: 1. The operating system is set up to run FactoryLink (tuning parameters, resources, etc.). 2. All third-party software needed by FactoryLink (such as X-Windows) has been installed and set up correctly and you have the correct version for FactoryLink. 3. All hardware is correctly set up and all of the hardware is compatible. Contact Customer Support if everything is compatible and set up correctly, but the error continues to occur.

7
FactoryLink Utilities

Action:

Out of RAM Cause: Action: No more memory is available. Close any unnecessary windows or programs. Add more memory to the system if this error occurs often.

FLNEW The following error messages may occur during an FLNEW: ERROR: FLINK environment variable is not set. ERROR: Unable to find FactoryLink directory tree. Cause: Either you have not set the FLINK environment variable or you have to set the FLINK environment variable to an invalid directory structure. Set the FLINK environment variable to a valid directory structure.

Action:

FLNEW aborted! Cause: The FLNEW utility has stopped at your request.

FactoryLink ECS / Fundamentals / 213

FACTORYLINK UTILITIES
Utility Messages

Action:

No action required.

The specified path, path does not exist. Cause: Action: The path you specified for the starter application does not exist or is invalid. Create a directory for the starter application and/or re-run FLNEW using the correct path.

EXPLODE
The following error messages may occur during an EXPLODE: Error number in compressed file filename Cause: An error was encountered during the file decompression process. The number in the message specified a particular system call to the compression library. This type of error is unrecoverable by the user. Contact Customer Support and provide the error message and number.

Action:

No RAM. Remove resident software and try again. Cause: Action: The decompression algorithm could not access enough buffer space due to memory used by the resident software. Remove any TSRs and try again. Contact Customer Support if this problem recurs.

Unable to open filename for compression/decompression. Cause: Action: The filename specified does not exist and cannot be opened for processing Verify the correct filename was specified. Re-enter the command.

Unable to open temporary file for compression/decompression. Cause: Action: The directory structure is full and a temporary file for the compression/decompression operations cannot be created. Remove unused files from the system. Re-enter the command.

214 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
Utility Messages

FLSAVE
The following error messages may occur during an FLSAVE: An error occurred while extracting application files. FLTOOLS Cause: Action: The multiplatform file may be corrupt or the hard disk may be out of space. The utility FLTOOLS provides an error message of its own. Follow the FLTOOLS onscreen instructions.

7
FactoryLink Utilities

Backup failed! Cause: FLXCOPY was unable to copy the application files to the destination path. Either you entered an invalid application file, or the files were corrupted. Check the usage to see if you have entered an invalid application filename. If so, re-enter the command using the correct filename. If you entered a valid application filename, manually save all application files to the \FLAPP directory by performing an X-COPY.

Action:

Backup to filename FAILED! Cause: Action: Either you entered an invalid destination path, or there may be a network error. Check the usage to see if you have entered an invalid destination path. If so, re-enter the command using the correct destination path. If you entered a valid destination path, there may be a network error. For network errors, use rcp (remote copying program) to copy the application to the desired node.

The directory directory path does not exist. Cause: Action: You specified a source path that does not exist. Re-enter the command with a valid source path.

Unknown third parameter Cause: Action: You have chosen an invalid third parameter. Re-enter the command using one of the following valid parameters:

FactoryLink ECS / Fundamentals / 215

FACTORYLINK UTILITIES
Utility Messages

- /RCP to save to a remote node. - /LOC to save to a local drive. Verification of remote copy capability failed. Cause: Action: FactoryLink is unable to remote copy to the destination file. Verify the network is configured to use rcp (remote copying program provided with TCP/IP software) to perform a remote copy to the specified host.

FLREST
The following error messages may occur during an FLREST: A problem was found with file(s) by the file copy program FLXCOPY . Cause: Action: The files or application you are trying to restore may be corrupt or you may have entered an invalid filename. Retry the FLREST. Copy the application to the \FLAPP directory manually if that does not solve the problem.

An error occurred while extracting application files. FLTOOLS Cause: Action: The multiplatform file may be corrupt or out of hard disk space. The utility FLTOOLS provides an error message of its own. Follow the FLTOOLS onscreen instructions.

Cannot open Configuration file source specification /FLCONFIG.$$$ for reading Cause: Action: You entered an incorrect source path. Retry the FLREST with a correct source path and a /LOC parameter to restore a multiplatform save.

Destination path is not full. Include drive with directory i.e. C:\FLAPP. Cause: Action: You did not enter a full path. Re-execute FLREST using a complete destination path (parameter 2).

216 / FactoryLink ECS / Fundamentals

FACTORYLINK UTILITIES
Utility Messages

Error # 7 Designated FLTAR file not in FLTAR format FLTAR aborted. Cause: The FactoryLink file-extraction utility, FLTAR (FLTOOLS) (a transparent utility hidden within the FLREST utility) was given a file either corrupt or not a multiplatform-save file. The file might be a platform-specific save. Retry the FLREST without specifying a third parameter.

7
FactoryLink Utilities

Action:

File FLINK environment variable \ac\titles missing from FactoryLink system! Cause: Action: A FactoryLink IV file is missing. Verify the FLINK environment variable contains the correct directory name. If so, obtain a copy of the file from the FactoryLink IV disk set.

Multi-platform application file file not found. Cause: Action: The system could not find the source file. Verify the filename of the first parameter is correct. Correct it if it is incorrect .

Restore failed! Cause: Action: Either a problem exists in the source or destination drive or the FLCONFIG.$$$ list for FLXCOPY was lost. Check the usage to make sure the source and destination drives for the FLREST are correct. If either is incorrect, retry the FLREST using the correct source and destination drives. If both are correct, check that FLCONFIG.$$$ exists in the FLAPP directory. If that file does not exist, copy it to the FLAPP directory. Then, manually X-COPY all application files to the FLAPP directory. FLREST need not be re-run.

Unable to copy application save file from remote node. Cause: Action: FactoryLink is unable to remote copy the source file. Verify rcp (remote copying program provided with TCP/IP software) can be run with the designated host and the source file exists.

FactoryLink ECS / Fundamentals / 217

FACTORYLINK UTILITIES
Utility Messages

Unknown third parameter Cause: Action: You have chosen an invalid third parameter. Re-enter the command using one of the following valid parameters: - /RCP to save to a remote node. - /LOC to save to a local drive.

218 / FactoryLink ECS / Fundamentals

Chapter 8

FactoryLink Lite
8
FactoryLink Utilities

FactoryLink Lite is designed to run small-scale FactoryLink applications that have been created in either a full FactoryLink or a FactoryLink Lite development package. This product supports a limited number of FactoryLink tags and offers all of the same features as the full scale run-time product. Refer to FactoryLink Lite Product Matrix for current platform availability. The following requirements and limitations will help you to determine whether this product is suitable for your specific application.

D EVELO PER -D EFI NED T AG E LEM ENT M AXIM UM

FactoryLink Lite is designed to process up to 1024 developer-defined real-time database elements per application, including up to 256 I/O elements. All elements of tag arrays are counted toward this total. This total is in addition to the pre-defined elements provided with a new, blank application. Each time you configure an element during configuration, FactoryLink Lite adds it to the total count of elements you have defined for that application. If you define more elements than allowed, FactoryLink displays an error message. At run time, FactoryLink Lite checks the application to determine the number of developer-defined elements. If the application has more than 1024, the application will not run. If the application is started using -d, the error message can be seen in the Run-Time Manager window.

I/O Element Maximum

FactoryLink Lite contains I/O tasks. An I/O task is any task that communicates directly with an external device, such as a computer, a PLC, or nodes on a network. These I/O tasks and their associated elements are a subset of the maximum number of elements you can configure for an application. FactoryLink Lite is designed to process up to 256 I/O tag elements in all of the following I/O tasks: External Device Interface (EDI) PowerNetClient only

FactoryLink ECS / Fundamentals / 219

FACTORYLINK LITE
Developer-Defined Tag Element Maximum

Local Area Networking (FLLAN)both Send and Receive Dynamic Data Exchange (DDE)Server only Various I/O protocol modules, such as AB NETDTL or Modicon Modbus Plus

An I/O element is any element that is the source or target of any of the following: A device I/O point in an EDI read/write table An external domain tag An FLLAN I/O address A DDE I/O address For example, a FactoryLink element that is the target of a Modicon Modbus Plus register in an EDI read/write table is an I/O element. A FactoryLink element that triggers the read/write table is not an I/O element. The effects of this maximum apply only to the loading of EDI, PowerNet, FLLAN, DDE, and other I/O tasks. At run-time, FactoryLink Lite checks the I/O tasks to determine whether any have more than 256 I/O elements. If a task has more than 256 I/O elements, the task shuts down.

220 / FactoryLink ECS / Fundamentals

FACTORYLINK LITE
Configuration Guidelines

C ONFIG URA TION G UIDELI NES

Configure a FactoryLink Lite application as you would any other FactoryLink application, but pay particular attention to the following items: Before you begin configuring, plan how you will use elements and I/O elements in the application so you do not reach the limit before you have defined all you need. Do not define more than 1024 user elements. Choose Application> Size from the Configuration Manager menu bar or Application>Tag Count from the Application Editor menu bar, to display the Application Size dialog. The Application Size dialog is displayed.

8
FactoryLink Utilities

This dialog displays both the total number of elements defined overall (including pre-defined elements) and the total number of elements you have defined. These totals cover all domains for the current application. Do not define more than 256 I/O total elements for I/O tasks. The Application Size dialog box does not separately display the number of I/O elements defined, although these are included in the total number of user-defined elements displayed in this dialog box. If you are developing a Lite application under a full-scale FactoryLink development package and you define too many elements, FactoryLink will not display an error message. If you define too many elements or I/O elements, you must delete the extra elements or the application will not run. Complete the following steps to delete an element:

FactoryLink ECS / Fundamentals / 221

FACTORYLINK LITE
Configuration Guidelines

1 Choose View>X-ref List from the Configuration Manager menu bar to display the

RTDB element cross reference panel. This panel lists all of the tasks that reference the element.
2 Delete the element from all configuration panels where the element is referenced. 3 Delete the element from all graphics objects. 4 Choose View>Object List from Configuration Manager to display the RTDB

Element List panel.

5 Delete the element from the RTDB Element List panel.

222 / FactoryLink ECS / Fundamentals

FACTORYLINK LITE
FactoryLink Lite Error Messages

F ACTO RY L IN K L ITE E RR OR M ESSA GES

If an error related to Lite occurs while you are starting up or running a Lite application, one of the following messages may appear on the Run-Time Manager screen: Application size exceeded by (number) tags for FLS-Lite Cause: This error appears during development and can have either of the following causes: The application has more than 1024 elements configured; this exceeds the Lite development system limit. The application already has 1024 elements defined and you tried to define another one. Either do not edit or run the application on a Lite system, or, using a non-Lite development system, remove at least (number) elements from the application. Refer to Configuration Guidelines on page 221 for instructions for deleting elements. None-but, do not attempt to define more elements unless you delete some.

8
FactoryLink Utilities

Cause: Action:

I/O Point count total exceeded Cause: Action: You have defined more than 256 I/O total elements for the combined tasks. Delete some of the I/O elements. Refer to Configuration Guidelines on page 221 for instructions for deleting elements.

Lite Tag limit exceeded by (number) tags Cause: Action: This error appears at run time. You have defined more than 1024 elements. Delete some of the elements. Refer to Configuration Manager Main Menu for instructions for deleting elements. If the Configuration Manager and Application Editor indicate you have defined more elements than the Run-Time Manager indicates at run time, then some of the elements you have defined are not used by any task. Delete these unused elements.

FactoryLink ECS / Fundamentals / 223

FACTORYLINK LITE
FactoryLink Lite Error Messages

To delete unused elements: 1. Open the Configuration Manager. 2. Open the RTDB Element List panel. 3. Tab over to the Segment and Offset fields. 4. Scan the entries in these columns for blanks. These fields will be blank for unused elements. 5. Use Delete from the Edit menu to delete all elements whose Segment and Offset fields are blank. 6. Clock on Enter to save the information. When you re-start the application, the Run-Time Manager will display the same number of defined elements as the Configuration Manager and Application Editor.

224 / FactoryLink ECS / Fundamentals

Chapter 9

Glossary

A
AC file alarm group Alarm Summary screen Alarm Supervisor alphanumeric analog

AND animate animation object

See attribute catalog. Set of alarm conditions having similar characteristics that you configures in the Alarm Groups Table. On-line display of alarm information. FactoryLink task that identifies alarm conditions and records events that occur during run-time FactoryLink operation. Alphabetical or numeric; an alphanumeric symbol is upper- or lower-case letters , or a digit (0 - 9). (1) Data type supported by FactoryLink; an analog element may assume any integer value from -32768 to 32767. (2) Signal of continuously variable voltage used as a measurement of some infinitely variable quantity, such as temperature, water salinity, blood pressure. Binary logical operator that yields a value of 1 (TRUE) if both of its arguments are non-zero and 0 (FALSE) otherwise. To define a graphics object so it changes color and/or shape or displays numeric values or text messages. Graphically displayed input field, output field, or symbol created using the FactoryLink Application Editor. An animation object may be defined to change color or shape, accept various types of operator inputs, or display alphanumeric data. See Application Editor, display object, and input object. Feature in FactoryLink that enables testing each animation component in a drawing within the Application Editor and provides validation of complex animation types. Set of utilities and/or procedures that allow an application-level program to access application-level functions.

9
Fundamentals

animation testing API (Application Programmer's Interface)

FactoryLink ECS / Fundamentals / 225

GLOSSARY

application

Collection of information from configuration tables generated from the configuration databases and graphics for a set of FactoryLink tasks. Creating a file of data records by logging information to a specified archive device, such as a disk drive. Numeric or string expression (operand) passed to an operator. A seven-bit standard code used for information interchange among data processing systems, communication systems, and associated equipment. Cause of reoccurring variations with identifiable source in a process. Mathematical expression that specifies a calculation to be performed with the results written to a FactoryLink real-time database element. Assigned characteristic for a group of data points used in evaluating statistical information. ASCII text file that describes the database tables and the configuration information entered through the Configuration Manager and the Application Editor; also called an AC file. Data coming from yes/no, pass/fail determinations of whether the units conform to standards. May or may not include weighting by seriousness of defect. See mean.

archiving argument ASCII (American Standard Code for Information Interchange) assignable cause (of variation) assignment statement attribute attribute catalog

attribute data (quality) average

B
background display background task banner line Batch Recipe

Graphics display created with the FactoryLink Application Editor that contains static (non-moving) graphics images. Non-interactive FactoryLink task that performs a specific set of functions that operate on FactoryLink data. Single line display of information about a sorted alarm group. Optional FactoryLink task that allows operators to transfer sets of values between the FactoryLink real-time database and disk files.

226 / FactoryLink ECS / Fundamentals

GLOSSARY

bell-shaped curve

A curve or distribution showing a central peak and tapering off smoothly and symmetrically to tails on either side. The following example is a normal curve..

Bell-Shaped Curve
binary number system

Numeric system used in computers with a base of 2; two digits (0 and 1) represent numerical quantities. Abbreviation for binary digit. The smallest unit of information, consisting of only two possible states, which may be 1 or 0, ON or OFF, TRUE or FALSE, or YES or NO, depending on the context. Hardware component plugged into a FactoryLink key ring that contains information used by FactoryLink to enable licensed software options. See button, key-ring, protection device. Triggered read operation in which the EDI task directs the protocol module to read the values of all external device addresses specified in a single table and write them to the real-time database. Digital element whose value is force-written to 1 (ON) by the EDI task whenever any block read operation for the read table is completed. If this element is defined when the EDI task initializes, its value is force-written to 1 (ON). Digital element of 1 (ON) that disables the block read of the elements specified in a read table. Priority that influences the order in which the EDI task handles the queuing of block read requests. The highest priority (lowest number) is processed first.

bit

block key

block read (triggered)

Block Read Complete

9
Fundamentals

Block Read Disable Block Read Priority

FactoryLink ECS / Fundamentals / 227

GLOSSARY

Block Read State

Digital element whose value is 0 (OFF) when a block read of the elements specified in a read table is in progress and 1 (ON) when the table is inactive. When the EDI task initializes, the Block Read State element is force-written to 1 (ON). Digital element of 1 (ON) that initiates a block read of the values specified in a Read/Write Information panel. See trigger. Write operation in which the EDI task directs the protocol module to transfer the values of all the elements specified in a Read/Write Table to an external device. Digital element whose value is force-written to 1 (ON) by the EDI task whenever any block write operation for the write table is completed. If this element is defined when the EDI task initializes, its value is force-written to 1 (ON). Digital element of 1 (ON) that disables the block write of the elements specified in a write table. Priority that influences the order the EDI task handles the queuing of block write requests. The highest priority (lowest number) is processed first. Digital element whose value is 0 (OFF) when a block write of the elements specified in a write table is in progress and 1 (ON) when the table is inactive. When the EDI task initializes, the Block Write State element is force-written to 1 (ON). Digital element whose value, when forced to 1 (ON), initiates a block write of the values specified in a Read/Write Information panel. See trigger. (1) Digital. (2) A value of 0 or 1 represented internally in binary notation. Load an operating system onto a computer. A configuration table specifying the correlation between elements and database information. The size of a data buffer in networking. Hardware component plugged into a FactoryLink button holder that contains information used by FactoryLink to enable licensed software options. See button holder, protection device. Hardware device that contains information about the licensed FactoryLink options. See block key, button, key ring, protection device.

Block Read Trigger block write (triggered) Block Write Complete

Block Write Disable Block Write Priority

Block Write State

Block Write Trigger

boolean boot browse table BUFSIZE button

button holder

228 / FactoryLink ECS / Fundamentals

GLOSSARY

byte

Unit of storage consisting of eight bits. Because each bit has two possible states, a byte has 256 (2 to the 8th power) possible states.

C
c-chart

For attribute data: A control chart of the number of defects found in a subgroup of fixed size. Use the c-chart when each unit typically has a number of defects. For process capability studies: Cp is a capability index that may range in value from 0 to infinity with a larger value indicating a more capable process. A value near is 1.33 normally considered acceptable. Total Tolerance USL LSL Cp = ------------------------------------------ = ----------------------------6 Sigma 6 Cp Formula

Cp

where
USL = Upper specifications limit LSL = Lower specification limit = Standard deviation

9
Fundamentals
FactoryLink ECS / Fundamentals / 229

GLOSSARY

Cpk

For process capability studies: An index combining Cp and K that indicates whether the process will produce units within the tolerance limits. If the process is centered on the mean specification, the Cpk has a value equal to Cp; if Cpk is negative, the process mean is outside the specification limits; if Cpk is between 0 and 1, some of the 6-sigma spread falls outside the tolerance limits. If Cpk is larger than 1, the 6-sigma spread is completely within the tolerance limits. smaller of Z USL andZ LSL Z min Cpk = ---------------------------------------------------------------------- = ------------3 3 Cpk Formula

where

USL X X USL ZUSL = ---------------------- , Z LSL = ---------------------

USL = Upper specifications limit L SL = Lower specification limit = Grand average from control chart

(X-Bar)

CT CT file CTG file CTGEN

See configuration table. See configuration table. See configuration table generator script. At run time the utility that generates the binary configuration tables (CT files) from the configuration databases.cell (of frequency distribution and/or histogram). An interval of the variable for which all the elements falling in that interval are summed together. Usually the full range of the variable is divided into cells of equal size and only the total number of elements falling into each cell is used in working with the frequency distribution and/or histogram. This greatly reduces the amount of information.

centerline

For control charts: The horizontal line marking the logical center of the chart indicating the expected value of the quantity being charted.

230 / FactoryLink ECS / Fundamentals

GLOSSARY

change-read call change-status flag

Read operation that, when called, checks the change-status flags of a list of elements in the real-time database. Bit that indicates a change in the value of an element or whether the value has changed since the last time it was read. See exception processing. Read operation that, when called, checks the change-status flags of a list of elements in the real-time database. Task that sends a request for action to another task. A task operates as the client when it sends requests for action to another task (the server). The receiving task acts as the server when it responds to a request for action and sends a reply. When starting a domain instance, the initialization of all elements including persistent elements to their default values found in the Configuration Manager. See persistence, persistent elements, and warm start. (1) Part of a relational database record (a record is composed of one or more columns). Also called a field. (2) A vertical group of data entry fields of the same type. Those sources of variability in a process which are truly random or inherent in the process itself. Element that is force-written to a 1 (ON) when an operation is complete. See trigger. Two or more graphic objects combined so the system treats them as a single object. See simple object, subobjects. Depending on or relating to a condition(s). See control statement. Relational database that stores FactoryLink configuration data.

change-wait call client client-server model

cold start

column

common causes completion trigger composite object conditional conditional statement configuration database Configuration Manager configuration mode

9
Fundamentals

FactoryLink development tool that allows you to define the functionality of each task in an application by specifying information in a configuration table(s). Mode of operation that the FactoryLink system is in when you set up an application. In the configuration mode, you use the Application Editor or the Configuration Manager.

FactoryLink ECS / Fundamentals / 231

GLOSSARY

configuration table

Binary file, or CT file, that the CTGEN utility produces at run time that contains data extracted from the configuration database table. Script file, or CTG file, that tells the CTGEN utility how to extract data from a database table and combine the extracted values to produce a binary configuration table (CT) file at run time; found in /{FLINK}/CTGEN. An unchanging quantity or any numeric or string expression that contains no variables. Data for a continuous variable. A variable which can assume any of a range of values; an example would be the measured size of a part. A process that exhibits only random variations. A process with variations within specified control limits. (Not related to statistical control). Graphic representation of a parameter of process performance used to determine if parameter is within acceptable quality limits. The limits within which the product of a process is expected (or required) to remain. If the process exceeds the limits, it is said to be out of control. (Not the same as tolerance limits). See panel. Mathematical expression that includes instructions about the circumstances under which a block of code is to be executed. Also called conditional statement. Light indicator on a monitor that shows where the next character is to be generated. The cursor can be moved across the screen by the use of a key on the keyboard or with a pointing device. Also refers to the chart cursor which points to a specified instant in time on a Trend or SPC plot. The chart cursor retrieves the numeric value or values which are plotted for that instant in time. Recurring pattern.

configuration table generator script

constant continuous data continuous variable control (of process) (statistical) control (of process) (manufacturing)

control chart

control limits

control panel control statement

cursor

cycle

232 / FactoryLink ECS / Fundamentals

GLOSSARY

D
Database Browser

FactoryLink task that uses SQL statements to communicate with a Historian; sends and retrieves data to and from external database tables, including tables created outside of FactoryLink. See element. Group of related database records. FactoryLink task that enables other FactoryLink tasks to send element information to a database historian. FactoryLink configuration database table that stores information generated by a task from the Main Menu or data in the task's panels. Digital, analog, long analog, floating-point, message, or mailbox data types supported by FactoryLink. Conventional base-10 numbering system. Choice made by a program in the absence of a specific selection. Person who designs and configures a FactoryLink application. Name of an external device FactoryLink uses to communicate through a particular logical port. Numeric data type supported by FactoryLink; each digital element holds one bit of information of two values: 1 (ON/TRUE) or 0 (OFF/FALSE). List of files found in a particular area of the operating system. Consisting of unconnected, distinct parts. Graphically displayed output field using the Application Editor that provides an area on a screen where the FactoryLink real-time database displays information output. See animation object. Characteristics of elements in the real-time database in either the USER or SHARED domain. See shared domain, user domain. Characterized by continuous change, activity, or progress.

database element database file Database Logger database table

data type decimal number system default developer Device Name digital

directory discrete display object

9
Fundamentals

domain dynamic

FactoryLink ECS / Fundamentals / 233

GLOSSARY

E
EDI architecture EDI base module EDI (External Device Interface)

Layered communication interface that supports communication links with COMM ports, terminal servers, and coprocessors. An EDI architectural layer that insulates the application from the device and monitors and controls external processes. FactoryLink task that allows information from an external device, such as programmable logic controllers PLCs, RTUs, loop controllers, distributed I/Os, data-collection terminals, or bar-code scanners to be transferred to and from the FactoryLink real-time database. Computer program that creates, changes, manipulates, and deletes objects of a given kind. See button, block key. See protection device. Data structure occupying memory in the FactoryLink real-time database. Name you assign to a real-time database element used during development of an application. Display of ASCII text or numeric code indicating that the system has detected an abnormal situation or incorrect data. Digital element that initiates or controls a system function at run time whose value is forced to 1 (ON) no more than once every twenty-four hours (for example, Monday at 8:00 am).

editor electronic key electronic protection device element element name error message event timer

234 / FactoryLink ECS / Fundamentals

GLOSSARY

EWMA Chart

Graphic display of a statistic that gives less and less weight to data as the data gets older and older. A plotted point on an EWMA chart can be given a long memory, thus providing a chart similar to the ordinary CUSUM chart; or it can be given a short memory, thus providing a chart analogous to a Shewhart (X-Bar) chart.
EWMA = y t + ( y t yt )

where
yt = Observed value at time t y t = Predicted value at time t (old EWMA ) ei = y t y t = Observed error at run-time of t = ( 0 < < 1 ) = Depth of memory of EWMA

exception processing exception write

Basic FactoryLink architecture whereby a real-time database element is read/written only when its value has changed. See change-status flag. Write operation that transfers only the values of elements that have changed since the last time a task scanned the real-time database. See exception processing. Mathematical expression consisting of an optional minus sign (-) followed by consecutive digits (0 - 9), an exponential operator (E), an optional minus sign (-), and another group of consecutive digits. Exponential constants are interchangeable with floating-point constants. Mathematical statement that is resolved to a value.

exponential constant

expression

9 F
Fundamentals
FactoryLink application FactoryLink kernel

See application. See kernel.

FactoryLink ECS / Fundamentals / 235

GLOSSARY

FactoryLink SPC Run Rules

Tests that the SPC Data Monitor process uses to detect patterns of quality-level variations over time. The following shows the chart zones on which the FactoryLink SPC Run Rules are based.

Rule Definition

2 OF 3 4 OF 5

2 out of 3 points lie on one side of the Center Line in Zone A or beyond 4 out of 5 points lie on one side of the Center Line in Zone B or beyond

TREND 7 points in a row are rising or falling 8CONJ 8 points in a row lie on one side of the Center Line 3SIGMA one or more points lie outside of control limits 15CONS_IN_C 15 consecutive points lie within either upper or lower Zone C on the same side of the Center Line 90%25_IN_C of 25 points, at least 90 percent of these (or 23) lie within Zone C (Upper or Lower) and all 23 are on the same side of the Center Line 8CONS_OUT_C 8 consecutive points lie outside either Zone C and are all on the same side of the Center Line 60%25_OUT_C of 25 consecutive points, at least 60 percent (or 15) lie outside Zone C and are all on the same side of the Center Line
FactoryLink task FALSE

See task. Logical level associated with the numeric value of zero; logical operators return a zero when the result of their operation is FALSE. Space in a configuration table or on a display that may or may not contain data; part of a record (a record is composed of one or more fields).

field

236 / FactoryLink ECS / Fundamentals

GLOSSARY

file File Manager

Specific set of data defined by the operating system. FactoryLink task that performs basic file-management operations, such as copying, printing, renaming, typing, and deleting files locally or remote. Name of a specific set of data . Transmitting the contents of a file from one FactoryLink station on a network to another FactoryLink station on the same network using the File Manager task. Option for displaying an on-line alarm; displays the first (oldest) alarm on the system. Attribute that has only two possible states: ON or OFF. FactoryLink environment variable that corresponds to the name of the directory structure containing the application-related files. If you use {FLAPP} in the pathname with its { }, the system uses the default environment variable. FactoryLink utility that converts older applications to run under the current version. FactoryLink environment variable specified during installation as the name of the domain under which the application is designed to run. There is no default for this variable. FactoryLink environment variable that corresponds to the name of the directory structure containing the FactoryLink software system program files. If you use {FLINK} in the pathname with its { }, the system uses the default environment variable. FactoryLink environment variable specified during installation as the name of the application. There is no default for this variable. FactoryLink application utility that creates the user-specified directory structure and copies files required for development of a new application to this directory structure. See floating-point. Data type supported by FactoryLink; each floating-point value occupies 10 bytes of storage in the real-time database and holds numeric values in the range +/- 1E-308 to +/- 1E308 with a precision of 15 decimal digits (all figures approximate). Abbreviated FLOAT.

file name file-transfer operation FIRST flag FLAPP, {FLAPP}

FLCONV FLDOMAIN, {FLDOMAIN} FLINK, {FLINK}

FLNAME, {FLNAME} FLNEW

9
Fundamentals

FLOAT floating-point

FactoryLink ECS / Fundamentals / 237

GLOSSARY

floating-point constant

Mathematical expression consisting of an optional minus sign (-) followed by consecutive digits (0 - 9), a decimal point, and another group of consecutive digits. Floating-point constants may be used interchangeably with exponential constants. FactoryLink environment variable that points to the location of the license information directory {FLINK}\OPT. The {FLOPT} directory contains the files FL.DEV (key type) and FL.KEY (options and license information). If you use {FLOPT} in the pathname with its { }, the system uses the default environment variable. FactoryLink application utility that restores and creates application files into a platform-dependent application. FactoryLink application utility that backs up graphics files, symbols, configuration tables, recipes, logs, and other files and creates a backup of the specified application. FactoryLink environment variable specified during installation as the name of the domain instance. There is no default for this variable. Complete set of type of one size and style. Write operation that writes a new value (even if it is the same as the old value) to an element and sets all of that element's change-status flags to 1 (ON). See statement. Number of times each outcome of a statistical population is observed. Option for displaying an alarm on-line; displays the first (oldest) unacknowledged alarm. Subroutine that performs a specified operation or calculates a specified result. Frequently activated by a keyboard input; hence, function key. See mathematical function. An animation object in the FactoryLink Application Editor that animates a key on the keyboard so it causes an action to occur when pressed at run time. (1) A key used to send a signal to the computer program controlling the display; (2) a key that performs a specific set of operations.

FLOPT, {FLOPT}

FLREST FLSAVE

FLUSER, {FLUSER} font forced-write

formula frequency distribution FUNACK function

Function Key

function key

238 / FactoryLink ECS / Fundamentals

GLOSSARY

G
GFIRST GHIGH GLAST global element

Option for displaying an on-line alarm; displays the first (oldest) alarm in a selected alarm group. Option for displaying an on-line alarm; displays the oldest and highest priority alarm in a selected alarm group. Option for displaying an on-line alarm; displays the last (most recent) alarm in a selected alarm group. See pre-defined element, reserved element.

H
hexadecimal number system Histogram

Numeric system used in computers with a base of 16 in which the letters A-F represent numerical quantities equal to 10 through 15 in the decimal numbering system. A graphic representation of a frequency distribution plotted by ranges of variables divided into equal intervals along with the number of observations accumulated in each.

9
Histogram Fundamentals
Historian

FactoryLink task that provides a common interface with one or more database managers.

I
icon Individual

Graphical symbol representing a function that can be performed. Type of real-time and historical control chart found in FactoryLink SPC. See X-Bar, EWMA.

FactoryLink ECS / Fundamentals / 239

GLOSSARY

information message

Onscreen display of ASCII text or numeric codes that describe normal system status, usually during system startup or shutdown that requires no user or operator action. Also called status message. See panel, initialize. Set up a system for use. Graphically displayed input field created using the FactoryLink Application Editor. See animation object, input text field, pushbuttons. Area on a graphics display defined in the Application Editor to accept operator input in the form of text or numeric values. See input object. A process that exhibits variations larger than its control limits or a systematic pattern of variation. A copy of a FactoryLink application that can be executed at run time. The number of instances allowed is the number of users that can simultaneously interact with the run-time system. See domain. Mathematical expression consisting of an optional minus sign (-) followed by consecutive digits (0 - 9). Element whose value is forced to 1 (ON) at least once every twenty-four hours at regular intervals of the system clock (for example, every 60 seconds). An interval timer can be used to initiate or control a system function at run time.

information panel input object

input text fields

instability (of a process) instance

integer constant interval timer

K
K

For process capability studies: a measure of difference between the process mean and the specification mean.
( Mean Midpoint) K = ------------------------------------------------( Tolerance 2 )

K Index Formula
kernel

FactoryLink software module that creates the real-time database when the FactoryLink Run-Time system is started that provides security for the FactoryLink System and exchanges data among tasks.

240 / FactoryLink ECS / Fundamentals

GLOSSARY

key keyboard cursor key ring

See block key. See text cursor. Part of an electronic protection system that plugs into a FactoryLink key ring. Contains information used by FactoryLink to enable the licensed software options. See option key, protection device, button. Keyboard key or button that is being animated using the Application Editor. ASCII text files that tell the Configuration Manager how to translate text table entries into binary values; also referred to as key files found in the /{FLINK}/KEY directory.

Keystroke keyword files

L
LCL LSL ladder logic LAN library inking Local Area Network (LAN) LOCAL file local station log logical operator

Lower Control Limit. For control charts: the limit below which the quality of a process is out of control. Lower Specification Limit. The lowest value of a product dimension or measurement which is acceptable. Language used to configure programmable logic controllers; industry standard for representing relay-logic control systems. See Local Area Network. Collection of utility functions that primarily interface application and system programs to the FactoryLink kernel. Process of associating an object and its animation attributes to elements in the FactoryLink real-time database. In-house data-communications system connecting a number of microcomputers. See node, node name. ASCII file in which you define a local station name. The LOCAL file resides in the /{FLAPP}/NET directory.

9
Fundamentals

Current station on a network. Set of data files, error messages, or alarms spooled to a printer or archived to disk. Symbols in expressions that test operands for TRUE (non-zero) or FALSE (zero) values and return a result of 1 (TRUE) or 0 (FALSE).

FactoryLink ECS / Fundamentals / 241

GLOSSARY

logical port

Number you enter in the FactoryLink External Device Definitions Table to represent the physical port. When using an IBM RIC/ARTIC card, this number represents a combination of the physical card and the physical port. Number that you enter in a Read or Write Table representing the combination of a logical port with a physical station. Abbreviation for long analog. Data type of a 32-bit signed integer supported by FactoryLink. Abbreviated LONGANA.

logical station LONGANA long analog

M
mailbox

Data type supported by FactoryLink; a mailbox element is organized as a queue of mailbox messages and associated message data and consists of variable length and variable structure. Prevents an alarm from being activated. FactoryLink task that performs mathematical and logical calculations and assigns the results to elements. (1) A mathematical expression describing a relationship between two or more variables. (2) A function that implements a mathematical operation, such as square root or cosine. For a list of mathematical functions, refer to Math and Logic in the Core Tasks Configuration Guide. The average value of some variable. The mean is given by the following formula where x is the value of the variable to the ith element and n is the number of elements in the sample.

mask Math & Logic mathematical function

Mean (of a statistical sample)

x1 + x 2 + + xn X = -----------------------------------------------n Mean
Set of choices for functions displayed together overlaying the present contents of the screen without disrupting them. Data type of string or binary data having a total length of 64K supported by FactoryLink.

menu message

242 / FactoryLink ECS / Fundamentals

GLOSSARY

monochrome mouse cursor

Type of monitor that displays information in only one color. Small arrow or shape in the Application Editor representing a selected option that indicates the point on the screen where the next keyboard input or mouse click is displayed. A pointing device moves the mouse cursor. Same as X-Bar and range calculation except that a circular buffer of Moving Size is used instead of Subgroup Size. A chart used in FactoryLink SPC having points which are averages or ranges of previous data carried forward with the current data. Used to dampen the effects of a single reading when only one reading is made per time period or when a process is strongly linked to a previous data output. See range, X-Bar.

moving average/moving range moving average/moving range chart

N
NETBIOS

Software standard used for local area networks or optional FactoryLink task used for communicating between FactoryLink systems over a local area network. Group of terminals and one or more computers connected for moving information from place to place. Station or general junction point on a Local Area Network (LAN). See Local Area Network. Unique name for a node on a specific Local Area Network (LAN). See Local Area Network. Unary logical operator that yields a value of 1 (TRUE) if its argument is 0 (FALSE) and 0 (FALSE) if its argument is TRUE (nonzero). For attribute data: a control chart of the number of defective units in the subgroups with fixed subgroup sizes. Number of data buffers in which data can be queued In networking. Integer or floating-point (or exponential) constant. Area on a graphics display defined in the Application Editor to accept operator input in the form of a number. See input text field, input object.

network node node name NOT

9
Fundamentals

np-Chart NUMBUFS numeric constant numeric input field

FactoryLink ECS / Fundamentals / 243

GLOSSARY

O
object OBJECT database table octal number system Open Software Bus architecture operand operating characteristics curve Operating System/2 (OS/2) operator

See animation object. Configuration Manager-maintained database table that stores the real-time database definition and other related information. Numeric system with a base of 8 used in computers. FactoryLink operating principle whereby modular software programs run concurrently and communicate through a global real-time database. See argument. For acceptance sampling: curve showing the percent defective in a lot vs. the probability that the lot will be rejected for a specified lot size and sampling plan. Prioritized, multitasking environment that manages system resources, such as memory, disk drives, input/output devices, printer ports, and other system components. Abbreviated OS/2 . (1) The person who operates the finished application. (2) Mathematical function. The operators supported by Interpreted Math and Logic include the most common arithmetic, logical, relational, and conditional operators used in computer science and related disciplines. See block key ,button. Binary logical operator that yields a value of 1 (TRUE) if at least one of its two arguments is TRUE (non-zero), and 0 (FALSE), otherwise. See operator. See Operating System/2. Variations larger than the quality control limits.

option key OR

OS/2 out of control

P
PAK p-chart (percent defective) PLC panel

See Programmer's Access Kit. For control charts: the percentage of defective units in which the subgroup size varies. Used for attribute quality control. See Programmable Logic Controller. Screen display that provides pre-defined entry fields for information required by a configuration table.

244 / FactoryLink ECS / Fundamentals

GLOSSARY

Pareto analysis

An analysis of the frequency of occurrence of various possible concerns. This is a useful way to decide quality control priorities when more than one concern is present. The Pareto Principle states that 20% of concerns cause 80% of the problems. A bar graph showing the frequency of occurrence of various concerns with the most frequently occurring ones first and with a line chart showing cumulative data vs. data type. Route of a sequence of file names or directory names for an operating system to follow to locate information stored in a computer. Element whose value represents a particular combination of attributes for trending activity. Contains values used in an on-line trending chart the same way values recorded by a pen are used in a strip-chart recorder. Graphic representation of a record of trending activity associated with a particular pen. On an on-line trend chart, resembles the line drawn by a pen on a strip-chart recorder. For acceptance sampling: the percentage of defective units or units of unacceptable quality in a lot. See variable specifier, sprintf string. Ability of an element to maintain its value over an indefinite period of time. Real-time database elements that maintain their value when a domain instance is closed, either deliberately or inadvertently (from a power loss or faulty process). This is possible because the values of the persistent elements are written to permanent storage and are not affected by a system shut down. Physical address of an external device on a network. A group of light phosphors that can be stored, addressed, or displayed by a computer. Abbreviation for picture element. Device, such as a keyboard or a mouse, that allows control over movement of the cursor during the creation of graphics images and displays. Closed-plane figure bounded by three or more line segments.

Pareto diagram

path name

pen

pen trace

percent defective percent specifier persistence persistent elements

9
Fundamentals

physical station pixel pointing device

polygon

FactoryLink ECS / Fundamentals / 245

GLOSSARY

Power Edit

An editing tool that enables you to select and directly edit subobjects, including their animation, within a composite object without breaking apart the composite. See composite object, simple object, subobject. User-extensible, animated compound objects that contain template variables for the animation features. See Power Packs. Libraries of drawings where you can store Power Objects for reuse in creating new instances of similar objects in the same or in other applications. See Power Objects. Convenient element configured for internal system use. Sometimes called reserved element or global element. FactoryLink task that extends the printing capabilities of the system by providing multiple print buffers and the ability to use serial or parallel printers. Also allows output to be directed to a disk file. (1) Three-digit hexadecimal number, such as 201, that specifies the processing priority for a FactoryLink task. where the first number (2 in 201) specifies the operating system class of priority. the second number (01 in 201) specifies the priority within the class listed above. The higher the number, the higher the priority within the class. (2) Rank or position of an operation in a sequence of operations.

Power Objects Power Packs

pre-defined element Print Spooler

priority

process capability

The level of uniformity of product that a process is capable of yielding expressed by the percent of defective products or the range or standard deviation of some product dimension. Process capability is usually determined by performing measurements on product units produced by the process. Maintaining the performance of a process at its capability level by sampling the process product, charting its performance, determining causes of any problems, and taking corrective actions. FactoryLink task that provides triggered up/down counters with terminating triggers.

process control

Programmable Counters

246 / FactoryLink ECS / Fundamentals

GLOSSARY

Programmable Logic Controller (PLC)

Special purpose computer programmed to control process or machine operation. The programmable logic controller consists of five basic components: processor, memory, input/output, power supply, programming device. A PLC is designed as an industrial control system. Collection of optional FactoryLink software tools and programming libraries and keys related documentation for use by programmers in their design and construction of FactoryLink-compatible programs. Character or message on a video display indicating the system is ready to accept a command. A button in Windows NT, Windows 95, or OS/2 FactoryLink systems plugged into a button holder or one or more electronic block keys that are plugged into a key ring. The button holder and key ring plug into the parallel port of the printer. The protection devices contain information FactoryLink uses to enable icensed software options. An EDI architectural layer that insulates the EDI base module from the type of external device you are using and provides the flexibility to support many different types of external devices. Input objects used with a pointing device or function key that performs an operation, such as shutting down a task.

Programmer's Access Kit (PAK)

prompt protection device

protocol module

pushbuttons

Q
quality characteristic

Particular aspect of a product that relates to its ability to perform its intended function.

R
R-Chart

9
A control chart of the range of variation among the individual elements of a sample or the difference between the largest and smallest elements as a function of time, lot number, or similar chronological variable. (1) The difference between the highest and lowest of a group of values. (2) Type of real-time and historical control chart found in FactoryLink SPC. See X-Bar, moving range.

Fundamentals

range

R=

(Largest value in Subgroup) minus (Smallest value in Subgroup)

FactoryLink ECS / Fundamentals / 247

GLOSSARY

read call read complete read disable read priority read state read trigger real-time real-time database

Operation that returns the value of an element regardless of the value of the element's change-status flag. See Block Read Complete. See Block Read Disable. See Block Read Priority. See Block Read State. See Block Read Trigger. Immediate software response to an event. Memory-resident array of information that acts both as an in-memory storage device and an interprocess communication mechanism for FactoryLink tasks. All FactoryLink tasks share the information in the real-time database by reading from or writing to real-time database elements. FactoryLink task that allows you to modify the real-time database during run time and to monitor process access to the real-time database; used to develop and debug applications. (RTMON). See element. Boot again. See boot. See Batch Recipe. In a relational database, a unit or set of data that is the basic component of a file. Also called a row. Mathematical function that yields a TRUE or FALSE result that depends on the signs and relative magnitudes of its arguments. The FactoryLink Interpreted Math and Logic program recognizes six relational operators: < <= > >= = != For control chart: subgroup of units selected to minimize the differences because of assignable causes. Samples taken consecutively from a process operating under the same conditions usually meet this requirement. Electrically operated device that mechanically switches electrical circuits.

Real-Time Database Debugger real-time database element reboot Recipe record relational operator

relational subgrouping

relay

248 / FactoryLink ECS / Fundamentals

GLOSSARY

relay logic remote station Report Generator reserved element result table row run run time Run-Time Graphics run-time mode Run-Time Manager

Representation of a program or other logic in a form normally used for relays. Other station on a network. FactoryLink task that formats real-time database information into a predefined, field- printed report. See predefined element. Temporary table containing data selected from an external database. See record. A set of consecutive units sequential in time. Period during which a FactoryLink application is operating. The FactoryLink Graphics task. Animated displays with which the operator interacts when the application is running. For this task to be available, the Application Editor must be installed. State of the FactoryLink system when an application is operating. FactoryLink task that supervises all other FactoryLink tasks as they operate.

S
sample (statistics) sample size sampling sampling variation select object server

A representative group selected from a population used to determine the properties of the population. The number of elements, or units, in a sample. The process of selecting a representative sample of a population and determining the properties of the sample. The variation of a sample's properties from the properties of the population from which it was drawn.

9
Fundamentals

See input select object. (1) Task that receives requests for action from other tasks. (2) A computer that provides a shared hard disk and possibly other resources in a local area network. Collection of elements in the real-time database that contain publicly-owned data and tasks available to all users at run time. See domain, USER domain.

SHARED domain

FactoryLink ECS / Fundamentals / 249

GLOSSARY

Sigma

(1) Standard deviation of a statistical population. Represented by the symbol . (2) Type of real-time and historical control chart found in FactoryLink SPC. See X-Bar, moving averages. For histograms: lines marked on the histogram showing the points n standard deviations above and below the mean. For control charts: control lines evenly spaced on either side of the center line.

sigma limits

signals simple object

Notifications of events used to affect process control. Single objects, such as lines, circles, and text, not composed of any other objects. The basic building blocks of a graphics display. See composite object, subobjects. Group of ASCII characters that specify a standard format for one or more variables to be inserted in a character string preceded by the % symbol. A process showing no recognizable pattern of change. See control, constant cause system. A measure of the variation among the members of a statistical sample. If a sample of n values has a mean of x, its standard deviation is given by the formula shown.
=

sprintf string

stability (of a process) standard deviation

(x x)

------------------------n1

Standard Deviation Formula

start trigger statement

Element whose value, when forced to 1 (ON), initiates an action in a FactoryLink task. Mathematical expression or formula that may contain any of the following components. Directives Expressions, including operators, variables, and/or constants Comments Functions Any PLC, computer, or data terminal connected to and communicating through a network. Name given to a device connected to a network.

station station name

250 / FactoryLink ECS / Fundamentals

GLOSSARY

statistical control (of a process) status message string constant

A process that exhibits only random variations. See information message. ASCII numeric expression consisting of an opening double quotation mark followed by zero or more printable characters and a closing double quotation mark. Directory contained within another directory. For control charts: sample of units taken at or near the same time from a given process. Each object in a composite object is called a subobject. Subobjects can contain simple and/or composite objects. See composite object, simple object. A graphic object exchanged with another object during runtime.

subdirectory subgroup subobjects

symbol

T
table tag name tag number

See configuration table, database table. See element name. A two-part number FactoryLink assigns to an element and uses to refer to that element when writing a value to it or reading its current value. For example, the tag number 0:177 where 0 is the segment (block of space in the real-time database that stores elements of one datatype 177 is the offset (location of the bits in the segment that contain the element).

9
Fundamentals

task task-specific database table text cursor Timer

FactoryLink program that reads from and writes to the real-time database and performs a specific function. Database table that stores information related solely to a specific task. Flashing vertical bar that indicates the point on the screen where the next keyboard input will be displayed. FactoryLink task that updates real-time database information based on the chronological events and time intervals specified in its configuration tables.

FactoryLink ECS / Fundamentals / 251

GLOSSARY

toggle tolerance

To switch between two states or values. The permissible range of variation in a particular dimension of a variable. Tolerances are often set by engineering requirements to ensure components will function together properly. A gradual, systematic change with time or another variable. FactoryLink task that displays data stored in a relational database as a strip chart on a real-time graphics display. FactoryLink graphics display that resembles a strip-chart recorder. Composed of a chart object and pen objects that function in combination with real-time database values for on-line display of real-time and/or historical data. Digital element that causes an event to occur when its value is forced to 1 (ON). Logical level associated with any non-zero numeric value, usually 1 (ON). See data type. Database table that defines segments where a data type used is stored in the real-time database.

trend Trending trending chart

trigger TRUE type TYPE database table

U
u-Chart UCL UKEY USL unary operator

For attribute data: a control chart of the percentage of defects in one inspection subgroup of non-fixed size. Upper Control Limit. For control charts: the limit above which the quality of a process is out of control. FactoryLink utility you view information in the software security mechanism with. Upper Specifications Limit: the highest value of a product dimension or measurement which is acceptable. Mathematical function that takes one argument, usually placed after it. For instance, in the expression NOT Overflow, the logical negation operator NOT has Overflow as its argument. Command issued by an external device, independently of FactoryLink, to write information to the real-time database without requesting the data.

unsolicited read

252 / FactoryLink ECS / Fundamentals

GLOSSARY

USER domain

Collection of elements in the real-time database that contain data and tasks available locally to a specific user at run time. In a multiuser system, each user owns a copy of all the elements in the USER domain. See domain, SHARED domain.

V
variables variable data variable specifier variance VERBOSE

Quantities subject to change or variability. Concerning the values of a variable as opposed to attribute data. ASCII character that represents a replaceable value in a character string. See sprintf string. The square of the standard deviation. A command-time option that flags the process to provide debugging information.

W
warm start

When starting a domain instance, the initialization of all non-persistent elements to their default value. Similar to a cold start and restores all persistent elements to their previously saved values. See cold start, persistence, persistent elements. SQL (Structured Query Language) statement part that specifies a filter for accessing data in a relational database. Symbolic character, usually an * (asterisk), taken to mean any character in a character string. Area occupying either part or all of a screen on which program information is presented. Operation that writes a new value to an element and, if the new value is different from the previous value, sets all of that element's change-status flags to 1 (ON). See Block Write Complete. See Block Write Disable. See Block Write Priority. See Block Write State. See Block Write Trigger.

where clause wild-card character window write call

9
Fundamentals

write complete write disable write priority write state write trigger

FactoryLink ECS / Fundamentals / 253

GLOSSARY

X
X-Bar

(1) Mean or average represented by the symbol x and the formula shown:(2) Type of real-time and historical control chart found in FactoryLink SPC. See Sigma, EWMA, etc.

x Sum of the values in subgroup X = --------- = ---------------------------------------------------------------------------------------------n Total number of values in subgroup

x and R Chart x and Sigma Chart XOR

For variable data: control charts for the average and range of subgroups of data. For variable data: control charts for the average and standard deviation (sigma) of subgroups of data. Abbreviation for the Exclusive OR, a binary logical operator that yields a value of TRUE (1) if one, but not both, of its two arguments is TRUE (non-zero). Configuration Manager-maintained database table that contains a record for each occurrence of an element in any task-specific database table or graphics animation.

XREF (cross-reference) database table

254 / FactoryLink ECS / Fundamentals