Monitor Pro Tuto2

8/22/2019 Monitor Pro Tuto2

1/254FactoryLink ECS 6.0 / March / 1996

FactoryLink ECS

F u n d ame n t a l s

FactoryLink ECS 6.0 / March / 1996


2/254

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 corporatio

and is protected by United States copyright and trade secret law and international treaties. This document may refer 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 U

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 repres

or warrant that (a) the Software Programs will operate in any way other than in accordance with the most current opera

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

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

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, duplicatio

disclosure by the government of the United States is subject to restrictions as set forth in subparagraph (c)(1)(ii) of ThRights in Technical Data and Computer Software clause at DFARS 252.227-7013 or in subparagraphs (c)(1) and (2) of

Commercial Computer SoftwareRestricted Rights clause at 48 CFR 52.227-19, as applicable. Contractor/Manufact

is United States Data Corporation, 2435 North Central Expressway, Suite 100, Richardson, TX 75080-2722. To the ex

Customer transfers Software to any federal, state or local government agency, Customer shall take all acts necessary

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 copie

only in accordance with the terms of the applicable agreement. It is against the law to copy the software on any medi

except as specifically allowed in the applicable agreement. No part of this manual may be reproduced or transmitted in

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 CorporatiOpen 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.


3/254

FactoryLink ECS / Fundamenta

Table of Contents

F u n d a m e n t a l s

Part title variable applied here in this

bookPart title variable applied here in the Fundamen-

tals

1 Over view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Development E nvironm ent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Run -time E nvironment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Real -tim e Da ta ba se . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Gen eratin g Da ta in R eal-t ime Da ta base . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Readin g Da ta from the Rea l-t ime Da ta base . . . . . . . . . . . . . . . . . . . . . . . . . 15

Fa ctoryLink Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Gener al M odu les. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

M odu l es for Accessin g Stored Da ta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

M odu les for L oggin g and Retr ievin g Data. . . . . . . . . . . . . . . . . . . . . . . 16

M odul es for Commu ni cat in g Acr oss th e N etwor k. . . . . . . . . . . . . . . . . . 17

Tw o Doma ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Doma in Structu re. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Doma ins for Run -t ime Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Multiple-user En vironments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

M ult ip le Shar ed Appl icat i ons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

M ult iple Separ ate Appl icat ions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Fa ctoryLink Directory Orga nizat ion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22TF actoryLi nk A ppl icat ion Dir ectory Subdi r ect ori es. . . . . . . . . . . . . . . . 22

FactoryL in k Appl i cat i on Di rectory Fi les. . . . . . . . . . . . . . . . . . . . . . . . . 23

FactoryL in k System Dir ect ory Subd ir ectori es. . . . . . . . . . . . . . . . . . . . 23

En vironment Var ia bles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Usi ng Form a t Specifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

2 Wor ki ng w i th Tags i n Conf i gu rat ion M anager . . . . . . . . . . . . . . . 31

Defini ng Ta gs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Defin in g Tags Whi le in t he Confi gu r at i on M ana ger. . . . . . . . . . . . . . . . 32

Defin in g Tags Whi le in th e Appl icat ion Ed itor . . . . . . . . . . . . . . . . . . . 34

Definin g Element Arra ys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Defin in g On e-di mension al Ar r ays. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Def in i ng M ul t i -d im ensional A rr ays. . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Part title variable applied here in this

bookFactoryLink Fundamentals


4/254

4 / FactoryLink ECS / Fundamentals

Fundamentals

Maximum N umber of Arrays. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

U sing Ta gs a s Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

P redefined E lements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

3 U si ng the Con f i gu rat i on Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Opening the Configuration Ma na ger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Win dows N T or Win dows 95 Plat form . . . . . . . . . . . . . . . . . . . . . . . . . . 42

OS/ 2 P la t form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

U NI X P la tform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Configura tion Mana ger Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Working wit h Text-entr y P a nels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Working w ith St ructured Con figura tion P a nels . . . . . . . . . . . . . . . . . . . . . . 47

Scrolling a Window or Pa nel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Vert ical Scrol l Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

H or izontal Scrol l Ba r. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Working with Multiple Development Applicat ions . . . . . . . . . . . . . . . . . . . . 51

Openi ng a N ew Developmen t Appl icat i on . . . . . . . . . . . . . . . . . . . . . . . 51

Shar in g In form at ion Between Appl i cat ions. . . . . . . . . . . . . . . . . . . . . . 52

Opening Multiple Configura tion Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Working wit h Ta gs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Vi ewi ng t he N um ber of Tags Defin ed. . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Vi ewin g a L ist of Real-t im e Database E lements. . . . . . . . . . . . . . . . . . . 56

Vi ewi ng E l emen t Cr oss Refer ence L i st. . . . . . . . . . . . . . . . . . . . . . . . . . 58Sear chi ng for a Tag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Deleti ng a Ta g Defi ni t ion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Chan gi ng a Tag Defi ni t ion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

View ing Miscellan eous In forma tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Vi ewin g Domai n L ist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Vi ewin g th e Cur r ent Ver sion of Fa ctoryL ink. . . . . . . . . . . . . . . . . . . . . 67

Vi ewi ng Fi eld Ch oices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

E diting C onfigura tion P an els . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

In ser t i ng a Blank L ine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

Delet in g a Li ne En try. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Copyin g Contents of a L in e Entr y. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Cut t in g a L ine Ent ry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Past in g a Copied or Cut L ine Entr y. . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

Searching for a Text Str ing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72


5/254

Fundamentals


G etti ng H elp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Man a ging Text-entr y P an el Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Savin g Fi le Conten ts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74M erg ing a F i l e. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Checkin g Syn tax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Clear ing Er rors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Chan gin g Font Size. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

C onfigura tion Mana ger Messa ges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

4 U si ng Syst em Conf i gu r at i on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

E diting Ta sk Informa tion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

Vi ewin g Domai n Associat ion s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Ad din g New Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111

C ha nging Domai n Associa t ions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

Set t ing th e Run-Time G ra phics Windows . . . . . . . . . . . . . . . . . . . . . . . . . . 114

C ha nging th e Windows Color Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115

Archiving Er ror Messa ges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Resizing and Moving Screen C omponents . . . . . . . . . . . . . . . . . . . . . . . . . . 119

C alculatin g the Number of Fa ctoryLink P rocesses . . . . . . . . . . . . . . . . . . . 120

5 U si ng Run-T im e Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Set t ing C omma n d Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Accessing Run -Time Man a ger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

On Windows N T and Win dows 95 Plat forms. . . . . . . . . . . . . . . . . . . . 127

On OS/ 2 Pla t form. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

On UN IX Plat form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

Run -Time Man a ger User-In terface Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Task Con tr ols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

Appl i cat ion Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

D i spl ay Contr ols. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Run -time Mana ger Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Text M essages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136M essages wi th E r r or N um ber s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

Corr ect i ng I ntern al Er rors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148


6/254


Fundamentals

6 U si ng Run-T im e Mon i t or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

Accessing t he Run -Time Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Viewing the Cu rrent Value of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Ad din g Element s to a Watch L ist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Deleti ng E l ement s fr om a Watch L ist. . . . . . . . . . . . . . . . . . . . . . . . . . 154

Fin din g Element s in a Watch L ist. . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Stor ing Watch L ist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Retr ievin g Watch L i st. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Readin g and Writing a Real-Time Da ta base Element . . . . . . . . . . . . . . . . . 157

Moni toring Fa ctoryLin k Pr ocesses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

U sing Run -Tim e Monitor Comma nds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163

Terminat in g a T ask. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Exi t i ng Comm ands Win dow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Accessin g H elp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Read in g an E lement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165

Wr it in g to an Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166

Work ing w i th Bat ch Fi les. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

Monitoring th e Sta tus of the Real -Time Da ta base . . . . . . . . . . . . . . . . . . . 171

Termina tin g All Fa ctoryL in k Ta sks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

E xiting RTMON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175

Run-time Mana ger Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

Text M essages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

M essages wi th E r r or N um ber s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Corr ect i ng I ntern al Er rors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

7 Factor yL i nk U t i l i t i es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

F LNE W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

F LTE ST a n d FL DE MO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

On Windows NT a nd Windows 95 Operat ing Syst ems . . . . . . . . . . . . . . . . 192

On OS/2 Opera tin g Sys tems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

On U NIX Opera ting Syst ems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Restor in g FL DEMO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Restor in g FL TEST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Mod ule Dependen cies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

F LCONV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

F LSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
http://-/?-http://-/?-


7/254

Fundamentals


C TG EN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

C DB LIS T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

C TLI ST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204DB C HK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

E XP LOD E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

keyinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

flkeyva l . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

F LS HM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210

U KE Y . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

U tility Mess a ges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

EXPLODE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

FLSAVE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

FLREST. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

8 Factor yL i nk L i t e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

I / O E lement M aximum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

C onfigura tion G uidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

F a ctoryLink Lit e E rror Messa ges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223


8/254


Fundamentals


9/254


Chapter 1

Ove r v i ew

Fa ctoryLink is a softw a re development tool d esigned to build a modular,multi-ta sking applica tion tha t a utomates a nd contr ols a process, such a s theproduction of goods a t a fa ctory, th e movement of liqu id or ga s down a pipeline, orth e periodic collecti on of da ta . You use th e unlimi ted capa bilities of Fa ctoryLin kto build an a pplica t ion tha t performs the t a sk you wa nt t o a utoma te for yourprocesses.

Fa ctoryLink ha s two opera ting environment s.

DevelopmentTh e a ctivit ies required to a utoma te a n d con trol a process a reconfigured in t he development environment crea ting a practical applicat ion.You configure an a pplica tion using the C onfigura tion Ma na ger Main Menu.Refer to Ch apter 3, Using th e Configura t ion Ma na ger, for deta ils on sta rt ingan d using t he Ma in Menu.

Run timeWhen t he a pplication creat ed in the development environment i ssta rted , it executes in t he run-time environment. You control an d monitor thesta tus of the application using t he Run-Time Man a ger, which a llows you t osta rt , monitor, an d stop individua l run-time ta sks. Refer t o Chapter 5, UsingRun -Time Ma na ger, for deta ils on sta rt in g an a pplica tion an d usin g theRu n-Time Ma na ger.

Fa ctoryLink is a s et of progra ms; ea ch progra m performs a specific a ctivity in t hea utoma tion process, such a s the collection and stora ge of da ta , th e genera tion ofreport s, or the ma na gement of files. Th ese progra ms a re called modules in thedevelopment environment a nd ta sks in t he run -time environment.

This cha pter describes t he con cepts necessary to und erst a nd how F a ctoryLi nkworks. I t a lso describes each modu le tha t can be configured to a utoma te yourprocess.


10/254

OVERVIEW

Development Environment


DEVELOPMENT ENVIRONMENT

A Fa ctoryLink a pplica tion is configured in t he development en vironmen t. This

environment con ta ins a series of con figura tion ta bles for ea ch module. Refer to Fa ctoryL ink Modules on page 16for a list of modules. You open these ta bles choosin g a specific menu option from t he Ma in Menu .

Ea ch option is compri sed of one or more panel s. For exa mple, th e Logger ta blecomprised of two panels: th e Da ta base Logging Contr ol pan el an d th e Da ta basLogging In forma tion pa nel.

Access toconfigurationtables


11/254

OVERVIEW

Development Environme

FactoryLink ECS / Fundamentals

You must fill out th ese pa nels to con figure th e mod ule. Refer t o th e FactoryL in kConf igurat ion Gu id efor det a ils on configurin g each module.

The informa tion ent ered in these panels is stored in dB ASE I V compat ible files inthe directory where th e Fa ctoryLink a pplication files a re stored. R efer t oFa ctoryLi nk Directory Orga niza tion on pa ge 22for deta ils on wh ere these filesreside. These files ar e ident ified b y t heir .cd b extension a n d th eir correspondin gindex files ar e ident ified b y th eir .mdx extens ion.


12/254

OVERVIEW

Run-time Environment


RUN-TIMEENVIRONMENT

The run -time environment uses th e informa tion provided in th e configura tion

ta bles to build an a pplication. When th e Fa ctoryLink ap plicat ion is st a rt ed, thcontent s of the dB ASE I V files ar e tra nslated a nd stored in bina ry files conta ina .ct extension . Wh ere th ese files a re located depends on th e doma in a ssocia tedwith th e data . Refer to Fa ctoryL ink Directory Orga niza tion on pa ge 22fordeta ils. Th e nam e assign ed to ea ch file uses th e following form:

module_name.CT

where

module_name th e na me of the ta sk as it is displayed in th e system configura tt ask .


13/254

OVERVIEW

Real-time Databas


REAL-TIMEDATABASE

A real-t ime da ta ba se is centra l t o all F a ctoryLink ta sks in rea l-t ime mode. This

real-t ime data ba se resides in m emory a nd a cts as both a s torage device and a ninterprocess communicat ion mecha nis m.

All Fa ctoryLin k ta sks share informa tion in the real-t ime dat a bas e by read ingfrom or writ in g to th e real-t ime da ta base. Da ta is never pa ssed d irectly betweentwo ta sks .

Ea ch da ta s tored in the real-t ime dat a base is an element . During a pplicat iondevelopment, each element is assigned a logica l na me in Fa ctoryLink called a ta gThis ta g na me is used to referen ce th e element in t he rea l-t ime da ta base.

Refer to Cha pter 2, Working w ith Ta gs in Configura tion Mana ger for deta ils onassigning ta g na mes a n d for a list of predefined elements shipped w ithFactoryLink.

Realtime database

pump1_tmp

(Logically representsan element in database)

Elements

Tag Names

pump2_tmppump3_tmp

Realtime database


14/254

OVERVIEW

Generating Data in Real-time Database


GENERATINGDAT A INREAL-TIMEDATABASE

The data ba se s tores da ta tha t ha s been:

Wh en da ta i s collected a nd st ored in the da ta base, other ta sks ca n open an dma nipulat e it . A ta sk ca n w rite in forma tion to an element in th e real-t imedat aba se using one of tw o types of wr ites: a norma l write or a forced wr ite.

Norma l wri tes only wri te to an element in the real-t ime data ba se if the new vais different from the exist ing value. In t his w a y, system resources a re not usedunnecessarily .

Forced wri tes writ e to a n elemen t w hether or not it ha s chan ged. Use this t ypewrite i f you wa n t t o set the cha nge-stat us f lag even i f the da ta has not cha ngeRefer to Reading Da ta from the Real-t ime Da ta base on pa ge 15for a discussion the chan ge-sta tus flag .

Collect ed f rom a rem ot e

device

C om pu ted by a

Fa ctoryLink tas k

Ma n ua ll y en t er ed b y auser

CBAR =ck

------

External

Device


15/254

OVERVIEW

Reading Data from the Real-time Databas


READINGDATAFROMTHEREAL-TIMEDATABASE

A tas k gets the va lue of a n element in th e real-t ime da ta base using a r ead

opera tion. Once the ta sk ha s th is value, it can perform functions on it , such a sdisplayin g on a grap hica l user-interface, tra nsmitt ing to an externa l device, orsending i t t o a relat ional da ta base for a rchiving.

Read opera tions ca n be tr iggered by a n even t (such a s when a produ ct pa sses a nelectron ic eye) or ca n occur only if the da ta element cha n ges. A read opera tiontha t occurs only when t he da ta ch a nges is referred to as exception processing.B eca use large blocks of da ta can be tra nsferred between ta sks, an d beca use onlyth e chan ged va lues a re processed, exception processing s ignifica n tly optimizesperformance.

Exception processing is possible beca use of th e stru cture of the Fa ctoryLink

real -t ime da ta ba se elemen ts. A rea l-t ime da ta base element cons ists of a numberof bits, one or more of wh ich conta in th e element s va lue. Thirt y-on e of th ese bitsa re reserved to function as chan ge-sta tus flags. Ea ch F a ctoryLink ta sk is assignedone of these bits w hich it uses to determin e the elements ch a nge stat us.

The ch a nge-sta tus fla g is either set t o 1 (ON) or 0(OFF ). One (1) indica tes t o thetask t he value of the element ha s changed s ince the las t t ime the t a sk read theelement. Zero (0) indica tes t o the t a sk th e value of the element h a s n ot cha nged.When a n element in the da ta base is wri t ten, a l l the bi ts are a utomat ica l ly set byFactoryLink.


16/254

OVERVIEW

FactoryLink Modules


FACTORYL INKMODULES

Fa ctoryLink is comprised of modu les with un iqu e functions .

General Modules

Application EditorDra ws a nd a nimat es graphica l user-interfa ces to theFa ctoryLink a pplication. These interfa ces ca n be designed to monitor d a ta ith e real-t ime da ta ba se, or they can be designed to permit opera tors to writ eda ta to the real-t ime data base.

Device InterfaceCommun ica tes bi-directiona lly between t he rea l-timeda ta base a nd one or more externa l devices, such as progra mma ble logiccont rollers (P L Cs) an d remote t ermina l units (RTU s). This is n ecessa ry forcollecting an d storing device da ta in th e real-t ime da ta base or for sen din g daba ck t o th e extern a l device.

RecipeStores recipes on disk for ma nufa cturing a product. These recipes cbe sent t o a n extern a l device a t a given t ime to cont rol the productmanufactured.

Modules for Accessing Stored Data

Math and LogicP erforms ma th on da ta collected in th e real-t ime data baThe results can b e used for writ in g new da ta elements, inclusion in r eports, triggering event s.

Report GeneratorG enerat es reports using da ta from the rea l-t imeda ta base. These report s ca n be archived t o disk or sent t o a printer.

Modules for Logging and Retrieving Data

Database LoggerCopies da ta from the memory-based real-t ime da ta basehistorica l disk-ba sed relat iona l da ta bases.

TrendingDisplay s rea l-t ime or historical da ta on trend cha rts.

Statistical Process ControlDispla ys rea l-t ime or historica l da ta onstat is t ical cha rts .

Database BrowserRetrieves, upda tes, deletes, an d insert s dat a int o anexis t ing dat aba se.

Distributed Alarm LoggerC hecks rea l-t ime da ta for permitt ed limits,

generat es ala rms if limits a re exceeded, an d copies the ala rms t o h istorica ldisk-based rela t iona l da tab a se.

HistorianActs a s a conduit for informat ion betw een F actoryLink ta sks t hsend da ta to or retr ieve data from a rela t ional da ta ba se.


17/254

OVERVIEW

FactoryLink Module


Modules for Communicating Across the Network

FactoryLink Local Area NetworkLin ks networked a pplicat ions providingtr a nsfer of rea l-t ime da ta elements from one sta t ion to th e next .

File ManagerMa na ges files on local dr ives or remote servers a nd tr a nsfersfiles from one st a tion t o th e next.

PowerNetSh a res real -t ime da ta between a pplica tions across a netw ork.

Details on h ow to configure each module ca n be foun d in the FactoryLinkConf igurat ion Gu id e.


18/254

OVERVIEW

Two Domains


TWODOMAINS

There a re tw o run-time en vironments called doma ins. These a re the SHARE D

doma in and the USE R doma in. Dur ing configura tion, you a ssocia te ta sks, ta bland elements w ith a specific doma in so you can configure a F a ctoryL inkapplication to suit your needs.

You ca n give a group of users independent a ccess to the sam e Fa ctoryLinkrun -time ta sks such a s Gra phics, Mat h a nd L ogic, an d Sta t ist ical P rocessC ont rol. Th is lets users a ccess the sa me data a t the sa me t ime w ith t w odifferent tasks.

You can crea te an a pplication tha t lets multiple users of a single run-timesystem use the ta sks independent ly without the users sha ring da ta ; tha t is ,users can s imulta neously run the sa me tasks , but each users da ta is uniqueFor example, one user ca n employ the St a t ist ica l P rocess Control tas k to

eva lua te the consistency of a n a ssembly sequence while an other uses it toreport a nomalies in a pa ckaging process elsewhere in th e factory.

You ca n set up multiple Fa ctoryLink a pplica tions t o run on one opera tin gsys tem. For exa mple, applicat ions for development , test ing, and pr oduction, al l run on one machine.

Domain Structure

Domain s exist in a paren t/child hierarchy. The following illust ra tes the sha reddoma in is like a pa ren t upon which a child d omain (user) is based.


19/254

OVERVIEW

Two Domain


A SHARE D doma in ha s the followin g cha ra cterist ics:

AccessibilityAll operat ors with in a user doma in can a ccess da ta exist ing ina sha red domain.

Frequent useFrequ ently used items need only be defined once in the sh a reda rea. This cha ra cterist ic elimina tes duplica tion of effort a nd reducesconfigura tion t ime.

Automatic data changesDa ta cha nges are passed immedia tely to a l l userswh o a re accessing the modif ied da ta in a user domain .

Global data processingP rocessing a ctivit ies, such a s computat ions, da taaccessing , a nd d a ta logging, a re performed once an d th en are a vaila ble to allusers a ccessing the sha red a rea .

A U SE R domain ha s the following cha ra cterist ics:

Private copies of dataYou ca n configure a single a pplica tion a nd thenspecify th e n umber of insta nces (copies) of tha t doma in t o be executed a t runtime. Th e number of insta nces a llowed is the n umber of users th a t cansimulta neously intera ct with th e run-time syst em.

Task IndependenceEa ch u ser ha s a ccess to the sam e Fa ctoryLink run -timeta sks such a s G raphics , Ma th a nd Logic, and Sta t is t ica l P rocess C ontrol but isable to run these ta sks ind ependently from the ta sks other users a re runni ng.Users can sha re data to perform dif ferent rea l-t ime tas ks w ithin th e sa meapplication.


20/254

OVERVIEW

Two Domains


Domains for Run-time Tasks

Run-time ta sks ar e associat ed with a doma in. The doma in controls wh ether or

the run-t ime ta sk can sha re da ta a nd w hich t ask uses dat a unique to a user.Choosing the a ppropriate domain for a t a sk in a multi-user applica tion is crit icThe defaults tha t provide the best performa nce for most applica tions a re listedth e followin g t a ble.

Durin g applica tion planni ng, review th ese doma in defa ults to verify compat ibiwith a specific applicat ions n eeds. When a n a pplication ha s specia l requiremenyou ca n run the ta sk in a di fferent domain, except for t he E DI ta sk which mustrun in the sha red doma in.

In a ddit ion to these doma in defaults , the Ma in Menu ha s a domain selectionfea ture you must set before configuring ea ch t a sk. If th e doma in chosen duri ngconfigura tion does not ma tch th e default set for the domain a t run t ime, th eapplication w ill not run a s intended. You must con figure tr ending in t he userdoma in if it is going t o run in th e user domain.

Table 1-1 Optimal Domain Selection

Task Shared Domain User Domains

Timer G ra phics Run Ma na ger

G ra phics File Ma na ger Ma t h & Logic

B a tch Recipe Trend ing Coun ter

File Ma na ger Server B row ser P ersistence

Extern a l DeviceInterface

SP C View RTMON

LAN SP R DALOG

Historian

Logger

SPC Logger

Print Spooler


21/254

OVERVIEW

Multiple-user Environmen


MULTIPLE-USERENVIRONMENTS

The U NIX opera tin g syst em supports m ulti ple users. You can configure use by

multiple users in on e of tw o w a ys: Multiple users ca n sh a re the sa me application

Multiple users can a ccess sepa ra te applica tions.

Fa ctoryL inks pla tform independence lets you crea te a pplica tions on single-usercomput er systems , such a s Wind ows a nd O S/2, a nd port th em to run on mult i-usersystems.

Multiple Shared Applications

In a multi-user a pplication ea ch user executes in their own user domain; ea ch

user domain ha s i t s own copy of user da ta but sha res data from t he shareddomain.

Multiple Separate Applications

In a multi-user applica tion, each a pplica tion ha s its ow n rea l-t ime da tab a se a nddoes not sha re dat a between them.


22/254

OVERVIEW

FactoryLink Directory Organization


FACTORYL INKDIRECTORY ORGANIZATION

All Fa ctoryLi nk files a re organ ized into tw o main directories.

Fa ctoryLi nk a pplication directoryConta ins a ll Fa ctoryLink a pplica tion fil

Fa ctoryLi nk system directoryConta ins a ll Fa ctoryLink program files.

TFactoryLink Application Directory Subdirectories

The Fa ctoryL in k applica ti on directory cont a ins F a ctoryL ink applica tion files. Tdefault na me of th is directory d epends on your operat ing syst em pla tform.

On UNIX platforms, th e defau lt d irectory is /us r/fla pp.

On all other platforms, the default directory is \ FLAP P .

The applicati on files ar e orga nized int o the follow ing subd irectories. Anysubdirectories foun d in th e ap plicat ion directory not listed h ere a re reserved fofuture us e.

ASC ASC II configura tion dat a ba se files tha t store informa tion abouth e elemen ts. The files in this sub directory conta in a .a scextens ion. They a re used to import/export configur a tion da ta frone applica tion directory to a nother, typica lly from one plat forma nother during multi-pla tform s a ves a n d restores.

CT B ina ry files produced a t run t ime conta ining n on-domain specida ta extra cted from t he da ta base ta bles. The files in th issubdirectory cont a in a .ct extensi on. Domai n-specific ct files exin th e F a ctoryLink domain subdirectory.

DCT Commu nicat ion s upport ta bles. The files in th is subdir ectorycont a in a .dct extension.

NET Loca l a nd group files used by the F a ctoryLink Loca l AreaNetworkin g ta sk to determine commun ica tion para meters an dremote node logica l g roupings.

RPT Report G enera tor forma t files tha t d efine the forma t for reportThe files in th is subdirectory conta in a .fmt extension.

SHARED Files specific to the sha red domain.

USER Files specific to the user doma in.


23/254

OVERVIEW

FactoryLink Directory Organizatio


FactoryLink Application Directory Files

The application d irectory a lso conta ins t he followin g files.

FLAPP.ID Applicat ion i dentificat ion file.

*.cdb Configurat ion dat aba se fi les tha t s tore informa t ion aboutelements, such a s n a me, type, number of wr ites specified by th edefining t a sk, and nu mber of references.

*.mdx Index files used by the Ma in Menu in conjunction w ith the .cdbfiles.

*.cnp Main Men u cut a nd pa ste work files.

*.exp Mai n Menu impor t /export out put files.

FactoryLink System Directory SubdirectoriesThe FactoryLink system directory contains all FactoryLink program files. Thedefault na me of this directory depends on y our operat ing syst em.

On Windows NT platforms, th e defau lt directory is \F L NT.

On Windows 95 platforms, the default directory is \ FLWIN.

On OS/2 platforms, the defa ult directory is \FL OS2.

On UNIX platforms, th e defa ul t di rectory is /usr/flink .

The program files in this directory a re orga nized un der the followingsubdirectories.

AC Text files th a t function a s a t t ribute ca tal ogs to inform the Ma inMen u of th e forma t of the con figura tion ta bles. Th ey a lso controlentry criteria.

BLANK Files used by Fa ctoryLink utilit ies tha t ma na ge applica tion s, sucha s flnew, flsave, flrest, and flconv.

BIN Comma nd script files a nd executa ble program files for eachFa ctoryL ink ta sk.

CML Default ma ke file for C ompiled Ma th a nd Logic ta sk.

CTGEN Configura tion da ta ba se conversion s cript files.

DRW Syst em files used by t he Gr ap hics ta sk a nd by t he ApplicationEditor.

EDI Subdir ectory for Ext erna l Device In terfa ce protocol modules.


24/254

OVERVIEW

FactoryLink Directory Organization


INC C-langua ge include files for option s such a s Compiled Ma th a n

Logic a nd th e P rogra mmers Access Kit .

KEY Text files used by th e Main Menu to tra nsla te text ta ble ent rie

into binary va lues to be pla ced in con figura tion ta bles.

LIB Libra ry files a nd objects.

MPS Demo application , new a pplication, and test a pplication files.

MSG Help files used w ith the Main Menu and Applica tion E ditor a nerror m essage files for F a ctoryLink ta sks.

OPT Files needed t o con trol the F a ctoryLink options a vaila ble withyour applicat ion.

SRC E xtern a l Device In terfa ce P rogra mmer 's Access Kit C -source filibra ries, and sa mple protocol module a nd sa mple P rogrammer

Access Kit sour ce an d m a kefiles.

Windows NT and Windows 95 Platforms

The Wind ows NT a nd Wind ows 95 plat forms cont a in t he following sub directorunder t he a pplication d irectory.

BIN Fa ctoryLink comma nd files (.ba t extension) a nd executa bleprogra m files for each Fa ctoryLin k ta sk (.exe extension) a nddyn a mic link libr a ry files (.dll extens ion).

LIB Object, im a ge libra ry , an d object libra ry files (.obj extensi on ).

OS/2 PlatformThe OS/2 plat form cont a ins t he following su bdirectories und er th e a pplica tiondirectory.

BIN Fa ctoryLink command files (.cmd extensi on) a nd executa bleprogra m files for ea ch Fa ctoryLin k ta sk (.exe extension).

INSTALL Files used during Fa ctoryLi nk installa t ion.

LIB Object files (.obj exten sion ), libr a ry files (.lib exten sion) a nddy na mic link libra ry files (.dll exten sion).


25/254

OVERVIEW

FactoryLink Directory Organizatio


UNIX Platforms

The U NIX pla tform con tai ns th e followin g subdirectories und er th e a pplica tion

directory.BIN Fa ctoryLink comma nd files a n d executable progra m files. Some

protocol mod ule executa ble files ha ve a n .exe extens ion.

LIB Object (.o exten sion) a nd libr a ry (.a extension ) files.


26/254

OVERVIEW

Environment Variables


ENVIRONMENT VARIABLES

B eca use multiple copies of Fa ctoryLink can be runni ng concurrently, th e syst e

uniquely identifies an applica tion by a combina tion of its a pplica tion na me,doma in na me and us er na me. These na mes a re defined a s environment va riablYou can set th ese environment var iab les either in a system con figura tion file sth ey a re aut oma tica lly supplied w hen you sta rt th e a pplica tion or at the systeprompt before sta rt ing the a pplication. The environ men t va riables you can set listed in th e follow ing ta ble.

Wh en using environment varia bles in pa th n a mes, you ca n enter th e n a me of tenvironment va ria ble surrounded by bra ces { } an d F a ctoryLink extends thepathn a me using the default set t ing.

Table 1-2 Environmental Variables

Variable Description

FLINK = fl i nk_d i r Where f l i nk_d i r defines th e full pat h,

including t he dr ive na me, of the directoryconta ining the F a ctoryLink progra m files.

FLAP P = f lapp_d ir Where f lapp_dir defines the full pa th,including t he dr ive na me, of the directorycont a inin g your a pplica tion files.

FLD OMAIN = domain Where domaindefines th e doma in you ar esta rt ing. This ca n either be sha red or user.

On sing le-user plat forms,domai nshould beuser. This st a rts both domains. On multi-userplatforms,domai nis the doma in you wan t

sta rted in the wind ow. You must specify tw owind ows, one for ea ch domain .

FLNAME = app_nam e Whereapp_n amedefines th e na me of theapplica tion t o sta rt , whi ch points to areal-t ime d ata base.

FLU S E R = user _name Where user_namedefines th e logical username.

FLOPT = opt_dir Whereopt _di rdefines the full path , includingth e drive na me, of th e directory conta ining th eFactoryLinks license information.


27/254

OVERVIEW

Using Format Specifie


USING FORMATSPECIFIERS

Forma t specifiers a llow y ou to define th e forma t for a ll or par t of an output string

The following F a ctoryLink ta sks support the us e of forma t specifiers: File Ma na ger

B a tch R ecipe

Report Generator

Alarm Supervisor

Forma t specifiers permit y ou to define a var iable w hen a literal is expected.Va ria ble specifiers can con sist of two t ypes of objects.

Ordina ry char a cters, wh ich a re copied litera lly to the output st ream

Forma t specifiers, wh ich ind ica te the forma t in wh ich var iab le informa tion wil

be displayed

Forma t specifiers use the follow ing form :

% [flags][width][.prec]type

where

% Alwa ys precedes a form a t specifier.

flags Cont rols the format of th e outpu t. This can b e one of the follow ing

- Left-justifies w ithin t he field. If you do not specify

th is fla g, the field is righ t-justified .

0 Fil ls the spa ces to the left of the value with zeros

until it rea ches the specified wid th.

width Specifies minimu m field wi dt h, in decima l. Th is field is not va lidfor floating point nota t ions. Floa ting point fields a re alw a yspadded wit h spaces.

.prec Cont rols the precision of the n umeric field. Wha t pr ecision definesdepends on th e forma t type specified by th etypevar iab le.

For exponent ia l (type e) or float ing point (type f) nota tions, specifythe number of digits t o be printed a fter the d ecima l point .

For short version of exponentia l or floa tin g point nota t ions (typeg), specify th e ma ximum n umber of significan t digits .

For a ll oth er t ypes, specify th eminimum n umber of digits t o printLeading 0s ar e add ed to make up the necessary w idth.


28/254

OVERVIEW

Using Format Specifiers


type Specifies th e cha ra cter or numeric type for th e va lue. This can

one of th e follow in g.

d = decimal

s = s t ring

ld = long decima l

e = exponentia l nota tion of th e following form

[-]m.nnnnnnE[+-]xx

f = floa ting -point n ota tion of th e following form

[-]mmmm.nnnnnn

g= use shorter of e or f

u = unsigned decimal

o = unsigned octa l

x = unsigned hexadecima l using a - f

X = unsigned h exa decima l using A - F

Exa mples of val id forma t specifiers for ea ch Fa ctoryLink d a ta ty pe are displa yin t he followin g ta ble. For a ddit iona l informa tion a bout forma t specifiers, see aANSI-C reference manual.


29/254

OVERVIEW

Using Format Specifie


Table 1-3 :Format Specifiers

Type ofElement

DefaultType

ValidTypes

DescriptionSampleOutput

Ana log d d, u , o,x, X

For exa mple, %04d specifies aright -justified decima l va luewith a minimum field width of4 digits . The 0 specifies t hevalue is padded with zeros.

0005001501502400

For exa mple, %3uspecifies aright -justified un signed

decima l value with aminimum field wid th of 3digits . Th e valu e is padd edwit h spaces.

515

1502400

For exa mple, %-3u specifiesthe sa me as t he exa mplea bove, except th e hyp hen (-)before th e wid th specifies th eva lue is left-just ified.

5151502400

LongAnalog

ld d, ld , u ,o, x, X

For exa mpl e, %-7ld specifies aleft-justified long decimal

value with a minimum fieldwidth of7 digit s. Th e value ispadded to the right withspaces.

515

2400200001000000

For exa mple, %05ld specifiesa right-justified long decima lvalue with a minimum fieldw idt h of 5. A 0 before th ewidt h specifies the va lue ispadd ed with zeros.

00005000150240020000

1000000


30/254

OVERVIEW

Using Format Specifiers


Float ing-point

f e, f , g F or exa mple, %6.2f specifies aright -justified floa tin g-pointva lue wi th a minimum to ta lfield width of6digits. (Thedecima l point count s a s 1digit .) This m eans tw o digitsar e displa yed af ter thedecimal point a nd a t leas tthr ee digits ar e displa yedbefore t he decima l point . The

value is padded with s paces.

5.51150.08

24000.65

Messa ge s s F or exa mple, %5s specifies aright-justified messa ge str ingwith a minimum field width of5char a cters. The val ue ispadd ed with spa ces.

onoff

a l a r m

F or exa mple, %-5s is t he sa meas th e exa mple a bove, exceptthe hyphen(-) befor e th ewid th specifies t he value isleft-justified.

onof fa l a r m

Table 1-3 :Format Specifiers

Type of

Element

Default

Type

Valid

TypesDescription

Sample

Output


31/254


Chapter 2

Wor k i n g w i t h T a g s i n

Con f i g u r a t i on M a n a g er

Ea ch dat a s tored in the real-t ime data base is a n element . Ea ch element is a ss igned alogica l na me in Fa ctoryLink ca lled a ta g. This t a g na me is used to reference th eelement in th e real-t ime da ta base.

Once a n element is d efined, you ca n m a ke un limited references to this element. AnyFa ctoryLink ta sks conta ining a reference to an element ca n rea d a nd write da ta toand from the element a t run t ime.

Durin g development, Fa ctoryLink stores ta g na mes in the FLAPP directory in th eobject da ta base ta ble. This informa tion is updated to the .ct f iles wh en th e run-timeapplica tion i s sta rted.

This chap ter describes how t o define ta g na mes for d a ta base elemen ts a nd providessome suggestions on h ow to use ta gs in your a pplica tion.

pump1_tmp

(Logically representsan element in database)

Realtime database

Elements

Tag Names

pump2_tmp

pump3_tmp


32/254

WORKING WITH TAGS IN CONFIGURATION MANAGER

Defining Tags


DEFININGTAGS

Ea ch element stored in the real-t ime dat a base must be as signed a logical na m

called a ta g na me. This ta g na me is used to logica lly reference a n element in threal-t ime dat a base. Some ta gs a re a lread y d efined in Fa ctoryLink w hen i t is s hippOthers a re defined durin g applica tion development eith er within th e ConfiguratMan a ger or the Applica tion Ed itor.

Defining Tags While in the Configuration Manager

Wh en using t he C onfigurat ion Man a ger durin g a pplicat ion development, some fierequire the na me of a tag . I f you enter the na me of a t a g not a lready d efined in applica tion, t he following Ta g Definition dia log box is displayed .

If you specified multiple ta gs on a configura tion pan el, this pa nel will display eata g name in turn unt i l a l l t ags are defined.

C omplete th e follow ing informa tion for each ta g.

Tag Name This field displays t he na me of th e ta g you a re defining. Ta g na mcan be up to 32 a lph a numeric cha ra cters with no embedded spaor periods . Do not s ta rt t he na me with a number.

Description En ter a description of up t o 79 cha ra cters tha t defines the purpof the ta g .

Name assigned

to tag


33/254

WORKING WITH TAGS IN CONFIGURATION MANAGE

Defining Tag


Type En ter the t ype of dat a tha t wi ll be stored in t his ta g. Th is ca n be oneof the following, alth ough you ma y be restricted t o a subset of th esedepending on w h ere the ta g is specified. Refer to the a ppropriate

FactoryL ink Conf igur at ion Gu idefor valid da ta types for specificfields.

d ig it a l D igi t a l i s a b ina ry da t a t y pe. I t s va lu e can b e 0 or1.

an alog Ana log is a 16-bit , s igned integer. I t s va lue ca nra nge betw een plus or minu s 32,768.

longan a Lon g a na log is a 16-bit , s igned integer. I t s valuecan ra nge betw een plus or minus 2 billion.

f loat Float ing-point is an IEE E double precisionnumber w ith 31 places to the right of th e decima

message A message can be an y combina t ion o fal phan umeric ch a ra cters. Its length is controlledby its ta g definit ion.

mai lbox Variab le length da t a organ ized as a queue.

Domain Choose the domain wh ere thi s ta g should be crea ted. This can beone of th e follow in g:

S HARE D Choos e S HARE D i f y ou w an t t he t ag t o be

a vailable from the sh a red or user en viron men t.

U S E R Choos e U S E R i f y ou w a n t t he t ag t o be av a i l able

only fr om the user environment.

Array Dimension If th is ta g will be used to reference an a rra y, enter the num ber ofelements t o include in the a rra y . I f you a re not d efining a n a rra yleave thi s field bla n k. Do not enter a 0 in th is field a s th is ca useserrors . Refer to Definin g Element Arra ys on page 35 for deta ilson defining a rra ys.

Length This field defin es the ma ximum length for m essage ta gs. If you donot specify a length, it is calculated by F a ctoryL ink.

Default Value This field defin es th e va lue writ t en to th e ta g wh en Fa ctoryLink iss t ar ted .


34/254


Defining Tags


The rema inin g fields on the Ta g Definit ion dialog box are used for defining ta gpersist ence. With ta g persist ence a ctiva ted, th e va lue of th e ta g is period ica lly sato a disk fi le. I f a value exis ts in t his fi le for a ta g , it is w ri t ten to the ta g when

ta sk is sta rted if the -r flag is set for FLRU N. In t his wa y, you do not lose importinforma tion by exit ing th e ta sk.

Use DomainSettings

Ch oose this option if you w a nt to use persistent sett ings definedth e doma in. If you w a nt to define ta g-specific persist ence, deselth is option (box does not cont a in an x). Then s et th e follow ingpersistent options for this t a g.

Saving Contr ols how often the elements va lue is sa ved to a disk file. Tcan be on e or both of the followin g. If you choose both options, elements va lue is sa ved based on a t ime trigger an d when itchanges.

On TimeC hoose thi s option if you wa nt t he ta g value saved ba

on a t ime t rigger.

On ExceptionCh oose this option if you wa nt t he ta g value savethe ta g va lue cha nges.

Restoring Controls wheth er the elements cha n ge stat us flag is set to on orwh en restoring the sa ved value t o the element. This can be onth e followin g.

Set Change Status OnThe element s cha nge sta tus fla g is set towh en restoring the saved va lue.

Set Change Status OffThe element s cha n ge stat us fla g is set t owh en restorin g the sa ved va lue. Us e this option to prevent

a ctivation of digita l tr iggers on resta rt .

Defining Tags While in the Application Editor

You ca n al so define a ta g na me while developin g th e application with in th eApplication Edi tor. The sa me informa tion is in cluded in th e dialog a s well asma ny ad dit iona l items configured in the various Con figura tion Mana ger t a sksRefer to th e Applicat ion E dit or manu a l for deta ils .


35/254


Defining Element Array


DEFINING ELEMENTARRAYS

A ta g na me can be a ssigned t o a sin gle element or a group of elements (sometimes

ca lled a n a rra y). Th is permit s you to create multiple ta gs w ith a single opera tion. Althe ta gs receive the sa me ta g definit ion.

You specify an ar ra y by entering a value in th e Array Dimensionsfield of the Ta gDefinition dia log box. This va lue defines t he nu mber of elemen ts in cluded in th ea r ray .

If you specify a val ue in th e Array Dimensionsfield, mul tiple elements a re crea ted inthe r eal-t ime da ta base. Once crea ted, each element ca n be referenced individua llyThe val ue you specify in t he Array Dimensionsf ield d epends on w heth er you a redefining a single-dimension a l or multi-dimensiona l a rra y.

Specifies thenumber of elementsin the array


36/254


Defining Element Arrays


Defining One-dimensional Arrays

For on e-dimensiona l a rra ys, specify a single number in t he Array Dimensionsfie

One-dimension a l arr a y na mes ta ke th e form

tagname[n]

where

tagname is the na me defined in th e Tagnamefield of the Ta g D efinitiondia log box.

[n] is a uniq ue number ass igned to ea ch element in the a rra y s ta rtwit h 0. Each n umber is surrounded with bra ckets [ ].

For exampl e, if you specify 3 in th e Array Dimensionsf ield for a ta g na med temp, following three elements a re creat ed in t he real-t ime da ta bas e.

temp[0]temp[1]temp[2]

The a rra y n umbering sta rts countin g a t 0 . If you specify 4, you r eceive 5 eleme0, 1, 2, 3, 4. Therefore, you must s pecify a n umber less th a n t he a ctua l number ywould like to define.

Defining Multi-dimensional Arrays

For multi-dimension a l arr a ys, specify multiple numbers sepa ra ted by a comma

the Array Dimensionsf ield. Multi-dimensiona l ar ra y na mes t a ke th e form

tagname[n,1][n,2]...

where

tagname is the na me defined in th e Tagnamefield of the Ta g D efinitiondia log box.

[n,1] is a uniqu e number representing th e first dimension in the a rrass igned to each element sta rt ing w ith 0. Ea ch number issurroun ded by bra ckets [ ].

[n,2] is a u nique number representin g the second dimension in th e a r

ass igned to each element sta rt ing w ith 0. Ea ch number issurroun ded by bra ckets [ ].


37/254


Defining Element Array


For exam ple, if you s pecify 3,2 in t he Array Dimensionsf ield for a ta g na med msg_ta gthe following six elements a re created in th e real-t ime da ta base.

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 a rra y num bering st a rt s count ing a t 0 . If y ou specify 4, you receive 5 elements0, 1, 2, 3, 4. Therefore, you must specify a num ber one less tha n t he a ctua l n umberyou would like t o define.

Maximum Number of Arrays

This section d escribes the la rgest number of elements tha t ca n be creat ed for ea cha rra y. This depends on the platform a n d on the elements dat a type.

For Windows NT, OS/2, and UNIX

Ea ch ar ra y can h a ve up to 65,535 elements.

For Windows 95

An a rra y ca n ha ve as ma ny elements a s will f it into a 65,535-byte memory segmentThis nu mber depends on t he element s da ta type. The followin g ta ble lists th e

maximum number of elements permit ted in a n a rray for ea ch da ta type.

Table 2-1 Table 2-1: Windows Array Maximums

Data Type Maximum Elements

Digit a l 4,095

Ana log 3,640

Long a n a log 3,276

Floa t in g-point 2,730

Mes sa ge 2,730 + st ora ge ofda t a

Mailbox


38/254


Using Tags as Triggers


USING TAGSASTRIGGERS

Ma ny Fa ctoryL ink ta sks use tags t o trigger a ctions. The exam ples below a re ju

few of the possibilities: You can use the complete sta tus ta g in a logger opera tion to init ia te a di ffer

loggin g opera tion.

You ca n u se the sa me ta g to trigger multiple opera tions. F or exam ple, you cdefine a single tag th a t triggers multiple opera tion s a t th e st a rt of each hou

Triggering can be ba sed on th e fa ct tha t a n elements val ue ha s ch a nged.

Triggering can be based on a combina tion of the trigger elements val ue and valu e of its chan ge-sta tus fla g. For example, if you a re using a digita l elementrigger a n a ction, its cha nge-sta tus flag must be 1 (ON) a nd its value must b(ON) for t he opera tion t o be tr iggered.

You can defin e triggers using the Int erval a nd E vent t imer module. You can configure function keys a s triggers.

You can use the Ma th a nd Logic ta sk to set tri ggers of a ny da ta type, exceptmai lbox, to s tart a n operat ion.


39/254


Predefined Elemen


PREDEFINEDELEMENTS

See the current F a ctoryLink Relea se Notes for a complete list ing of the Fa ctoryLink

pre-defined elements.


40/254


Predefined Elements



41/254


Chapter 3

U si n g t h e Con f i g u r a t i on

M a n a g e r

The Configura tion Ma na ger is the us er interfa ce to the development en vironment.You ca n use the C on figura tion Man a ger to perform t he following a ctions:

Designa te how ta sks and elements are used a t run t ime

Specify elements to be used by ea ch ta sk at r un t ime

Review a nd modify elements durin g configurat ion

Review a nd modify applica tion d a ta

The development environment is a series of configura tion ta bles; one or m ore ta blesexist for ea ch F a ctoryLin k module. You ent er da ta in th ese configura tion ta blesthr ough pa nels. There a re tw o ty pes of pa nels in Fa ctoryLink.

St ructuredStructured pan els conta in rows a nd columns. Ea ch r ow represents anentry in the ta ble (sometimes called a record ). Ea ch column h a s a h ea ding, a ndrepresent s a field in a r ecord.

Text-ent ryText-ent ry pa nels ha ve an open form in wh ich ASC II text ca n beentered.

This cha pter describes h ow t o open a nd use the C onfigura tion Ma na ger. Th ediscussion in t his cha pter assumes you know how to use a mouse or other point ingdevice to:

P osit ion th e cursor

C hoose an it em

C hoose a ra n ge of text


42/254

USING THE CONFIGURATION MANAGER

Opening the Configuration Manager


OPENING THECONFIGURATION MANAGER

How you open th e Configura tion Ma na ger depends on your opera ting system

pla tform. Once opened, th e Con figura tion Man a ger a cts th e sa me for a ll pla tform

Windows NT or Windows 95 Platform

From the Program Manager

1 Click the Fa ctoryLink icon from th e Pr ogram Ma na ger window to display theFa ctoryLink IV progra m group.

If you ha ve more tha n one Fa ctoryLin k application, you ma y h a ve more tha n oFa ctoryLink IV progra m group. B e sure to open the progra m group for t he desiapplication.

2 Double-click on t he FactoryLink Configurationicon.

From the Command Line

1 Set the Fa ctoryLink ap plica tion environment va ria ble by entering the followincommand a t the system prompt.

Set FLAPP =c:/flapp

2 En ter th e followin g command to open t he Configurat ion Ma na ger.

flcm

Double-click here toopen the Configuration

Manager


43/254

USING THE CONFIGURATION MANAGE

Opening the Configuration Manage


OS/2 Platform

Open the Configura tion Man a ger in one of two wa ys: eith er from th e Desktop

Man a ger or from th e comman d line if you a re running F a ctoryLink on a n OS /2opera ting system. B oth m ethods a re described below.

From the Desktop Manager

1 Choose FactoryLink OS/2from the Desktop Ma na ger menu to displa y th e applicationa vailable with th e Fa ctoryLin k group.

2 Double-click th e left butt on to open th e Configura tion Ma na ger.

From the Command Line

1 Set the F a ctoryLin k applica tion environment va ria ble by entering th e followingcomma nd from the sy stem prompt.

Set FLAPP= c:/flapp

2 En ter the following comma nd to open t he Configura tion Man a ger.

flcm

Double-click here toopen the ConfigurationManager


44/254


Opening the Configuration Manager


UNIX Platform

1 B e sure the Fa ctoryLin k application directory environment varia ble, FLAP P , is

to thefull pa th n a me of the directory conta inin g th e applica tion you are runn ing. is not , set it using t he follow ing inst ructions .

If you are using a C shell, enter th e followin g command a t t he system prom

setenv FLAPP f lapp_dir

whereflapp_diris th e full pa th of the directory conta ining t he a pplica tion. Fexample,

setenv FLAPP /usr/newapp

If you are using a Korn or Bourne shell, enter the follow ing comma nd set a t

system prompt.

FLAPP=flapp_direxport FLAPP

where flapp_diris t he full path of the d irectory conta ining th e applica tion. Fexample,

FLAPP=/usr/newappexport FLAPP

2 En ter th e followin g command a t t he system prompt to open the Configurat ionManager .

flcm


45/254


Configuration Manager Displa


CONFIGURATION MANAGERD ISPLAY

When you open th e C onfigura tion Ma na ger, the following screen is displa yed .

This screen ha s t hr ee ma jor component s:

Menu barThe men u ba r provides a ccess to a group of tools you ca n use t oma nipula te or review application da ta .

Main MenuThe Mai n Menu pr ovides a ccess to configura tion t a bles for eachFa ctoryLin k module inst a lled on y our system . Double-click th e na me to choose amodule. Refer t o Cha pter 1, Overview, for a list of possible modules.

Domain selectionThe doma in selection menu controls whi ch doma in y ou a reopening w hen you choose a module from th e Main Menu. This can either be sha redor user. Th e defau lt is the sa me a s the domai n specified in t he FL DOMAINenvironment varia ble. Refer to Ch a pter 1, Overview, for a dis cussion onFa ctoryLin k environment va riables.

Double-click on t he des ired doma in or be sure to press Entera fter choosing adomain, or th e domain does not chan ge. Refer to Chapter 1, Overview, fordetails on which domain to select for each a pplica tion.

Menu Bar

Main Menu

DomainSelection


46/254


Working with Text-entry Panels


WORKINGWITHTEXT-ENTRYPANELS

Open con figura tion tables by selecting a module from th e Main Menu . Da ta is

entered in configura tion tab les through either structured pa n els or text-entr ypanels. This section di scusses text-entr y pa nels an d their cha ra cterist ics.

Text-entry panels d o not ha ve defined d a ta -entr y fields.

Text-entry configura tion panels conta in th e following a reas :

Menu barTh e menu ba r provides a ccess t o a group of tools y ou ca n us e t oma nipulat e or review con figura tion a nd applica tion d a ta .

Data entryType ASCI I text in th e dat a entry a rea.

Menu Bar

Data Entry


47/254


Working with Structured Configuration Pane


WORKINGWITHSTRUCTUREDCONFIGURATION PANELS

You open configura tion ta bles by choosing a module from th e Ma in Men u. Da ta is

entered in configura tion ta bles through either structured pan els or text-entr ypanels. This section discusses structured panels and their characteristics.

Configura tion tables a re typica lly built using structured panels. Ea ch ta ble ha s on eor more pan els. Ea ch pan el contai ns a n umber of da ta en try fields formatt ed incolumns.

Structured configuration pan els contai n the following a reas:

Menu barThe men u ba r provides a ccess to a group of tools you ca n use t oma nipula te or review configura tion and a pplica tion da ta .

Field namesThis a rea lists the n a mes of fields perta ining to the configura tiontable.

Data entryYou type dat a for each tab le entry in th is ar ea. U se the follow ingkeypad keys to move a round in th e data entr y section.

Press TABto move forwa rd from on e field t o the next . I f the current field is t hela st field in a row , the cursor moves to th e first f ield of th e next row.

Press SHIFT + TAB to move ba ckward from one field to th e next. I f the currentfield is the first f ield in a row, t he cursor moves to the la st field of the previous

row. Use thea n dkeys to move up or down w ithin a column in a pa nel.

You can optiona lly use a m ouse to choose a field.

Menu Bar

Field Names

Data Entry

Command Buttons


48/254


Working with Structured Configuration Panels


There are t wo wa ys t o upda te informa tion entered on thi s panel to theconfigura tion t a ble.

P ress th e ENTERkey on th e keyboard. All line en tries a re upda ted t o th e

configura tion ta ble. Pr ess theTABkey a t the end of ea ch l ine rather tha nENTER if you w a nt t o fill out th e ent ire ta ble before a dding the da ta to th econfigura tion t a ble.

Ch oose th e Entercomman d butt on. All line entr ies a re upda ted t o theconfigura tion t a ble.

Command buttonsB uttons th a t execute comman ds w hen you choose th e

CancelCa ncels any da ta entered tha t ha s not a lread y been updated to configura tion t a ble.

EnterUpda tes t he configura t ion table with a ny da ta entered s ince the lupdate .

ExitR eturns you to the Ma in Menu. If you ha ve not sa ved cha nges,Fa ctoryLink a sks you i f you wa nt t o save or disca rd.

NextDispla ys the n ext pa nel in a sequence of pa nels. I f th e current pandispla yed is th e last pan el in th e sequ ence, the first pa nel is display ed.

PrevDisplay s the previous pa nel in a sequence of pan els. If th e current padispla yed is the first pa nel in th e sequence, the la st pan el is displayed.


49/254


Scrolling a Window or Pan


SCROLLINGAW INDOW OR PANEL

If a window or pa nel conta ins more rows or column s tha n ca n be displa yed in th e

available area, i t conta ins a scroll bar which indicates more da ta is a va i lable forviewing.

A win dow or pa nel can conta in both or either a vertica l a nd horizon tal scroll ba r.

Scroll bars end in small but tons with a rrows, cal led push but tons. Use these but tonsto move the dat a in th e window up a nd d own one line a t a t ime, or left a nd r ight one

column a t a t ime.

A scroll ba r al so conta ins a recta ngle ca lled a slider box. The slider box indi cat es thea rea of da ta to display. You can dra g the slider a nywh ere a long the horizonta l scrolbar .

Vertical Scroll Bar

U se the vertical scroll ba r t o move the win dows contents up and down in tw o w a ys

P oint to th e pushbutton a t either end of th e scroll ba r a nd click the left butt on tomove up or down one line.

P osit ion the pointer a bove or below th e slider box a nd click th e left but ton t o moveup or d own one pa ge.

HorizontalScroll Bar

VerticalScroll Ba

Slider Ba

PushButton


50/254


Scrolling a Window or Panel


This scroll ba r does not reflect t he rela t ive posit ion in a pan el an d its slider borema ins in a fixed posit ion . Do not a t tempt to select th is slider box an d move it wth e mouse. The results a re unpredicta ble.

Horizontal Scroll Bar

U se the horizonta l scroll bar to move the win dows content s to the right or to the in three wa ys :

P oint t o the push b utton a t either end of the scroll ba r a nd click th e left butt onmove to th e left or right on e column a t a t ime.

C hoose the slider box a nd press a nd h old th e left but ton wh ile moving slider bal ong th e vertica l scroll ba r t o scroll horizon tal ly . Relea se th e left button when finish.

P oint to th e left or right of the slider box and click th e left button to jump lef

right .


51/254


Working with Multiple Development Application


WORKINGWITHMULTIPLEDEVELOPMENT APPLICATIONS

You ca n use the C onfigura tion Ma na ger to develop a n y number of applica tions

simulta neously; however, ea ch applica tion requires a uniqu e directory for storingcon figura tion t a bles. F or exa mple, a ssume you a re building t wo a pplicat ions: one focollecting da ta from a sta t ion in the Southern pa rt of tow n a nd a nother for collectingda ta from a s ta t ion in the Northern a rea . Both a pplicat ions a re locat ed on t he C:drive. The path to the Southern development a pplica tion is \sta t ion\ south; th e pa thto the Northern development a pplica tion is \sta t ion \n orth .

The following sections describe how t o open different a pplica tions a nd sh a reinformat ion betw een th em.

Opening a New Development Application

Alth ough you can d evelop multiple F a ctoryL in k applica tions simult a neously , youca n a ctively work on only one at a t ime. When you open th e Configura tion Mana gerthe applica tion located in the default F LAP P directory is active. P erform th efollowing steps to open a developmen t applica tion oth er th a n t he defau lt a pplication

1 Choose Closefrom the Configura tion Man a ger Applica tion pull-down m enu to closethe a ctive a pplication. Only one a pplication can be open a t a t ime.

2 Choose Openfrom t he Applica tion men u. You ar e prompted for th e dir ectorycon tai ning t he applica tion you wish to open.

3 En ter th e full pat hna me of the directory con tai ning the a pplication you wa nt t o open

4 Choose the comma nd button of the opera tion you wa nt to perform.

Enter To open th e ap plica tion. For exampl e, if you wa n t t o open th eSouth ern a pplication, enter C:\sta t ion\south.

Click here if you need help


52/254


Working with Multiple Development Applications


Cancel To return t o the Configurat ion Ma na ger without ch oosing a n

applica tion.

Help To get help.

Sharing Information Between Applications

Often, two a pplica tion s a re simila r. When this is the ca se, you can sa ve developmtime by exporting d a ta base files from one applica tion an d i mporting t hem intoa nother a pplicat ion. This section d escribes how to export a nd i mport ap plica tiodat aba se files.

Exporting an Application

Exportin g con verts a ll da ta base files int o ASCI I t ext files in prepa ra tion for beimported into a nother a pplication. Once files ar e exported, they a re sa ved in t h

FLAPP default directory. Ta bles in the sha red doma in a re saved in theFLAPP /S HARE D d irectory; ta bles in t he user doma in a re saved in the FL AP P /U Sdirectory. E a ch ta ble genera tes its own file; each file na me includes a n .expextension. The .exp files can be edited using a n ASCI I t ext editor; h owever, anedit ing error ca n ca use ca sca ding errors in a Fa ctoryLink a pplica tion , so use cawh en edit ing th ese files.

P erform t he followin g steps to export da ta base files from one applica tion so they be imported to another application.

1 Open th e application you w a nt to export . Refer t o the Opening a N ewDevelopment Applica tion on pa ge 3-51 for detai ls on opening a n a pplica tion.

2 Choose Utilitiesfrom t he Configura tion Man a ger or configura tion pa nel menu ba ryou open it from th e Configurat ion Ma na ger, the en tire ap plica tion is exportedyou open it from a configura tion panel, only tha t pan els informa tion is exporte

The following pulldown menu is d ispla yed.

3 Choose Export from the pulldown menu. The da ta ba se files a re exported.


53/254


Working with Multiple Development Application


Importing an Application

Importing converts ASCI I text files created u sing th e export function to da ta bas e

files in a n ew application . If a file wit h t he sam e na me alread y exists in theapplica tion wh en you import a file, the cont ents of th e import ed file a re placed a t t heend of the exist ing file. Use ca re when doing this a s no merging occurs. Duplica terecord s ma y be insert ed.

P erform th e following steps to import d a ta base files to an a pplica tion.

1 Export t he da ta base files for th e applica tion you wa nt t o import to a n ew applica tionRefer to the E xport ing a n Applica tion on pa ge 3-52 for details on how to do this

2 Open the applica tion where you wa nt to import t he export ed applica tion d a ta . Refeto the Openi ng a New D evelopment Applica tion on pa ge 3-51for details onopening a n a pplica tion.

3 Choose Utilitiesfrom th e Main Menu or configur a tion panel menu ba r. If y ou ch oose ifrom th e Ma in Menu, th e entire a pplication is imported. I f you choose it from acon figura tion pa nel, only tha t pan els information is imported.

The followin g pulld own m enu is d isplayed.

4 Choose Import. The following dia log box is displayed requesting t he n a me of the fileyou w a nt t o import .

5 En ter th e full pa thn a me of th e directory conta ining th e file(s) you wa nt to import


54/254


Opening Multiple Configuration Tables


OPENING MULTIPLECONFIGURATION TABLES

Wh en you a re configur ing a n a pplica tion, sometimes you must fill out configur a t

ta bles for multiple mod ules. F or exam ple, if you a re configurin g logging of da ta frthe real-t ime data base t o a relat iona l dat aba se, you must def ine ta bles in theHistoria n, Schema, and Logger modules.

It can be beneficia l in th ese ca ses to open con figura tion ta bles for multiple mod ua t the sa me t ime. Perform th e follow ing steps t o open multiple configura tion ta b

1 Choose Viewfrom th e Mai n Menu or con figura tion pan el menu bar.

One of the following pulldown menus is display ed.

2 Choose Main Menu. This ma kes the Ma in Menu t he active pa n el.

3 Choose th e module you wa nt to open. This dis play s th e pa nels compris ing th econfigura tion ta ble for th e selected m odule.

View pulldown menufrom Main Menu

View pulldown menufrom configuration


55/254


Working with Tag


WORKINGWITHTAGS

This section d escribes h ow t o man ipula te ta gs defined in the a pplication.

Viewing the Number of Tags Defined

1 Choose Applicationf rom the Main Menu menu ba r.

The followin g pulld own m enu is d isplayed.

2 Choose Sizeto displa y informa tion a bout th e number of ta gs defined in t heFa ctoryL ink a pplicat ion. The following screen is displa yed.

3 Choose OKt o cancel this s creen.

As th e memory used by th e real-tim e da ta ba se becomes less efficien t, t he efficiencypercenta ge drops, indica ting w a sted spa ce. You ca n improve this by ru nning t hefollowing command.

ctgen -r -c

Number of TagsDefined by User

Efficiency of Memory Used by

the Real-time Database

Total Number of Tags


56/254


Working with Tags


Viewing a List of Real-time Database Elements

Wh en a ta g referen cing a rea l-t ime da ta base element is crea ted in t he applica tion

is add ed to an element list . P erform th e following steps to view th e real-t imedat a bas e elemen ts configured for this a pplica tion.

1 Choose Viewfrom th e Mai n Menu ba r or from the configura tion panel menu ba

One of th e following pulldown menus is display ed.

2 Choose Object List. Th e follow ing lis t is di spla yed.

View pulldown menufrom Main Menu

View pulldown menufrom configuration


57/254


Working with Tag


This list conta ins a n entr y for each ta g defined in th e application . Ta gs a re listed inalpha betica l order. Th e list conta ins the following informa tion for each entr y.

Tag Logical na me assigned to reference the rea l-t ime dat a bas e element

Domain Domain in w hich the element is configured. This can be eithershar ed or user.

Type Da ta type of the element. Refer t o Cha pt er 2, Working w ith Ta gsin Configurat ion Mana ger, for a complete list of dat a types.

Description Description of the purpose of the element. You can modify th e entr yin this field.

Task Unused.

Value Sta rt u p val ue for the ta g. You ca n modify th e entry in th is field.

Seg. Segment num ber where element is stored in t he real-t ime dat a baseFa ctoryLink uses the en try in th is field in combina tion wit h t heentry in the Offs.field t o determin e the locat ion of the element .

Offs. Offset number a ssigned t o th e element by Fa ctoryLink.Fa ctoryLink uses the en try in th is field in combina tion wit h t heentry in the Seg.field t o determine th e loca

Monitor Pro Tuto2

Documents

Transcript of Monitor Pro Tuto2