COMOS Administration 1 - Siemens · 2015. 1. 23. · 4.5.7.1 Administration ... 6.1.12.2 @System @D...

� �COMOS Administration

_____________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________________

COMOS

Platform COMOS Administration

Operating Manual

04/2012 A5E03774611-01

Trademarks 1

System Monitor 2

Performance Monitor 3

Database 4

System project 5

Base project 6

Personal Settings 7

Language management (localization)

8

Status management 9

Project properties 10

Working layers 11

Assembly groups / Templates

12

Project directory matching 13

Merging objects 14

Object Debugger 15

External programs in the bin directory

16

Restoring deleted objects 17

Attributes 18

Standard tables 19

Units 20

Numbering ranges 21

Synchronizing base data 22

Default settings for the "Data Aggregation" plugin

23

Legal information

Legal information Warning notice system

This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are graded according to the degree of danger.

DANGER indicates that death or severe personal injury will result if proper precautions are not taken.

WARNING indicates that death or severe personal injury may result if proper precautions are not taken.

CAUTION with a safety alert symbol, indicates that minor personal injury can result if proper precautions are not taken.

CAUTION without a safety alert symbol, indicates that property damage can result if proper precautions are not taken.

NOTICE indicates that an unintended result or situation can occur if the relevant information is not taken into account.

If more than one degree of danger is present, the warning notice representing the highest degree of danger will be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to property damage.

Qualified Personnel The product/system described in this documentation may be operated only by personnel qualified for the specific task in accordance with the relevant documentation, in particular its warning notices and safety instructions. Qualified personnel are those who, based on their training and experience, are capable of identifying risks and avoiding potential hazards when working with these products/systems.

Proper use of Siemens products Note the following:

WARNING Siemens products may only be used for the applications described in the catalog and in the relevant technical documentation. If products and components from other manufacturers are used, these must be recommended or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and maintenance are required to ensure that the products operate safely and without any problems. The permissible ambient conditions must be complied with. The information in the relevant documentation must be observed.

Trademarks All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.

Disclaimer of Liability We have reviewed the contents of this publication to ensure consistency with the hardware and software described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the information in this publication is reviewed regularly and any necessary corrections are included in subsequent editions.

Siemens AG Industry Sector Postfach 48 48 90026 NÜRNBERG GERMANY

A5E03774611-01 Ⓟ 04/2012 Technical data subject to change

Copyright © Siemens AG 2012. All rights reserved

COMOS Administration Operating Manual, 04/2012, A5E03774611-01 3

Table of contents

1 Trademarks ............................................................................................................................................. 15

2 System Monitor........................................................................................................................................ 17

2.1 COMOS system status ................................................................................................................17

2.2 Releasing objects (ReleaseObjects, ReleaseAllObjects) ............................................................18 2.2.1 Matching the cache and main memory........................................................................................18 2.2.2 Conducting an object release ......................................................................................................19

3 Performance Monitor ............................................................................................................................... 21

3.1 User interface reference ..............................................................................................................21

3.2 General COMOS functions ..........................................................................................................22

3.3 Creating objects ...........................................................................................................................23

3.4 Feed .............................................................................................................................................23

3.5 Core functions..............................................................................................................................23

3.6 Object queries..............................................................................................................................25

3.7 Reports.........................................................................................................................................25

3.8 Revisioning...................................................................................................................................25

3.9 P&I ...............................................................................................................................................26

4 Database ................................................................................................................................................. 27

4.1 Import/export of databases ..........................................................................................................27 4.1.1 Synchronized databases..............................................................................................................27 4.1.1.1 Area of application .......................................................................................................................27 4.1.1.2 Preparation: DB identifier.............................................................................................................27 4.1.1.3 Creating the synchronized copy (ExportDB)................................................................................27 4.1.1.4 Command line mode (ExportDB.ini) ............................................................................................29 4.1.1.5 Synchronizing or integrating data (ImportDB.exe).......................................................................30 4.1.2 Import ...........................................................................................................................................30 4.1.3 Export...........................................................................................................................................31 4.1.4 Stand-alone database..................................................................................................................32 4.1.4.1 Initial login to a new database......................................................................................................32 4.1.4.2 Creating a new Access database ................................................................................................32

4.2 Database version adjustment ......................................................................................................33 4.2.1 Updating versions ........................................................................................................................33 4.2.2 Adjust versions.............................................................................................................................33 4.2.2.1 Database version adjustment ......................................................................................................34 4.2.2.2 Adjusting the document version...................................................................................................34 4.2.3 Project utility programs ................................................................................................................34 4.2.4 Status ...........................................................................................................................................34

4.3 Database types/Keycode.exe ......................................................................................................34

Table of contents

COMOS Administration 4 Operating Manual, 04/2012, A5E03774611-01

4.4 Database organization ................................................................................................................ 35 4.4.1 Document directory ..................................................................................................................... 35 4.4.2 Database identifier ...................................................................................................................... 35

4.5 Designing databases (customizing) ............................................................................................ 36 4.5.1 General rules............................................................................................................................... 36 4.5.1.1 Base and engineering objects..................................................................................................... 36 4.5.1.2 Local base objects ...................................................................................................................... 36 4.5.1.3 Tree structure: Hierarchies.......................................................................................................... 37 4.5.1.4 Top level...................................................................................................................................... 37 4.5.1.5 Information transfer: Inheriting & Co ........................................................................................... 38 4.5.1.6 Name check / Allocation of names or labels ............................................................................... 38 4.5.2 Adjusting context menus............................................................................................................. 39 4.5.3 Database adjustment .................................................................................................................. 40 4.5.4 Preallocating connectors............................................................................................................. 42 4.5.4.1 Preparing logical potentials ......................................................................................................... 42 4.5.4.2 Preparing signals ........................................................................................................................ 42 4.5.5 Labeling systems ........................................................................................................................ 43 4.5.6 Alias for labels............................................................................................................................. 45 4.5.6.1 Objective ..................................................................................................................................... 45 4.5.6.2 Application................................................................................................................................... 45 4.5.6.3 Effect ........................................................................................................................................... 47 4.5.6.4 "AliasLabel" script commands..................................................................................................... 47 4.5.7 Categories................................................................................................................................... 47 4.5.7.1 Administration ............................................................................................................................. 48 4.5.7.2 Application examples P&ID......................................................................................................... 48 4.5.8 New document: Report template ................................................................................................ 49 4.5.8.1 Overview ..................................................................................................................................... 49 4.5.8.2 Creating a new "Report template" type document...................................................................... 50 4.5.9 Creating prepared reports ........................................................................................................... 51 4.5.9.1 Create a report ............................................................................................................................ 51 4.5.9.2 Documents under the base object of the document group ......................................................... 52 4.5.10 Drawing types ............................................................................................................................. 52 4.5.11 Base objects via Symbol Bar ...................................................................................................... 53 4.5.11.1 Definition of Symbol bar .............................................................................................................. 53 4.5.11.2 Storage of contents ..................................................................................................................... 53 4.5.11.3 Creating a symbol bar ................................................................................................................. 53 4.5.11.4 Using the symbol bar in a report ................................................................................................. 54 4.5.11.5 Translation/localization................................................................................................................ 55 4.5.11.6 Symbol bar for Viper ................................................................................................................... 55

4.6 Database utility programs ........................................................................................................... 55

4.7 Project utility programs................................................................................................................ 57

4.8 Database performance................................................................................................................ 57

5 System project ......................................................................................................................................... 59

5.1 Copying the system project......................................................................................................... 59

5.2 Base objects................................................................................................................................ 60 5.2.1 @LocalInstance .......................................................................................................................... 60 5.2.1.1 @System > @D > @GRAFICS Attribute definition for graphical elements................................ 60 5.2.1.2 @System > @D > @Layer working areas.................................................................................. 60 5.2.1.3 @System > @D > @Revision Revision...................................................................................... 60

Table of contents


5.2.1.4 @System > @D > @Status Status..............................................................................................60 5.2.1.5 @System > @O User interface ...................................................................................................60 5.2.1.6 @System > @O > @Bulkprocessing Bulk processing................................................................60 5.2.1.7 @System > @O > @Print Print ...................................................................................................60 5.2.1.8 @System > @Tree views in the Navigator..................................................................................60

5.3 Standard tables............................................................................................................................61 5.3.1 Generally applicable information..................................................................................................61 5.3.2 @ConnectionTypeE (EE/I&C) .....................................................................................................62 5.3.3 @ConnectionTypeF (Function elements) ....................................................................................62 5.3.4 @ConnectionTypeI (Single line) ..................................................................................................63 5.3.5 @ConnectionTypeR (P&ID).........................................................................................................63 5.3.6 @ConnectionTypeS (Signals) .....................................................................................................63 5.3.6.1 @ConnectionPossibleS ...............................................................................................................64 5.3.7 @PROPAR / Tables for project parameters................................................................................64 5.3.7.1 @PROPAR > ELO_DOCSORT/Combobox contents..................................................................64 5.3.7.2 @PROPAR > ELO_OUTPUT/Combobox contents .....................................................................65 5.3.7.3 @PROPAR > ELO_PATH/Path/Zone output...............................................................................65 5.3.8 @SYSTEM / System tables .........................................................................................................66 5.3.8.1 @SYSTEM > @BridgeType/Bridge types ...................................................................................66 5.3.8.2 @SYSTEM > @DRW_TYPE/Drawing type.................................................................................66 5.3.8.3 @SYSTEM > @ELO_KSP/Contact mirror...................................................................................67 5.3.8.4 @SYSTEM > @LCID/Country settings .......................................................................................67 5.3.8.5 @SYSTEM > @ProdReqShow/Request/Product data ...............................................................68 5.3.8.6 @SYSTEM > @RGB_COLOR/RGB colors.................................................................................68 5.3.8.7 @SYSTEM > @WireColor/Wire colors........................................................................................69 5.3.8.8 @SYSTEM > @WireCrossSection/Wire cross sections .............................................................69 5.3.8.9 @SYSTEM > @WireCrossSectionAWG/American National Standard.......................................69 5.3.8.10 @SYSTEM > @WireEndHandling...............................................................................................69 5.3.8.11 @SYSTEM > @WireTypeInfo/Type information for wires...........................................................70 5.3.8.12 @SYSTEM > DDM > CheckInKind..............................................................................................70 5.3.8.13 @SYSTEM > DDM > CheckOutFolder........................................................................................70 5.3.9 BOOLEAN / Yes/No.....................................................................................................................70

6 Base project............................................................................................................................................. 71

6.1 Base objects.................................................................................................................................71 6.1.1 @01Material.................................................................................................................................71 6.1.2 @02 General objects ...................................................................................................................71 6.1.3 @03 Structures ............................................................................................................................71 6.1.4 @10 @Y Attributes catalog .........................................................................................................71 6.1.5 @1PE Process Engineering ........................................................................................................71 6.1.6 @J Project ...................................................................................................................................72 6.1.7 @L Locations ...............................................................................................................................72 6.1.8 @MotionX ....................................................................................................................................72 6.1.9 @O Documents ...........................................................................................................................72 6.1.9.1 @O > EE > PED Design diagram................................................................................................72 6.1.10 @P Position .................................................................................................................................73 6.1.11 @Q Actions: Decision tables and object queries.........................................................................73 6.1.11.1 @Q Actions > SC Script ..............................................................................................................73 6.1.12 @System System settings...........................................................................................................73 6.1.12.1 @System @LocalInstance ..........................................................................................................73 6.1.12.2 @System @D Data @Aveva_User PDMS-Popup ......................................................................73 6.1.12.3 @System @D Data @ClassificationKeys Classification keys.....................................................73

Table of contents


6.1.12.4 @System @D Data @DocumentTypeMapping Data................................................................. 73 6.1.12.5 @System @D Data @eSBatch ESign Batch ............................................................................. 74 6.1.12.6 @System @D Data @GRAFICS Attribute definition for graphical elements ............................. 74 6.1.12.7 @System @D Data @Layer Working areas............................................................................... 74 6.1.12.8 @System @D Data @Linkobjects Link objects.......................................................................... 74 6.1.12.9 @System @D Data @Revision Revision ................................................................................... 74 6.1.12.10 @System @D Data @Status................................................................................................. 74 6.1.12.11 @System @D Data @WOLevels Working layers ................................................................. 74 6.1.12.12 @System @D Data @ZWDQueries Path/time diagram........................................................ 74 6.1.12.13 @System @O User interface ................................................................................................ 74 6.1.12.14 @System @O User interface @Bulkprocessing Bulk processing......................................... 74 6.1.12.15 @System @O User interface @Mappingtable Mapping table Attribute/Attribute ................. 75 6.1.12.16 @System @O User interface @PCL User interface ............................................................. 75 6.1.12.17 @System @O User interface @PE-Modul............................................................................ 75 6.1.12.18 @System @O User interface @Product device selection (product data) ............................. 75 6.1.12.19 @System @O User interface @Print Print ............................................................................ 75 6.1.12.20 @System @O User interface @Q Signature Signatures ...................................................... 75 6.1.12.21 @System @O User interface @Query Queries .................................................................... 75 6.1.12.22 @System @O User interface @Search&Index Search/index object .................................... 75 6.1.12.23 @System @O User interface @StdImport Standard import ................................................. 75 6.1.12.24 @System @O User interface @Trans Translation of a node ............................................... 75 6.1.12.25 @System @Profiles User settings......................................................................................... 75 6.1.12.26 @System @Symbols System settings .................................................................................. 76 6.1.12.27 @System @Tree views in the Navigator ............................................................................... 76 6.1.13 @U Units..................................................................................................................................... 76 6.1.14 CE Cost Estimate........................................................................................................................ 76 6.1.15 PQM Project Quality Management ............................................................................................. 76

6.2 Base objects with fixed call ......................................................................................................... 77

6.3 Standard tables ........................................................................................................................... 80 6.3.1 @1PE Process Engineering ....................................................................................................... 80 6.3.1.1 AE Aspen units............................................................................................................................ 80 6.3.1.2 AE Aspen measuring units > DELTA-T Aspen units................................................................... 80 6.3.1.3 AE Aspen measuring units > HEAD Aspen units........................................................................ 80 6.3.1.4 CA Attributes-Catalog ................................................................................................................. 81 6.3.1.5 EQ Equipment............................................................................................................................. 81 6.3.1.6 EQ equipment > ND0227 - ND0229 TEMA character ................................................................ 81 6.3.1.7 HE HTFS measuring units .......................................................................................................... 81 6.3.1.8 IO Import Options........................................................................................................................ 81 6.3.1.9 IO import options > ND0931 ....................................................................................................... 81 6.3.1.10 IO import options > ND0932 ....................................................................................................... 82 6.3.1.11 SYS system > 1 Graphic representation..................................................................................... 82 6.3.1.12 SYS system > @NC naming convention .................................................................................... 83 6.3.1.13 SYS system > @UNITSYSTEMS unit systems.......................................................................... 83 6.3.1.14 SYS system > BOOL .................................................................................................................. 83 6.3.1.15 SYS system > ND0208 routing status......................................................................................... 84 6.3.1.16 SYS system > NSYS standard system ....................................................................................... 84 6.3.1.17 SYS system > SY0001 object classes........................................................................................ 84 6.3.1.18 TD Technical data ....................................................................................................................... 84 6.3.1.19 TD technical data > ND0238 connection design......................................................................... 84 6.3.1.20 TD technical data > ND0250 design ........................................................................................... 84 6.3.1.21 XX other > TRAYSYMBOLTYPE................................................................................................ 84

Table of contents


6.3.2 @3D 3D/ISO Catalog...................................................................................................................85 6.3.3 @3DCM Catalog 3D ....................................................................................................................85 6.3.4 @EXF...........................................................................................................................................85 6.3.5 @IRF_, e.g. @IRF_DETAIL ................................................................................85 6.3.6 @Local .........................................................................................................................................85 6.3.7 @SYSTEM/Tables for COMOS...................................................................................................86 6.3.7.1 @SYSTEM > @AREA/Sheet zones............................................................................................86 6.3.7.2 @SYSTEM > @BRIDGESYMBOLS/Bridge symbols..................................................................86 6.3.7.3 @SYSTEM > @CLASS > /Header classes .......................................................86 6.3.7.4 @SYSTEM > @CONNECTION/Connection ...............................................................................86 6.3.7.5 @SYSTEM > @CONSYMBOL....................................................................................................87 6.3.7.6 @SYSTEM > @IMP_ARROW/Implementation arrows ...............................................................87 6.3.7.7 @SYSTEM > @LINETYPES > /Line types ...................................................87 6.3.7.8 @SYSTEM > @MASK/Masks (default) AKZ...............................................................................87 6.3.7.9 @SYSTEM > @MASK01/Masks (KKS) ......................................................................................88 6.3.7.10 @SYSTEM > @MASK02/Masks (ANSI metric) ..........................................................................88 6.3.7.11 @SYSTEM > @PIPECONSYMBOL/Pipe: sheet reference symbols..........................................88 6.3.7.12 @SYSTEM > @PIPEENDSYMBOL/Pipe: end symbols .............................................................88 6.3.7.13 @SYSTEM > @PipeCutMode pipe cut mode .............................................................................88 6.3.7.14 @SYSTEM > @S7Classes/S7 classes .......................................................................................88 6.3.7.15 @SYSTEM > @UNITMAPPING/Representation of English and metric systems .......................89 6.3.7.16 @SYSTEM > @USERLNTYPE/User-defined line types.............................................................89 6.3.8 IC Catalog I&C .............................................................................................................................89 6.3.8.1 S Signal > IOA system signal mode ............................................................................................89 6.3.9 ME Mechatronic ...........................................................................................................................89 6.3.10 PI Piping and instrumentation ......................................................................................................89 6.3.10.1 Y attributes catalog > 0 attributes collection ................................................................................90 6.3.11 RIDIVPOS/P&ID measuring position lettering .............................................................................96 6.3.12 RIFLOWDIRSYMBOL/P&ID flow direction symbol......................................................................96 6.3.13 RILNTYPE/Pipe identification ......................................................................................................96 6.3.14 RIST/Substance stream properties..............................................................................................96 6.3.15 RK PipeSpec................................................................................................................................96

7 Personal Settings..................................................................................................................................... 97

7.1 Base objects "User settings" (Profiles) ........................................................................................97

7.2 Save the settings .........................................................................................................................99

7.3 "Extended >>" button .................................................................................................................100

8 Language management (localization) .................................................................................................... 101

8.1 General ......................................................................................................................................101 8.1.1 Language areas in COMOS.......................................................................................................101 8.1.1.1 Program interface (interface language) .....................................................................................101 8.1.1.2 Database (project language)......................................................................................................101 8.1.1.3 Template files.............................................................................................................................102 8.1.2 Combination of language areas.................................................................................................102 8.1.3 Technical background................................................................................................................102

8.2 Interface language .....................................................................................................................103

8.3 Project languages ......................................................................................................................103 8.3.1 Switching languages/language management ............................................................................103 8.3.1.1 Language management ("Languages" tab) ...............................................................................103

Table of contents


8.3.1.2 Context menus on the "Languages" tab ................................................................................... 104 8.3.1.3 Application................................................................................................................................. 105

8.4 Translation of project data......................................................................................................... 107 8.4.1 Translating attributes................................................................................................................. 107 8.4.1.1 Technical background............................................................................................................... 107 8.4.2 Translate "Description" (object language translation) ............................................................... 108 8.4.2.1 Translating an object................................................................................................................. 108 8.4.2.2 Relationship between base objects and engineering objects ................................................... 108 8.4.3 Bulk translation.......................................................................................................................... 109 8.4.3.1 Basics........................................................................................................................................ 109 8.4.3.2 Translating multiple objects....................................................................................................... 110 8.4.3.3 Columns of the bulk translator .................................................................................................. 110 8.4.4 Numbers in language management.......................................................................................... 111

8.5 Translation database (DBX)...................................................................................................... 111 8.5.1 Introduction ............................................................................................................................... 111 8.5.2 Creating a translation database ................................................................................................ 111 8.5.3 Working with the translation database ...................................................................................... 112 8.5.4 Using a translation search......................................................................................................... 112 8.5.5 Import of the translations........................................................................................................... 113 8.5.6 Writing current texts into a database copy................................................................................ 114

8.6 Language-dependent selection of templates ............................................................................ 115

8.7 Exclusions ................................................................................................................................. 115

8.8 Centrally managing the help menu ........................................................................................... 116

9 Status management............................................................................................................................... 119

9.1 Object-based Status Management ........................................................................................... 119 9.1.1 Preparing base objects ............................................................................................................. 119 9.1.1.1 Base object @Status................................................................................................................. 119 9.1.1.2 Base objects, "System" tab ....................................................................................................... 120 9.1.1.3 Controlling the status through attributes ................................................................................... 120 9.1.1.4 Controlling the status through a base object script................................................................... 121 9.1.2 Status management on the engineering side ........................................................................... 121 9.1.2.1 Setting the status in the properties ........................................................................................... 121 9.1.2.2 Setting the status in the Navigator ............................................................................................ 121 9.1.2.3 Legend ...................................................................................................................................... 122 9.1.2.4 Automatic status change........................................................................................................... 123 9.1.2.5 Status calculation log ................................................................................................................ 123 9.1.3 Allocating rights for status administration ................................................................................. 124

9.2 Query-based status administration ........................................................................................... 124 9.2.1 Aim ............................................................................................................................................ 124 9.2.2 Mixed operation......................................................................................................................... 124 9.2.3 Administration ........................................................................................................................... 125 9.2.3.1 Base objects.............................................................................................................................. 125 9.2.3.2 Object query "Status" ................................................................................................................ 125 9.2.3.3 Hierarchical query-based status management ......................................................................... 125 9.2.4 XML storage of the status ......................................................................................................... 126 9.2.5 Table-based status administration: Script examples ................................................................ 126 9.2.6 Display of data from the XML file .............................................................................................. 128 9.2.7 Filters......................................................................................................................................... 128

Table of contents


9.2.8 Application..................................................................................................................................128 9.2.9 Reference...................................................................................................................................129 9.2.10 Allocating rights for status administration ..................................................................................129

10 Project properties................................................................................................................................... 131

10.1 Overview ....................................................................................................................................131

10.2 Calling the project properties .....................................................................................................132

10.3 "General" tab..............................................................................................................................132

10.4 "Links" tab ..................................................................................................................................133

10.5 "Options" tab ..............................................................................................................................133 10.5.1 "Standard" tab ............................................................................................................................133 10.5.1.1 Group: Attribute value ................................................................................................................134 10.5.1.2 Group: Static linkage group .......................................................................................................134 10.5.1.3 Group: Unit system ....................................................................................................................134 10.5.1.4 Group: Display of date/time in....................................................................................................134 10.5.1.5 Group: Users/Rights ..................................................................................................................135 10.5.1.6 Group: Miscellaneous ................................................................................................................135 10.5.2 "Documents" tab ........................................................................................................................137 10.5.2.1 Group: General ..........................................................................................................................137 10.5.2.2 Group: Automatic referencing (of documents)...........................................................................137 10.5.2.3 Group: View Station: Presetting action ......................................................................................137 10.5.3 "Revision options" tab ................................................................................................................137 10.5.3.1 Group: Server side revision .......................................................................................................137 10.5.3.2 Group: Procedure ......................................................................................................................138 10.5.3.3 Group: eSign..............................................................................................................................138 10.5.3.4 Monitoring group ........................................................................................................................138 10.5.3.5 Group: Settings ..........................................................................................................................138 10.5.3.6 Group: Report revision comparison method ..............................................................................139 10.5.3.7 Group: Redlining ........................................................................................................................139 10.5.3.8 Group: Other ..............................................................................................................................139 10.5.4 EE/I&C Options 1.......................................................................................................................140 10.5.4.1 General group ............................................................................................................................140 10.5.4.2 Group Device selection..............................................................................................................140 10.5.4.3 Signal tracking group .................................................................................................................141 10.5.4.4 Device labeling group ................................................................................................................141 10.5.5 EE/I&C Options 2.......................................................................................................................143 10.5.5.1 Settings group............................................................................................................................143 10.5.6 EE/I&C reference layouts...........................................................................................................144 10.5.6.1 Reference display group ............................................................................................................144 10.5.6.2 Delimiter group...........................................................................................................................144 10.5.6.3 Settings group............................................................................................................................144 10.5.7 Process engineering ..................................................................................................................146 10.5.7.1 Link P&ID and PPC group .........................................................................................................146 10.5.8 PQM options ..............................................................................................................................146 10.5.9 FieldConnect ..............................................................................................................................146 10.5.10 Maintenance...............................................................................................................................146 10.5.11 "Comos" tab ...............................................................................................................................147

10.6 "Languages" tab.........................................................................................................................147

10.7 "Cases" tab ................................................................................................................................147

Table of contents


10.8 "Fulltext index" tab .................................................................................................................... 148

10.9 "PDMS interface/construction assistant" tab............................................................................. 148

10.10 "Project data" tab ...................................................................................................................... 148

10.11 "SysLog" tab.............................................................................................................................. 148

10.12 "Configuration file transfer" tab ................................................................................................. 148

10.13 "Plant Modeler" tab ................................................................................................................... 149

10.14 "Viper" tab ................................................................................................................................. 149

10.15 "Workflows" tab ......................................................................................................................... 149

10.16 Tabs for base references .......................................................................................................... 149 10.16.1 "General project options - Base references 1" tab.................................................................... 149 10.16.2 "General project options - Base references 2" tab.................................................................... 150 10.16.3 Set reference............................................................................................................................. 150 10.16.4 Navigating to the object............................................................................................................. 150

11 Working layers....................................................................................................................................... 151

11.1 Layer concept for working layers .............................................................................................. 151

11.2 @WOLevels .............................................................................................................................. 152 11.2.1 Properties of working layers...................................................................................................... 152 11.2.2 Other ......................................................................................................................................... 152 11.2.3 Release checks of the working layer ........................................................................................ 153 11.2.4 Script ......................................................................................................................................... 153 11.2.5 Text masks................................................................................................................................ 154

11.3 List display of the working layer selection................................................................................. 154

11.4 Rights administration for working layers ................................................................................... 155

11.5 Managing working layers .......................................................................................................... 156

11.6 Managing documents in working layers.................................................................................... 157

11.7 WO-Administrator...................................................................................................................... 157

11.8 Taking over Unchanged Objects............................................................................................... 158

12 Assembly groups / Templates................................................................................................................ 159

12.1 Definition ................................................................................................................................... 159

12.2 Organizing / preparing templates.............................................................................................. 159

12.3 Structure/retaining the structure................................................................................................ 160

12.4 Determining the positioning....................................................................................................... 161

12.5 Variants ..................................................................................................................................... 161

12.6 Using templates ........................................................................................................................ 161

13 Project directory matching ..................................................................................................................... 163

13.1 Matching documents ................................................................................................................. 163 13.1.1 "Documents" tab ....................................................................................................................... 163

13.2 Comparing revision directories ................................................................................................. 165

Table of contents


14 Merging objects ..................................................................................................................................... 167

14.1 Aim .............................................................................................................................................167

14.2 Application..................................................................................................................................167 14.2.1 Usage of the parameter fastCheck ............................................................................................168 14.2.2 Usage of the mergeMode parameter.........................................................................................169 14.2.3 Object-Matching (Name, MatchKey)..........................................................................................170 14.2.4 Usage of the "MergeMode" tab..................................................................................................171 14.2.5 Default settings ..........................................................................................................................172 14.2.6 Method MergeConnectors .........................................................................................................172 14.2.6.1 Call .............................................................................................................................................173 14.2.6.2 Modes ........................................................................................................................................174

15 Object Debugger.................................................................................................................................... 177

16 External programs in the bin directory ................................................................................................... 179

16.1 Comos.EnterpriseServer.Process.exe.......................................................................................179

16.2 Comos.Web.Configurator.exe....................................................................................................179

16.3 Comos.XIF.exe ..........................................................................................................................179

16.4 ComosEnterpriseMonitor.exe ....................................................................................................179

16.5 ComosMotionXScheduler.exe/ComosMotionXServerManager.................................................179

16.6 ComosReg.exe ..........................................................................................................................179

16.7 DBExtras.exe .............................................................................................................................180

16.8 DBMon.exe ................................................................................................................................180

16.9 DBSync.exe ...............................................................................................................................180

16.10 DelComosAppData.exe .............................................................................................................180

16.11 ExecuteXIF.exe..........................................................................................................................181

16.12 Dongle.exe.................................................................................................................................181

16.13 ExportDB.exe.............................................................................................................................181

16.14 ImportDB.exe .............................................................................................................................181

16.15 KeyCode.exe..............................................................................................................................181

16.16 Konverter.exe.............................................................................................................................181

16.17 LCODBC32.exe .........................................................................................................................181

16.18 MotionXMonitor.exe ...................................................................................................................181

16.19 MXExec.exe...............................................................................................................................182

16.20 NetLogin.exe..............................................................................................................................182

16.21 ptmcast.exe................................................................................................................................182

16.22 RegAsm_v2.0.50727.exe...........................................................................................................182

16.23 REGMAN.EXE ...........................................................................................................................182

16.24 Sychange.exe ............................................................................................................................183

17 Restoring deleted objects ...................................................................................................................... 185

Table of contents


18 Attributes ............................................................................................................................................... 187

18.1 Editing attributes in a group ...................................................................................................... 187

18.2 Instances (Reducing the Object Number)................................................................................. 187 18.2.1 Project option instances ............................................................................................................ 187 18.2.2 Definition of instantiating ........................................................................................................... 188 18.2.3 Preparing base objects ............................................................................................................. 188 18.2.4 Engineering objects with instance building ............................................................................... 188 18.2.5 Effects within the engineering project ....................................................................................... 189 18.2.6 Retrospective setting up of instances ....................................................................................... 190

18.3 Mapping table............................................................................................................................ 191 18.3.1 Area of application .................................................................................................................... 191 18.3.2 Attribute on attribute.................................................................................................................. 191 18.3.2.1 Comparison to related functionalities........................................................................................ 191 18.3.2.2 Preparation................................................................................................................................ 191 18.3.2.3 Interface .................................................................................................................................... 192 18.3.2.4 Script editor ............................................................................................................................... 193 18.3.3 Mapping table for Excel............................................................................................................. 195

18.4 Calculation formulas: TValue, CatStd. ...................................................................................... 197 18.4.1 TValue....................................................................................................................................... 197 18.4.2 CatStd ....................................................................................................................................... 197

18.5 Advanced properties ................................................................................................................. 199 18.5.1 Creating advanced properties................................................................................................... 199 18.5.2 Generating indices .................................................................................................................... 200 18.5.3 Using advanced properties ....................................................................................................... 201

19 Standard tables...................................................................................................................................... 203

19.1 Definition ................................................................................................................................... 203

19.2 Creating or modifying standard tables ...................................................................................... 203

19.3 Customizing column headings in standard tables..................................................................... 205

19.4 Filtering standard table values: @StdValFilter.......................................................................... 205

19.5 Symbol allocation ...................................................................................................................... 206

20 Units ...................................................................................................................................................... 207

20.1 Unit systems.............................................................................................................................. 207 20.1.1 Editing unit systems .................................................................................................................. 207 20.1.1.1 "Group" area.............................................................................................................................. 207 20.1.1.2 The lower dialog area "Units".................................................................................................... 208 20.1.2 Converting values throughout projects ..................................................................................... 209 20.1.3 Using units................................................................................................................................. 210

20.2 Unit conversion ......................................................................................................................... 210

21 Numbering ranges ................................................................................................................................. 213

21.1 Basics........................................................................................................................................ 213

21.2 Displaying the "Numbering ranges" tab in properties ............................................................... 215

21.3 Creating numbering ranges....................................................................................................... 216

21.4 Viewing numbering ranges and assignments ........................................................................... 216

Table of contents


21.5 User interface reference ............................................................................................................217

22 Synchronizing base data ....................................................................................................................... 219

22.1 Problem......................................................................................................................................219

22.2 ExportDB.exe in connection with exporting ...............................................................................222

22.3 ExportDB into an existing database...........................................................................................223

22.4 DBSync.exe ...............................................................................................................................223

22.5 Working layers ...........................................................................................................................225

22.6 Mixed forms................................................................................................................................226

22.7 Further recommendations..........................................................................................................226

23 Default settings for the "Data Aggregation" plugin ................................................................................. 227

Table of contents



Trademarks 1Trademarks

Registered trademark: COMOS®

Trademarks



System Monitor 2

Overview The System Monitor enables the control of the cache and provides an overview of the COMOS client.

Open: Menu "Extra > Monitoring > System Monitor".

Alternatively, click on any desired object in the Navigator and select the keyboard command [Ctrl+S].

2.1 COMOS system status "Maximum no. of loaded objects" list

This list determines at what intervals the System Monitor is updated.

"COMOS system status" control group Field Description "Number of objects" Number of COMOS objects in the cache. The number of objects is limited by the entry in the

"Maximum no. of loaded objects" field. See also section Matching the cache and main memory (Page 18).

"Referenced objects" Number of COMOS objects that are held by components and cannot be removed from memory. Releasing objects does not affect the referenced objects and remain in memory. The number of objects is thus always greater than the number of referenced objects.

"Cache entries" Number of cache entries. The cache entries result from the number of objects. The number of cache entries is always considerably greater than the number of objects. A cache entry needs considerably less memory than an object. Releasing objects does not affect the cache entries and remain in memory.

"Hash table size" The cache entries are managed in the hash table. The hash table is made larger if necessary. "Number of collections" Number of COMOS collections in the cache.

System Monitor 2.2 Releasing objects (ReleaseObjects, ReleaseAllObjects)


2.2 Releasing objects (ReleaseObjects, ReleaseAllObjects)

2.2.1 Matching the cache and main memory The amount of main memory available is not determined dynamically during operations and released as required. Instead, COMOS has the "Maximum no. of loaded objects" function.

Maximum no. of loaded objects The value selected for "Maximum no. of loaded objects" determines from what point the cache is to be emptied.

Optimum setting of the "Maximum no. of loaded objects" field The value that is input here is stored in the COMOS function "MaxLoadedObjects" ("Workset" class).

The limit to be set for the maximum number of objects to be loaded depends on the amount of free memory available.

Example: Once you have entered a new value, COMOS checks within the "System Monitor" to see whether the specified high limit has already been reached. If it has, any objects that are no longer required are deleted from the cache.

In order to prevent the cache from overflowing, check that the number of objects in the cache is below the upper limit for objects to be loaded before you perform any actions which require a lot of space, such as copying a unit.

Note

If you set the limit for "Maximum no. of loaded objects" too low, even the items that cannot be released, such as modified objects or referenced objects, could cause you to exceed the limit. In such a case, objects would be released unnecessarily.



2.2.2 Conducting an object release The object release, in other words, a partial or total clearing of the cache, is always done as the result of a user action.

Never globally delete the object cache, because COMOS runs more slowly without caching if there is sufficient main memory.

If the memory no longer has sufficient space, you can release it manually.

Manual deletion: releasing unused objects (ReleaseAllObjects) Right-click on the "Total objects" field on the status bar that is at the bottom of the COMOS window. Select the "Release unused objects" command.

● The COMOS cache is emptied.

● The value given in "Maximum no. of loaded objects" is no longer evaluated.

Clearing as the result of a user action (workset.ReleaseObjects)

The following actions also call up the ReleaseObjects COMOS function:

● Save all

● ScanDevices

● Global test

● Connecting a project to or disconnecting a project from a base project or a system project

● Copying a project.

Effect of ReleaseObjects: The value in "Maximum no. of loaded objects" is evaluated and the cache is cleared as far as possible if it has more objects in it than the specified value.

Effect of clearing the cache

All saved objects are cleared.

The following are not deleted:

● Modified objects and those that have not yet been saved

● Referenced objects

● Cache entries



Function involved Result MaxLoadedObjects The number of objects, above which objects are to be deleted from memory by

ReleaseObjects. ClearCache Deletes all objects from the memory.

The status corresponds to that present after reinitialization of the workset. Old object variables are no longer valid. Reset the CurrentUser and CurrentProject. When working with COMOS, you must use ReleaseObjects.

ReleaseObjects Deletes the released objects from the cache if MaxLoadedObjects is exceeded. ReleaseAllObjects Same as ReleaseObjects

"MaxLoadedObjects" is not evaluated.


Performance Monitor 3

Purpose ● Measures the temporal behavior of technical COMOS components.

● Logs software access on different levels.

Starting the Performance Monitor Menu "Extra > Monitoring > Performance Monitor".

3.1 User interface reference

Upper area In the upper area, there are buttons and options which you can use to set what is displayed in the Performance Monitor. The options are as follows:

Button/ Option

Description

"Refresh" Determines a new monitoring value for the active modules. An asterisk appears in the "Changed" column if a change has been

made to the currently determined value (column: value) and the last value.

"Delete" Deletes the older values. "Level" Changes the monitoring level.

Off: Measuring is turned off. Debug: Access operations are logged.

"Time" Switches all modules on or off that measure the required time by an action. "Count" Switches all modules on or off that measure the frequency of an action. "Average time" Switches all modules on or off that measure the average time required per

action. "Maximum time" Switches on or off all modules that measure the maximum execution time

per action. "Instance count" Switches all modules on or off that measure the number of instances. "Various" Switches all modules on or off that are not among the above groups.

Performance Monitor 3.2 General COMOS functions


Button/ Option

Description

"Estimate process time"

The timers in COMOS query the process time or thread time. This option is used to differentiate between the application and the rest of the runtime environment.

"Script only" Only the time dedicated in scripts is measured. Timers started before a script and/or first stopped afterwards are reduced accordingly by the portion elapsed outside.

List area A list shows the active modules and their currently valid monitoring values.

In the default setting, only those modules that are currently active are shown in the list area. The list of active modules changes according to the work situation.

3.2 General COMOS functions

Query.BaseQuery.CellValue.TimeSelf Timer for the design of objects queries.

PPGeneral.Popup_AddByItems.AvTimePerCall Timer for the design of popup windows.

Navigator.TreeViewAdd.Time Timer for the design of the Navigator.

Navigator.AddNode Timer for adding a node to the tree view.

Navigator.ExpandNode Timer for expanding a node in the Navigator.

Navigator.ObjectTitle Timer for the calculation of the to be displayed text of a tree view node.

Performance Monitor 3.3 Creating objects


3.3 Creating objects

Device.ClassDevice.CreateDeviceObject Timer for creating a device via the "Device.Dll" method "CreateDeviceObject".

3.4 Feed

Fedd.ProllImport.601.Time Timer for the duration of a data import.

3.5 Core functions

Comos.Total Timer for all kernel functions. Is only active if it was set beforehand ("Workset.TotalTimeMode").

Comos.DB.ColLoad Timer for loading collections from the database. The total time is measured: Creation of an SQL-statement, storage of the statement, object generation and pasting into the collection, reading of properties included.

These timers are the most important timers for the estimation of the performance for reading access. Thus, they are differentiated in detail. On the one hand regarding every collection type (OwnSpecifications, devices, documents, CDevices etc.) and on the other hand according to the question whether the collection is empty or not:

● Comos.DB.NonEmptyColLoad_Type_%d

and

● Comos.DB.EmptyColLoad_Type_%d

Comos.DB.BackColLoad Timer for loading backpointer collections from the database. Very similar to Comos.DB.ColLoad.

Comos.DB.ObjLoad Timer for loading single references from the database. Very similar to Comos.DB.ColLoad. However, here max. one object is loaded.

Performance Monitor 3.5 Core functions


Comos.DB.BackColLoad Timer for loading backpointer collections from the database. Very similar to Comos.DB.ColLoad.

Comos.DB.ObjLoad Timer for loading single references from the database. Very similar to Comos.DB.ColLoad. However, here max. one object is loaded.

Comos.DB.Save Timer for saving a dataset. This timer measures every storage process in the database, regardless if storing took place via Object.Save, Object.SaveAll", "UndoState.Save or Workset.SaveAll.

Comos.Scan Timer for scanner operations:

ScanObjects, ScanObjectsByClass, ScanDevices, ScanDevicesWithDeleted, ScanDocuments

Comos.OBJ.Copy Timer for copying processes

Comos.Script.Specification.Time Timer for script functions

Comos.WSET.Save.Time Timer for storage process

Performance Monitor 3.6 Object queries


3.6 Object queries

Query.ColumnDef Query.ColumnDef. + CStr(Index) + "." + mName Timer for the calculation of the Index column. Contains both the index as well as the name of the column.

QueryBrowser.InstanceCounter Counts the number of open query browsers. Please note that object queries can also be implemented without a browser. Such interfaceless object queries are not considered here. You can find additional information on this topic in the "Class Documentation ivbQuery_dll" manual.

3.7 Reports

WSP.ConnectionManager.InstanceCount Timer for checking the interconnecting logic on the reports.

WSP.Eval.RoConn.Count Timer for checking the output of objects on the report.

WSP.FixDependencies.RoConn.Count Timer for checking the consistency of objects on the report.

WSP.Subst.ProzentN.RoDevice.Time Timer for checking the structure of wildcard texts on the report.

3.8 Revisioning

RevisionMaster.DoRevision Timer for implementing revisions.

Performance Monitor 3.9 P&I


3.9 P&I

PFD.EvalItem.NAME_DES_DEVICE Timer for evaluating devices (no pipes) on a report.

PFD.Eval.RoConn Timer for evaluating pipes on a report.

PFD.PfdMod.IPfdMod_SetComosConnection.Time Timer for generating all connections on a report.

PFD.Eval.RoFlag Timer/Counter for evaluating pipe flags.


Database 44.1 Import/export of databases

4.1.1 Synchronized databases

4.1.1.1 Area of application COMOS can manage versions for distributed data storage. In this case, the stocks of data of physically separated databases which can be synchronized. The synchronization is triggered manually and carried out automatically.

Database synchronization is only possible for base projects. It is not recommended to use this technology for engineering projects.

4.1.1.2 Preparation: DB identifier

Limits of synchronization You have prepared a COMOS DB and made a special copy of it. If two completely independent databases have been created, these databases cannot be synchronized retrospectively.

Procedure To prepare the DB identifier, proceed as follows:

1. Click on "Administrator > System > Data maintenance (support)" in the menu and open the "DB organization" tab.

2. Enter any letter in the "DB identifier" field.

You are not allowed to use any letters that were used at any time by any other database as a DB identifier.

4.1.1.3 Creating the synchronized copy (ExportDB) Start the "ExportDB.exe" program in the "\bin" directory found in the COMOS root directory. See also section "Export (Page 31)".

Source In the "Source", you specify the database to which you previously assigned a DB identifier.



Target Enter a new database in the "Target" field.

● Access

Create a new database.

● Server databases (SQL, Oracle)

Create a new database and open it with COMOS at least once.

"Without deleted objects" option This option is not evaluated during a synchronization. In principle, deleted objects are ignored during a synchronization operation.

See also section Export (Page 31).

DB synchronization Activate the option switch with "DB synchronization".

DB identifier The "DB identifier" field appears as soon as the option switch is activated. Here, you can input a letter that has not been used yet.

Projects In the "Projects" dialog window you can state which projects are to be exported synchronized. There are two available options:

● Mark the specific projects that are to be exported synchronized.

● Mark all projects.

Depending on the database and the amount of data, each option can save time under the appropriate circumstances.

Export Click the "Export" button.

Note

If there is a lot of data, the export process may take several hours.

The export operation cannot be carried out while the system is running.



4.1.1.4 Command line mode (ExportDB.ini) You can start ExportDB via a command line. In that case, the required parameters are taken from an ini file.

To notify ExportDB.exe of the ini file when the call is made, type the absolute or relative name (relative to "ExportDB.exe") of the ini file in the command line.

Alternatively, enter just "/". In that case, a search is made with the fixed name "ExportDB.ini" parallel to "ExportDB.exe".

A log file "ExportDB.txt" is created in the temp directory.

Example [Source]

ConnectionString = "D:\ComosApp\DB\RelDBV7_1\comos.mdb"

[Target]

ConnectionString = "C:\Temp\DBTest.mdb"

WithDeleted = False

DBSyncName = ""

RootDir = ""

AllProjects = False

Overlays = True

[Projects]

COMOS_EE

XTest

You can also integrate Oracle and SQL servers in this way:

ConnectionString = "[ORACLE]pt_ORACLE"

or

ConnectionString = "[SQL - SERVER]pt_sql_server"

Explanations ● ConnectionString

You can input an mdb or a server instance as the connection string:

ConnectionString = "[SQL - SERVER]pt_sql_server"

ConnectionString = "D:\ComosApp\DB\RelDBV7_1\comos.mdb"

● WithDeleted

Specifies whether objects with a delete flag are exported.



● DBSyncName

Is used to synchronize the database. This option must be have been specified at the time of the first import.

● RootDir

Sets the document directory as in " Administrator > Support": "DB-Orga: Document directory" tab.

● AllProjects = True

If all projects are exported, then you do not need to list the individual projects in the third section.

● Projects

Is only evaluated if AllProjects is not set to True.

Application example You can use a scheduled task to carry out regular export operations by specifying the command line.

4.1.1.5 Synchronizing or integrating data (ImportDB.exe) Open the "ImportDB.exe" program from the "\bin" director

COMOS Administration 1 - Siemens · 2015. 1. 23. · 4.5.7.1 Administration ... 6.1.12.2 @System @D...

Documents

Transcript of COMOS Administration 1 - Siemens · 2015. 1. 23. · 4.5.7.1 Administration ... 6.1.12.2 @System @D...