Professional Documents
Culture Documents
Reference Guide
All warranties given by Intergraph Corporation about equipment or software are set forth in your purchase contract, and nothing stated in, or
implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties.
The information and the software discussed in this document are subject to change without notice and should not be considered
commitments by Intergraph Corporation. Intergraph Corporation assumes no responsibility for any error that may appear in this document.
The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of this
license.
No responsibility is assumed by Intergraph for the use or reliability of software on equipment that is not supplied by Intergraph or its
affiliated companies.
Trademarks
Intergraph, and RIS are registered trademarks of Intergraph Corporation. ACE, DBACCESS, DIALOG, DMRS, EE CMS, EE Power, EE
Raceway, EE Schematic, EE Wiring Diagram, IGDS, and SEE are trademarks of Intergraph Corporation. All other brands and product
names are trademarks of their respective owners.
Copyright
1984-2003 Intergraph Corporation
All Rights Reserved
Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; contains
confidential and proprietary information of Intergraph and/or third parties which is protected by copyright and trade secret law and may not
be provided or otherwise made available without proper authorization.
Unpublished — rights reserved under the copyright laws of the United States.
Intergraph Corporation
Huntsville, Alabama 35894-0001
________________ Table of Contents
Table of Contents
If You Need Assistance ........................................................................................................ 17
Intergraph Directory ............................................................................................................. 17
Preface ................................................................................................................................................. 19
1. Introduction .................................................................................................................................. 25
Assumptions ......................................................................................................................... 27
Overview ............................................................................................................................... 27
3
________________
Update Reference Schema .................................................................................................... 55
Create ........................................................................................................................................... 61
Design .......................................................................................................................................... 63
Process ......................................................................................................................................... 64
Overview ............................................................................................................................... 64
Operating Modes .................................................................................................................. 65
EDEN ........................................................................................................................................... 67
Report ........................................................................................................................................... 70
Overview ............................................................................................................................... 70
A Special Note for Bill of Materials by Volume .................................................................. 72
Overview ............................................................................................................................... 73
Utilities ......................................................................................................................................... 75
Copy ...................................................................................................................................... 78
Delete .................................................................................................................................... 79
Undelete ................................................................................................................................ 80
Purge ..................................................................................................................................... 81
Rename ................................................................................................................................. 82
Send ...................................................................................................................................... 83
Receive ................................................................................................................................. 84
Archive ................................................................................................................................. 86
Restore .................................................................................................................................. 87
Output ................................................................................................................................... 89
4
________________ Table of Contents
5
________________
When to Use These Commands ............................................................................................ 131
Before Using These Commands ........................................................................................... 131
Group Workflow ................................................................................................................... 131
Operating Information .......................................................................................................... 131
6
________________ Table of Contents
7
________________
Change System Parameters ................................................................................................... 221
8
________________ Table of Contents
9
________________
Highlight Element by ASID ID ................................................................................................... 309
10
________________ Table of Contents
11
________________
Appendix C: EE Databases .............................................................................................................. 425
12
________________ Table of Contents
13
________________
duct_fill ................................................................................................................................. 492
ee_pseudo_cable ................................................................................................................... 492
ee_system .............................................................................................................................. 493
envelope ................................................................................................................................ 493
fitting ..................................................................................................................................... 494
fit_to_sys ............................................................................................................................... 495
mscatalog .............................................................................................................................. 496
mscolumns ............................................................................................................................ 497
ol_to_sys ............................................................................................................................... 498
one_line ................................................................................................................................. 498
panel ...................................................................................................................................... 500
project ................................................................................................................................... 500
panel_to_drw ........................................................................................................................ 501
rcp ......................................................................................................................................... 501
rcp_to_drw ............................................................................................................................ 502
rcp_to_sys ............................................................................................................................. 502
straight .................................................................................................................................. 503
str_to_sys .............................................................................................................................. 504
sys_to_drw ............................................................................................................................ 505
to_support ............................................................................................................................. 505
14
________________ Table of Contents
15
________________
Appendix L: RIS Schema Definition File ........................................................................................ 561
16
________________ Table of Contents
Intergraph Online
Our web site brings you fast, convenient, up-to-the-minute information about Intergraph’s
products, services, and direction. Our web address is: http://www.intergraph.com.
Support
For the lasest Support Services information, use a World Wide Web browser to connect to
http://www.intergraph.com/ppo/services/support.asp.
If you are outside of the United States, please call your local Intergraph office. The most up-
to-date list of international offices and distributors is available on the web at
http://www.intergraph.com.
Intergraph Directory
The following numbers are only valid in the United States unless otherwise indicated. If you
are outside the United States, please call your local Intergraph office.
Training Registration
1-800-766-7701 (U.S. Only)
Mailing Address
Intergraph Process, Power & Offshore
300 Intergraph Way
Madison, Alabama 35758
U.S.A.
17
________________
Documentation Contacts
We are constantly working on updates and improvements to the documents and other
educational media. If you have any suggestions on where we can improve the documentation
or where you think more information is needed, let us know. You can reach us by:
18
________________ Preface
Preface
Document Purpose
This document is a reference guide for Intergraph Corporation’s Electrical Engineer (EE) Raceway Modeling tm
software package. EE Raceway is a MicroStation graphics based software and lets you design, modify, and
model electrical raceway systems in a three-dimensional environment.
This document is designed as a reference; it is organized around the structure of the product rather than
presenting a typical work flow. Use this guide when you need to look up a specific EE Raceway function. It is
recommended that you work through the EE Raceway Modeling Course Guide to learn the basic concepts of the
product.
Related Documents/Products
MicroStation software is required to operate EE Raceway. Information about MicroStation capabilities can
be found in the following documents:
Intergraph Corporation’s Relational Interface System (RIS)TM is required to operate EE Raceway, along with a
relational database management system (RDBMS) supported by RIS. Currently, these include Informix,
Oracle, and Ingres. Information about RIS capabilities can be found in the following documents:
19
________________
EE Raceway Modeling Reference Guide - February 2003
Sections 3 & 4 Describe the product environment. This includes information on accessing the product
and creating and manipulating product files.
Section 5 Describes the graphics environment for the product. This includes information on the
screen display, menus, forms, and on-line Help.
Sections 7-16 Describe the command groups and operating sequences of each command within the
command groups.
Ordering Information
To order documents:
Within the United States, contact your Customer Engineer or Sales Account Representative.
For international locations, contact the Intergraph subsidiary or distributor from whom you purchased
your workstation.
Additional Information
The following informational files are delivered with the EE Raceway software in the win32app\ingr\eerway
directory.
readme.txt Describes changes and additions to the product since the last version. Lists the names
and dates of the files in the current release. For a fixes release, the files which have been
modified are appended to the top of the initial file to provide a history of all changes to
the product. Includes Comments and Trouble Report numbers which describe what
problems have been fixed. Provides special notices to the customer. Lists any exceptions
made to the certification.
20
________________ Preface
General Conventions
This document contains many visual cues to help you understand the meaning of certain
words or phrases. The use of different fonts for different types of information allows you to
scan the document for key concepts or commands. Symbols help abbreviate and identify
commonly used words, phrases, or groups of related information.
Typefaces
Italic Indicates a system response, which is an explanation of what the software is
doing. For example,
Bold Indicates a command name, parameter name, or dialog box title. Command
paths are shown using an arrow between command names. For example,
Sans serif Indicates a system prompt or message, which requires an action be taken by
the user. For example,
Bold Typewriter
Indicates what you should literally type in. For example,
Normal Typewriter
Indicates an actual file or directory name. For example,
21
________________
EE Raceway Modeling Reference Guide - February 2003
Symbols
This document uses the following symbols to represent mouse buttons and to identify special
information:
Warning — Critical information that could cause the loss of data if not followed.
Need a hint — used with activities and labs, provides a tip or hint for doing the
exercises.
Keyboard Conventions
The following list outlines the abbreviations this document uses for keyboard keys and
describes how to use them in combination. You can make some menu selections through the
use of keyboard accelerators, which map menu selections to key combinations.
22
________________ Preface
Terminology
Click To use a mouse or key combination to pick an item that begins an
action. For example,
Select the file original.dat from the list box, then click Delete to
remove it from the directory.
Drag To press and hold the data button (<D>) while moving the mouse or
hand-held cursor.
Key in To type in data and press ENTER to enter the data and execute the
default action.
23
________________
EE Raceway Modeling Reference Guide - February 2003
24
________________ Introduction
1. Introduction
1. Introduction
EE Raceway allows you to design, modify, and model electrical raceway systems in a three-
dimensional environment.
Interference detection – Creates the raceway component interference envelope files for
input to the PDS interference detection task.
You can also use EE Raceway models as background drawings for designs created in other
PDS facility design disciplines.
25
________________
EE Raceway Modeling Reference Guide - February 2003
Fit view
Window area
File design
Compress
Update
26
________________ Installation Instructions
2. Installation Instructions
This section is an instruction sheet both for initial installation and for updating the
workstation software. The software covered includes baseline and application software,
Electrical Engineer (EE) Nucleus software, and EE Raceway Modeling.
Assumptions
The following assumptions have been made in the writing of this section.
Download/Install
2.
You must be familiar with the PDS Loader.
You must be familiar with a text editor, such as vi, EMACS, or Notepad.
Products will be used with any one of the following databases: Standard Engine (SE)
Informix, On-line Informix, Oracle, or Ingres. You will need to consult individual
documentation for these products for detailed information.
Overview
This chapter covers the following topics pertaining to installation/upgrading:
Installation Procedure
Databases
27
________________
EE Raceway Modeling Reference Guide - February 2003
The chapter also outlines the basic workflow for database setup and refers you to appropriate
database documentation.
There are several things you must do before loading any software to your workstation. First,
you must select the Relational Database Management System (RDBMS) you plan to use and
decide where to locate it on your system. A database can reside locally on each workstation,
or remotely on a server. Based on these two setups, you have three options:
— Placing the project database locally on each workstation and the reference database
remotely on a server.
You must also know before beginning to download products that the order in which you load
them is very important. For the purposes of this installation, you should load system nucleus
software, followed by system application software (including EE Nucleus), followed by the
EE application products.
28
________________ Installation Procedure
Installation Procedure
This section’s examples assume that you are running the loader delivered with PDS; the
loader delivered to stand-alone EE Raceway sites may vary slightly.
Once you know what application software you need, based on your system configuration,
follow these steps to download all of the desired products to a Windows NT/2000/XP system.
1. First, connect to the drive on which the distribution software resides. This may be a
networked drive, or it may be on your local system.
Download/Install
2.
3. Select Continue to invoke the Intergraph Registration Data form. This form expects
your user name, company, and serial number (as delivered). Pressing Enter will have
no effect until all fields have been entered, including a valid serial number. The
Continue button will remain inactive until a valid serial number has been keyed in.
4. Select Continue when the button is no longer inactive. This will invoke the product
selection form.
29
________________
EE Raceway Modeling Reference Guide - February 2003
5. Place an X next to the software you wish to install. This will invoke the installation
data form for each selection. Among other installation options that vary according to
product, you will be asked to select the Installation Type (local, client, or server).
If local is selected, you must key in the path to the location to which you want to
install the software. (Note that the icon path changes as you edit the install path.)
If client is selected, you must provide the name of the server which will be
hosting the session, as well as path to the software on the server, and a local path
to the icon associated with the software.
If server is selected, you must provide the installation path. (Note that the icon
path changes as you edit the install path.)
When all information has been provided, select OK. This will return control to the
Intergraph PDS Component Loader. When all software to be loaded has been selected,
select Load Components. A message box will appear.
30
________________ Installation Procedure
Select Yes to continue, otherwise select No. A message box will display that tells you
which products are being loaded.
When the software has successfully loaded, the EENUC (Common) program group
will be created. This program group contains the EE Manager, EE Configure, EE
Download/Install
2.
Readme.txt, EE Help, and EE Nucleus icons.
6. Before executing the software, you must set the environment variables in your ee.cfg
file.
Copy the ee.cfg file found in the win32app/ingr/eenuc directory into another directory
not in the EE or PDS structure. (Your login directory will be fine; you will modify this
copied file, and it needs to be placed somewhere that it will not be over-written when
you next update the software.)
8. Use the browse command to locate and open the new ee.cfg file that you copied in the
earlier step.
The Reset command should always be used at this point to ensure that
the environment variables in the display window are those that belong to
the file you just selected, and not to a previously-selected file.
9. Set your user environment variables. Before you can enter the EE environment, you
will need to set at least the following variables:
31
________________
EE Raceway Modeling Reference Guide - February 2003
PROJECT_LOCATION
EE_SCHEMA
EE_REFDB
DB_TYPE
Select the variable to be set. This displays the current value and description for that
variable. To modify the value of that variable, key the desired value into the Value
field, then select Set.
After all variables have been set properly for your environment, and no more changes
are needed, select OK to save the modifications to the ee.cfg file.
32
________________ Databases
Databases
This section provides an overview of the workflow involved in creating a database and
schemas. What follows is a very basic outline, and you should consult your individual
RDBMS and RIS documentation for detailed instructions on database setup.
Download/Install
2.
instructions and general information about the product.
2. Download your RDBMS product and the Relational Interface System (RIS) software.
— See the section of this guide entitled Software Requirements for information about
the RIS products. Also, see the Relational Interface System (RIS) Reference
Manual.
— Informix users must create all databases in ANSI mode with this release. See the
RIS Reference Manual for information about this process or look in the
RISNOTES*.* file in the /usr#/informix/release directory for details about
creating databases in ANSI mode.
— For detailed information about creating and updating databases, see Appendix C of
this reference guide or refer to your individual RDBMS documentation.
— You will do this through the EE Environment and the RIS Schema Manager
product.
— For information about accessing RIS Schema Manager, see the section entitled
Database Utilities in this reference guide.
— For information about using the RIS Schema Manager product, see the appendix
entitled RIS Schema Manager in this reference guide or refer to the Relational
Interface System (RIS) Reference Manual.
33
________________
EE Raceway Modeling Reference Guide - February 2003
— You will use the Database Utilities option in the EE Environment to accomplish
this.
— See the Database Utilities section in this reference guide. The Database Utilities
section contains instructions for updating both project and reference schemas.
34
________________ Electrical Engineer (EE) Environment
Environment
3. EE
A project is a group of related electrical drawings and their associated database which you
create. All EE drawings are organized by project. The Project Menu and other EE
Environment menus provide easy access to all the product functions.
35
________________
EE Raceway Modeling Reference Guide - February 2003
Options List - a list of options which require additional input or other selections before
you can continue. These options can display additional forms or menus.
The basic procedure for using EE menus is first to select an option from the options list, and
then to select, or key in, the necessary information in the input fields in the input/output area.
To turn off an active option, select another option. To edit information you key in to input
fields, use standard EMACS commands.
For some options you will need to know net addresses for the input data boxes.
If you do not know the appropriate addresses, check with your system
manager.
36
________________ Using the Electrical Engineer Menus
When listings fill more than one page, you can scroll up and down the list using the scroll
bar. The bar above the arrows indicates where you are in the listing. If the bar fills the space
above the arrows, all of the available listings are currently displayed.
Icons
There are three icons that can display on EE forms, in any combination:
Confirm (√) accepts the current form settings, and executes the active process.
Reset returns you to the previous form and cancels the current form settings.
Environment
3. EE
Cancel (X) exits the EE application entirely.
The menus will not allow you to perform illegal operations. For example, you
are not allowed to print a design file from the Drawing Utility form.
Message Area
Once you have selected and confirmed a option, operating or error messages will display in
the message area at the bottom of the form. You can monitor lengthy processes by reviewing
the message area.
Summary
The best way to familiarize yourself with the environment form and their functions is simply
to practice using the available features. Remember that the basic procedure for executing a
given process is to select a form option, provide the necessary input, and then select Confirm
(√).
37
________________
EE Raceway Modeling Reference Guide - February 2003
Restore — Restores archived EE project files from a floppy disk or network nodes.
38
________________ Create
Create
This option creates a project in which your design file(s) reside. Multiple files can exist
within a single project, which itself can span multiple products.
Environment
3. EE
Field Descriptions
Project name — This field allows you to enter the project name in uppercase or
lowercase letters, though uppercase letters are automatically converted to lowercase.
Your project name should have eight or fewer characters. A .prj extension is
automatically appended to the project file name when you select Confirm (√), so you
are not required to key in this extension.
Steps
1. Select Create from the Project Menu option list.
2. Select the Project name field, and key in the new project name.
You may also want to create a new project schema when you create a
project. For information about creating a project schema, see RIS
Schema Manager, page 553 .
— OR —
Select another option to ignore your input and cancel the Create process.
39
________________
EE Raceway Modeling Reference Guide - February 2003
Enter
This option accesses a specified project, and is the first step in entering the Electrical Engineer
environment. You will need to input the names of the project, the project and reference
schemas, and the schema passwords, if they exist.
Field Descriptions
Project name — This field reflects the project name that is selected in the project
listing area. You may also key project names into this field.
Project schema — This field is automatically updated with the project schema name
associated with the selected project name. You can override the default selection by
keying in another schema name.
Reference schema — This field is automatically updated with the reference schema
name associated with the selected project name. You can override the default selection
by keying in the desired schema name.
Schema password — This field accepts a password for entering the respective schema,
if one has been defined. This field may or may not display the password once it has
been entered, depending on the setting of the appropriate Password Echo toggle.
40
________________ Enter
Password Echo — This toggle controls whether or not the password is displayed in the
respective password fields.
Steps
1. Select Enter from the Project Menu option list.
— OR —
The project schema (defaults to project name) and the current reference schema display
automatically.
3. Enter schema passwords if they were created for either schema. Identify the appropriate
Environment
3. EE
Schema password field, and key in the password. If no password was defined for the
schemas, leave these fields blank.
41
________________
EE Raceway Modeling Reference Guide - February 2003
Product Menu
The Product Menu form displays all of the available EE products on your workstation. In
this example, only the EE Raceway product is on menu, available for use. If only one EE
product exists on your workstation, then the environment bypasses the Product Menu and
goes directly into the selected product’s Design Menu.
Only the EE products you actually have installed on your workstation will be
displayed on this menu.
Steps
1. Select the desired EE application from the Product Menu form.
The Design Menu displays. (See the chapter entitled EE Raceway Environment for more
information about the Design Menu.)
42
________________ Copy
Copy
This option copies all the files within an existing project to a new project.
Field Descriptions
Environment
3. EE
Copy project from — Key in the source project name (or select it from the list).
Copy project to — Key in the destination project name; this cannot be the name of a
project that already exists.
Steps
1. Select Copy from the Project Menu option list.
— OR —
Select the Copy project from input field, and key in a project to be copied.
3. Select the Copy project to input field, and key in the new project name.
You cannot key in the name of an existing project in the Copy project
to field.
— OR —
Select another option to ignore your input and cancel the Copy process.
43
________________
EE Raceway Modeling Reference Guide - February 2003
Delete
This option completely deletes all the files and databases within an existing project.
Field Descriptions
Project name — Key in (or select from the list) the project to be deleted.
Steps
1. Select Delete from the Project Menu option list.
— OR —
Select the Project name field, and key in the project name.
If a database exists in the project directory, a warning displays indicating that you
should drop the schema corresponding to the database contained within the project.
44
________________ Delete
Selecting Accept on the warning form deletes the project and its database, while
selecting Cancel cancels the Delete function.
If a database does not exist in the project directory, a warning displays indicating that
you are about to delete an entire project.
Environment
3. EE
Selecting Accept on the warning form deletes the project, while selecting Cancel
cancels the Delete function.
— OR —
Select another option to ignore your input and cancel the Delete process.
45
________________
EE Raceway Modeling Reference Guide - February 2003
Archive
This option stores an entire project and associated database on a network host or on a floppy
disk.
Field Descriptions
Remote node name/address — This field accepts the node name or address of the
system to receive the project.
TCP/XNS — This toggle allows you to choose between TCP and XNS network
protocols. A password is required if you are using the TCP option.
Remote path/directory — This field accepts a key-in for the destination node of the
project. The project name is appended to this path. The path must exist on the remote
node.
Password Echo — This toggle allows you to display the user password you enter in the
Password field.
Username on remote node — This field accepts the user name for the destination
node.
Password — This field accepts the password (if one exists) for the destination node. A
password is required if you are using the TCP option.
46
________________ Archive
Steps
1. Select Archive from the Project Menu option list.
— OR —
Default values for the remote node name, user name, and remote directory may be
assigned in the user’s .EErc file, using the global symbols EE_NODENAME,
EE_USERNAME, and EE_REMDIR. (If you need more information about the .EErc
file, contact your system administrator.)
When archiving using a floppy disk, you must have a formatted floppy
disk placed in the disk drive.
Environment
3. EE
4. Select Confirm (√) to begin archiving.
— OR —
Select another option to ignore your input and cancel the Archive process.
47
________________
EE Raceway Modeling Reference Guide - February 2003
Restore
This option retrieves an entire project and any associated database from a network or a floppy
disk.
When restoring from a network, you cannot restore a project that is currently
listed in the listing area. You must delete or rename the current project to
complete the restore process.
When restoring from a floppy, you can restore a project that is currently listed in your
listing area. The project on the floppy will overwrite the project in your directory. Be
sure to verify that archived project will not overwrite existing projects with the same
name.
Field Descriptions
Remote node name/address — This field accepts the node name or address of the
system from which to receive the project.
TCP/XNS — This toggle allows you to choose between TCP and XNS network
protocols. A password is required if you use the TCP option.
Remote path/directory — This field accepts a key-in for the project’s node of origin.)
Password Echo — This toggle allows you to display the user password you enter in the
Password field.
Username on remote node — This field accepts the user name for the node of origin.
Password — This field accepts the password (if one exists) for the node of origin. A
password is required if you are using the TCP option.
48
________________ Restore
Steps
1. Select Restore from the Project Menu.
When restoring from a floppy disk, you must have the disk in the disk
drive.
— OR —
Select another option to ignore your input and cancel the Restore process.
Environment
3. EE
49
________________
EE Raceway Modeling Reference Guide - February 2003
Database Utilities
This option accesses the RIS Schema Manager environment and the EE schema updating
processes.
The Database Utilities options are described in detail in the following sections.
50
________________ RIS schema utilities
Before using this utility, you must have an existing database and user name. Consult your
relational database management system (RDBMS) documentation for specific information
about database installation. RIS Schema Manager, page 553 supplies examples of Create
Schema input for several RDBMSs.
Environment
3. EE
Normally this is a procedure for a system or application manager.
Steps
1. To access the RIS Schema Manager form, select the RIS schema utilities option from
the Database Utilities menu.
2. Proceed through the necessary RIS Schema Manager processes. For more
information, see RIS Schema Manager, page 553 .
51
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Output file — Defines the processing message file name.
Schema name — Defines the project database’s schema name. To enter the schema
name, select the field and key in the name of an existing project schema.
Schema password — Defines the schema password, if one exists. To enter the
password, select the field and key in the name of the password corresponding to the
schema name you entered.
Password Echo/No echo — This toggle defines if you want to display the schema
password input. To display the schema password input, set the toggle to Echo.
Application checkboxes – These boxes allow you to select the EE application(s) with
which you are updating the schema. Only those products loaded on your workstation
will display as options. You can update the schema with multiple products, though
doing so will slow processing time.
52
________________ Update Project Schema
You can also update the schema with your own data by selecting the User Defined
checkbox.
Sql and Cmd file — These fields display the command and SQL files associated with
each application. The delivered default files are defined in the
win32app\eenuc\bin\.EErc file. You can redefine the defaults by editing this .EErc file
or by redefining the variables in your $HOME\.EErc file.
To change the displayed default files, select the field, and key in the desired filenames.
To specify command and SQL files for usr-defined data, select the fields next to the
User Defined checkbox, and key in the full pathname for those files, or export
EE_CUSTOM_SQL and EE_CUSTOM_CMD for the customized SQL and command
files.
Processing toggle — This toggle indicates the operating mode for the update process.
You can set the toggle to Foreground (default), Background, or Batch. For more
information about operating modes, see
Process, page 64 .
Steps
Environment
3. EE
1. Select the Update project schema option from the Database Utilities form.
— OR —
Select Reset to return to the Database Utilities form without retaining your input.
Return to step 1.
4. When Update project schema finishes processing, it will display one of two message
files to the screen:
— If the schema is updated without errors, the system displays a processing message
file (create_db.msg).
53
________________
EE Raceway Modeling Reference Guide - February 2003
— OR —
— If errors occur during the update process, the system displays an error message file
(create_db.err).
You can also access these message files, located in the current
project’s /tmp directory, using the Output option on the Utilities
form. For more information, see
Output, page 89 .
5. Select Reset on the message file form to return to the Update project schema form.
6. Select Reset again to exit the process and return to the Database Utilities form.
54
________________ Update Reference Schema
Field Descriptions
Output file — Defines the processing message file name.
Schema name — Defines the reference database’s schema name. To enter information,
select the field, and key in the name of an existing reference schema.
Schema password — Define the schema password, if one exists. To enter information,
select the field, and key in the name of the password corresponding to the schema name
you entered.
Environment
3. EE
Password Echo/No echo — This toggles define if you want to display the schema
password. To display the schema password input, set the toggle to Echo.
Application checkboxes — These boxes allow you to select the EE application(s) with
which you are updating the schema. Only those products loaded on your workstation
will display as options. You can update the schema with multiple products, though
doing so will slow processing time.
You can also update the schema with your own data by selecting the User Defined
checkbox.
Sql and Cmd File — These fields display the command and SQL files associated with
each application. The delivered default files are defined in the
win32app\eenuc\bin\.EErc file. You can redefine the defaults by editing this .EErc file
or by redefining the variables in your $HOME\.EErc file.
To change the displayed default files, select the field, and key in the desired filenames.
To specify command and SQL files for usr-defined data, select the fields next to the
User Defined checkbox, and key in the full pathname for those files, or export
EE_CUSTOM_REFSQL and EE_CUSTOM_REFCMD for the customized SQL and
command files.
Processing mode — This toggle indicates the operating mode for the update process.
You can set the toggle to Foreground (default), Background, or Batch. For more
information about operating modes, see Process, page 64 .
55
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Update reference schema option from the Database Utilities form.
— OR —
Select Reset to return to the Database Utilities form without retaining the form
parameters. Return to step 1.
4. When Update reference schema finishes processing, it will display one of two
message files.
— If the schema is updated without errors, the system displays a processing message
file (create_db.msg).
— OR —
— If errors occur during the update process, the system displays an error message file
(create_db.err).
56
________________ Update Reference Schema
You can also access these message files, located in the current
project’s /tmp directory, using the Output option on the Utilities
form. For more information, see
Output, page 89 .
5. Select Reset on the message file form to return to the Update reference schema form.
Environment
3. EE
6. Select Reset again to exit the process and return to the Database Utilities form.
57
________________
EE Raceway Modeling Reference Guide - February 2003
58
________________ Electrical Engineer (EE) Raceway Environment
The EE Environment Product Menu, if you have multiple EE products installed on the
workstation (see
Product Menu, page 42 for more information).
— OR —
Environment
4. EERWAY
The rest of this chapter describes all the options on this menu. If you are a
new user, you may want to skip all but the Create and Design options.
Commands
The following sections describe each option in detail and show the menu as it displays when
each option is selected.
59
________________
EE Raceway Modeling Reference Guide - February 2003
Design — Allows you to enter a design file and attaches the EE menus.
Process — Allows you to list and select EE Raceway processes. It also processes
work on design files and/or databases.
EDEN — Allows you to design your own symbols for raceway elements.
Rule — Displays the design rule errors occurring in the design process.
60
________________ Create
Create
This option creates design files, based on a specified seed file.
When you create a drawing, you are actually copying a seed file (a template). The seed file
contains basic information that EE Raceway uses. A seed file can also contain customized
information like company borders and logos.
EE Raceway is delivered with both a metric (mseed.dgn) and English seed file (seed.dgn).
You can also use seed files that were generated in a Plant Design (PDS) environment. EE
Raceway will convert PDS seed files to raceway design files the first time you enter the EE
Raceway graphics environment.
Environment
4. EERWAY
Steps
1. Select Create from the Design Menu.
If there is only one seed file, it is displayed as the default. If there is more than one
seed file available, the listing area displays all these files.
Choose a seed file either by accepting the default (this happens automatically when you
select Confirm (√)) or by selecting a seed file from the scrolling area.
3. Select the drawing name input box and key in a drawing name and, optionally, a file
extension.
61
________________
EE Raceway Modeling Reference Guide - February 2003
A file extension of .dgn is automatically appended to the drawing name if you do not
enter your own file extension.
The drawing name and its file extension become the filename of the drawing. The
drawing is added to the active project.
— OR —
Select another option from the Design Menu to ignore your input and cancel the
Create process.
62
________________ Design
Design
This option accesses the graphics environment, taking you into a specified existing design
file.
Steps
1. Select Design from the Design Menu.
Environment
4. EERWAY
The system invokes the graphics environment.
— OR —
Select another option from the Design Menu to ignore your input and cancel the
Design process.
63
________________
EE Raceway Modeling Reference Guide - February 2003
Process
This option accesses all available EERWAY processes. These processes allow you to
manipulate drawings and the project database.
Overview
This section provides general information about running all processes. See Raceway
Processes, page 331 for more information about individual processes.
The screen above lists the processes currently delivered with the product. The
system manager can add or delete processes from the list by modifying the
process.dat file in win32app\eerway\data.
64
________________ Process
You must key in any information not already shown as defaults. You can override default
values by keying in your own information. All drawings are displayed on the screen scrolling
area. An asterisk (*), when placed in the Enter Drawing Name input field, is a wild card
character which can be used to list a subset of your drawings. For example, if you enter a*,
all drawings beginning with the letter "a" will be displayed. The ? character can also be used
as a wild card for a single character. Once you have entered all necessary information, select
Confirm (√) to execute the process.
Operating Modes
The Processing toggle allows you to select the operating mode for a process. The default
mode is Foreground, but you can toggle between that option and the Background and Batch
Environment
4. EERWAY
options.
A process in Foreground runs immediately, and you do not regain control until the
process is finished. In other words, you cannot perform other functions within the same
window in which you are running the process.
A process in Batch does not run until the time you specify. You must key in a time
and/or date when you want the process to start. After providing this information, you
regain control immediately.
65
________________
EE Raceway Modeling Reference Guide - February 2003
The time can be entered as 1, 2 or 4 digits. One- and two-digit numbers are taken to be hours,
four digits to be hours and minutes. The time can also be specified as two numbers separated
by a colon (hour:minute). The suffix AM or PM may be appended; otherwise, a 24-hour
clock (military time) is understood. The system also recognizes the names NOON,
MIDNIGHT, NOW and NEXT.
Optionally, you can specify a date using either a month name followed by a day number or a
day of the week (fully spelled or abbreviated to three characters). The system recognizes the
words TODAY and TOMORROW. If you input no date, the system assumes it should run the
job TODAY if the specified hour is greater than the current hour, and TOMORROW if the
specified hour is less than the current hour.
0815am Jan 24
8:15am Jan 24
Now + 1 day
5pm Friday
Steps
1. Select Process from the Design Menu.
3. Select Confirm to invoke the input form for the specified process.
— OR —
Select another option from the Design Menu to ignore your input and cancel the
Process option.
66
________________ EDEN
EDEN
Eden is a high-level symbol definition language (modeled after the FORTRAN programming
language) that allows you to design your own symbols for straights, fittings, and special parts.
The following screen displays the Eden options delivered with this version of EE Raceway.
The system manager can add or delete displayed options by modifying the eden.dat file.
This section provides general information about running all Eden program
options. For detailed information about individual Eden options, see Eden
Processes, page 347 .
Environment
4. EERWAY
67
________________
EE Raceway Modeling Reference Guide - February 2003
When you select an option from the Eden menu (and confirm the selection using Confirm
(√)), an input screen displays.
You must key in all information not displayed as defaults. If necessary, you can override the
default values that already display, and key in your own information.
Once you have entered all necessary information, select Confirm (√) to begin the option
process.
Operating Modes
A box on the right side of the menu allows you to select the operating mode for the selected
option. The default mode is foreground. The circular arrow on the right indicates that this
box leads to other selections. These selections are the three methods of running an option:
foreground, background, and batch.
An option in foreground mode runs immediately, and you cannot regain control until
the process is finished. In other words, you cannot perform other functions within the
window in which the option is running.
An option in background mode runs immediately, and you regain control immediately.
A process in batch does not run until the time you specify. You must key in a time
and/or date when you want the process to start. After providing this information, you
regain control immediately.
68
________________ EDEN
The time can be entered as 1, 2 or 4 digits. One- and two-digit numbers are taken to be hours,
four digits to be hours and minutes. The time can also be specified as two numbers separated
by a colon (hour:minute). The suffix AM or PM may be appended; otherwise, a 24-hour
clock (military time) is understood. The special names NOON, MIDNIGHT, NOW and
NEXT are also recognized.
You can specify an optional date in the form of either a month name followed by a day
number or a day of the week (spelled in its entirety or abbreviated to three characters). The
system accepts the words TODAY and TOMORROW. If you input no date, the system
assumes that if the specified hour is greater than the current hour, it will run the job TODAY,
and if the specified hour is less than the current hour, it will run the job TOMORROW.
0815am Jan 24
8:15am Jan 24
Now + 1 day
5pm Friday
Environment
4. EERWAY
69
________________
EE Raceway Modeling Reference Guide - February 2003
Report
This option accesses the standard EERWAY reports. These reports report on the project and
reference databases. You must load the project database before running any reports.
Overview
This section contains general information about running all EE Raceway reports. See
Reports, page 545 for more detailed information about individual reports.
The system manager can change the names of the reports that display in the
listing area and can add additional reports by editing the report.dat file
(win32app\eerway\data).
70
________________ Report
When you process a report, an input screen displays, allowing you to enter all input necessary
to run the report.
Key in any information that is not supplied by default. You can change the name of the
output file or error file. To change the output filename, select the output file box and key in a
new name. (No file extension is automatically appended to the name you key in.)
If you want to save reports throughout a project, you should name the output files
yourself. If a new output file has the same name as an existing file, the new file
will overwrite that file. You should give each report you want to save a unique
name.
Steps
1. Select Report from the Design Menu.
Environment
4. EERWAY
2. Select a report from the listing area.
3. Select Confirm (√) to invoke the input form for the specified process.
— OR —
Select another option from the Design Menu to ignore your input and cancel the
Report option.
71
________________
EE Raceway Modeling Reference Guide - February 2003
Any Raceway component extending outside the clipping volume defined by the High and
Low Range Coordinates will not be included in the report output.
You can find the coordinates you want to use by using the active point coordinate display on
the precision input form. The coordinate values need to be in subunits and entered in the form
field with a space between the coordinates: easting northing elevation For example, 234
532 34
72
________________ Rule Checks
Rule Checks
This option accesses the standard EERWAY Rule Checks. These rule checks are reports that
identify violations of certain design rules by working on the project database. You must load
the project database before running any rule checks.
Overview
This section contains general information about running all EERWAY rule checks. For more
Environment
4. EERWAY
detailed information about each rule check, see Reports, page 545 .
The system manager can change the names of the reports or add new reports to
the listing area by editing the rule_chk.dat file in win32app\eerway\data.
73
________________
EE Raceway Modeling Reference Guide - February 2003
The name of the rule check report displays at the top. Accept the default information that
displays in the input fields, or change that information according to your specifications.
If you want to save reports throughout a project, you should name the output files
yourself. If a new output file has the same name as another file created previously,
the new file will destroy the previously created file. You should give each report
that you want to save a unique name.
Steps
1. Select Rule from the Design Menu.
3. Select Confirm (√) to invoke the input form for the specified process.
— OR —
Select another option from the Design Menu to ignore your input and cancel the Rule
option.
74
________________ Utilities
Utilities
This option manipulates files within a project. All manipulations are performed on those files
residing in the current project’s directories.
When you select Utilities from the Design Menu, the Drawing Utility Menu displays.
Environment
4. EERWAY
Files in the current project sub-directories will be listed in four columns. Each column will list
a different subdirectory.
75
________________
EE Raceway Modeling Reference Guide - February 2003
Message (.tmp) - All files output by Raceway processes, and error files generated by
standard reports and rule check reports. (<project_name>/eerway/tmp)
Commands
The commands on the Drawing Utility Menu are described in their respective sections later
in this chapter.
Steps
1. Select Utilities from the Design Menu.
2. Select the desired option from the Drawing Utility Menu, and then select the file(s) on
which to perform that option.
76
________________ Utilities
4. Select Confirm (√) to accept the settings and execute the active option.
— OR —
Select another option to ignore your input and cancel the active option.
Environment
4. EERWAY
77
________________
EE Raceway Modeling Reference Guide - February 2003
Copy
This option copies an existing file to another file. You must specify a unique filename for the
destination file. Copy DOES NOT automatically append a file extension (.dgn, .rpt, and so
forth) to the new file.
Field Descriptions
Copy file from — This field displays the name of the file to be copied; elect a file from
the list, or key in the name of the file to be copied.
Copy file to — This field displays the name that the copy (destination) file will be
called; key in a unique destination file name into this field.
78
________________ Delete
Delete
This option removes your access to a specified file. To physically remove the file from the
workstation, you must select the Purge option. Note that files you delete with this option take
up storage space, but can be undeleted (that is, have access returned to them) until you
actively Purge them.
Environment
4. EERWAY
79
________________
EE Raceway Modeling Reference Guide - February 2003
Undelete
This option returns your access to a file that you removed using Delete. Once you have
removed files using Purge, you cannot undelete them with this option.
80
________________ Purge
Purge
This option permanently removes all the files you marked for deletion using the Delete
option. Once you Purge a file, you cannot recover it.
Field Descriptions
Purge Files toggle — This toggle allows you to choose between purging ALL files that
have been deleted, selected files that have been deleted, or no files at all.
When the toggle is set to Select files to purge, you can select specific files from the list
by placing a data point on them. To de-select a selected file, place a data point on it.
Environment
4. EERWAY
81
________________
EE Raceway Modeling Reference Guide - February 2003
Rename
This option changes the name of an existing file. It does not automatically append a file
extension (.dgn, .rpt, and so forth) to the new filename.
Field Descriptions
Rename file from — This field displays the current filename. You can select the file
from the list, or key the name into this field.
Rename file to — Key in the name that you desire to rename the current file.
82
________________ Send
Send
This option copies a file to a network node. Be sure to include the entire filename including
the extension (for example, test1.dgn). If you are sending a design file to a VAX, turn on the
IGDS toggle. Doing so will store the file in contiguous blocks on the VAX.
Field Descriptions
Password Echo toggle — The setting of this toggle determines whether the password
of the remote machine is visible or hidden upon keyin to the password field.
TCP/XNS Protocol toggle — The setting of this toggle determines whether the transfer
uses the TCP or XNS protocol to communicate between machines.
Environment
4. EERWAY
IGDS/No IGDS toggle — This toggle should be set to the IGDS setting when sending
to a VAX system. Otherwise, the setting should be No IGDS.
File name — This field reflects the name of the file to be sent. You can either select
the desired file from the list, or key in the appropriate name.
Remote node name/address — This field expects the node name or address of the
machine to which you want to send the file.
Remote path directory — This field expects the path on the remote machine to which
you want to send the file.
Username on remote node — This field expects the username on the receiving
machine.
Password — This field expects the password that corresponds with given username on
the receiving machine. The password may or may not be visible in the field, depending
on the setting of the Password Echo toggle.
83
________________
EE Raceway Modeling Reference Guide - February 2003
Receive
This option copies a file from a network node. Be sure to specify the complete filename,
including its extension. Also, specify the local path to the file; otherwise the file will be
placed in the <project_name>/eerway directory.
Receive will overwrite any file having the same name as the file you are receiving.
Field Descriptions
Password Echo toggle — The setting of this toggle determines whether the password
of the sending machine is visible or hidden upon keyin to the password field.
TCP/XNS Protocol toggle — The setting of this toggle determines whether the transfer
uses the TCP or XNS protocol to communicate between machines.
File name — This field reflects the name of the file to be received. You can either
select the desired file from the list, or key in the appropriate name.
Remote node name/address — This field expects the node name or address of the
machine from which you want to receive the file.
Remote path directory — This field expects the path on the remote machine from
which you want to receive the file.
Username on remote node — This field expects the username on the sending machine.
Password — This field expects the password that corresponds with given username on
the sending machine. The password may or may not be visible in the field, depending
on the setting of the Password Echo toggle.
84
________________ Receive
Local path (dgn, rpt, chk, tmp) — This field expects the path to the desired location
of the file being received.
Environment
4. EERWAY
85
________________
EE Raceway Modeling Reference Guide - February 2003
Archive
This option creates a backup copy of a file to a network node or to a floppy disk. Toggle
between Network and Floppy by selecting the toggle button. For more information about the
fields that display on the form when Network is active, see the description of Archive in
Archive, page 46 .
Field Descriptions
Password Echo toggle — The setting of this toggle determines whether the password
of the archiving machine is visible or hidden upon keyin to the password field.
TCP/XNS Protocol toggle — The setting of this toggle determines whether the
communication between machines uses the TCP or XNS protocol.
Network/Floppy toggle — The setting of this toggle determines if the file will be
archived over a network or to a floppy disk.
Archive file name — This field expects you to key in the desired name of the archive
file.
Remote node name/address — This field expects the node name or address of the
machine to which you want to archive the file.
Remote path directory — This field expects the path on the remote machine to which
you want to archive the file.
Username on remote node — This field expects the username on the receiving
machine.
Password — This field expects the password that corresponds with given username on
the remote machine. The password may or may not be visible in the field, depending
on the setting of the Password Echo toggle.
86
________________ Restore
Restore
This option copies a backup file from a network node or floppy disk. Use the
Network/Floppy toggle to select between the two options. For more information about the
fields that display on the form when Network is active, see the description of Restore in
Restore, page 48 .
This option will overwrite any file having the same name as the file you are
restoring.
Field Descriptions
Environment
4. EERWAY
Password Echo toggle — The setting of this toggle determines whether the password
of the archiving machine is visible or hidden upon keyin to the password field.
TCP/XNS Protocol toggle — The setting of this toggle determines whether the
communication between machines uses the TCP or XNS protocol.
Network/Floppy toggle — The setting of this toggle determines if the file will be
archived over a network or to a floppy disk.
Archive file name — This field expects you to key in the name of the archive file to be
restored.
Remote node name/address — This field expects the node name or address of the
machine from which you want to restore the archive file.
Remote path directory — This field expects the path on the remote machine from
which you want to restore the archive file.
87
________________
EE Raceway Modeling Reference Guide - February 2003
Username on remote node — This field expects the username on the remote machine.
Password — This field expects the password that corresponds with given username on
the remote machine. The password may or may not be visible in the field, depending
on the setting of the Password Echo toggle.
88
________________ Output
Output
This option sends files to the printer, screen, plotter, or laser printer. Invalid operations –
sending a drawing to the printer, for example – are not allowed. If you do not specify an
output destination, the selection displayed at the top of the list is the default selection.
Field Descriptions
Environment
4. EERWAY
File name — Key in the name of the file to be submitted to the output process, or select
it from the list.
89
________________
EE Raceway Modeling Reference Guide - February 2003
90
________________ EE Graphics Interface Elements
Start-Up Sequence
Screen Display
Identifying Elements
All of the EERWAY graphics commands are menu-driven. You will use the panel menus and
the bar menu to select the commands. By default, the panel menu is located on the right side
of your screen and the bar menu is at the top. You can also invoke commands by keying in
the command name and pressing <Return>. This chapter contains more detailed information
about using menus.
If you are not familiar with the following terms: command button <C>, data button <D>, or
reset button <R> in reference to the cursor or mouse, see Document Conventions in the
Preface to this document.
Graphics
5. EERWAY
91
________________
EE Raceway Modeling Reference Guide - February 2003
Start-up Sequence
When you enter an EERWAY design file (see
Design, page 63 ), the system goes through the following processes:
92
________________ Screen Display
Screen Display
The screen display you will see when you enter a design file is described below.
1. MicroStation Command Window - contains the following six fields that display
system messages and your inputs from the keyboard:
Graphics
5. EERWAY
— Window Menu Button - displays a list of window actions. Only the Lower and
Sink actions are available from the command window. To select an action, press
and hold the data button and move the cursor through the list. When the correct
item highlights, release the data button.
93
________________
EE Raceway Modeling Reference Guide - February 2003
— Sink Box - moves the command window below views and other windows of its
own type.
— Command Status Field - displays startup file information and product name.
— Current Command Field - displays the name of the current active command.
— Key-In Field - displays alphanumeric values you enter from the keyboard.
— System Prompt Field - displays a system prompt that directs you through a
command.
2. Command Menu Bar - contains the primary types of commands used in the EERWAY
graphic environment. Select the type of command you want to use with a data point to
see the pull-down menu of available commands or command palettes.
3. Working Area - displays elements as you place them. All your design work occurs in
the screen working area.
4. Windows - provide ways for you to change the way you look at your design. The
number and name of each view appears in the window title area.
94
________________ Screen Display
Size - changes the height and width of the window in the direction indicated by
the pointer.
Maximize - enlarges a window to its maximum size. If you select this entry on a
window that is already at its maximum size, the window is restored to its
previous size and location.
Maximize Button - enlarges a window to its maximum size. If you select the
maximize button on a window that is already at its maximum size, the window is
restored to its previous size and location.
Move Arrows - appear when the cursor is placed over the window border. Press and
hold the data button to move the window.
Vertical Arrows - appear when the cursor is placed at the top or bottom border. Press
and hold the data button to change the height of the window as you move the cursor.
Horizontal Arrows - appear when the cursor is placed at the left or right border. Press
and hold the data button to change the width of the window as you move the cursor.
Graphics
5. EERWAY
Diagonal Arrows - appear when the cursor is placed at the border corners. Press and
hold the data button to change both the height and width of the window without
changing the position of the opposite corner.
95
________________
EE Raceway Modeling Reference Guide - February 2003
To select a keyword, place the cursor over the button and press <D>.
For instance, selecting File initializes the File pull-down menu, which allows access to the
following commands:
Bar Commands - Invokes the Bar Commands palette, which allows access to the most
frequently-used MicroStation commands.
Exit - Executes the File Design command, and exits the graphics environment to return
control to the EE Raceway menu interface.
96
________________ Palettes in the EE Raceway Graphics Environment
Next to each icon is the name of the form or command it represents. You should become
familiar with the name and functionality of each command on each palette. Each command is
described in full in later sections of this text.
EERWAY
This palette is activated by selecting File from the MicroStation command window, then
selecting EERWAY from the resulting menu.
Integrated Commands
This palette is activated by selecting File from the MicroStation command window, then
selecting Integrated Commands > Palette from the resulting menu.
Graphics
5. EERWAY
97
________________
EE Raceway Modeling Reference Guide - February 2003
Bar Commands
This palette is activated by selecting File from the MicroStation command window, then
selecting Bar Commands from the resulting menu. This palette contains the MicroStation
commands as discussed in the MicroStation documentation.
Modify Element
This palette is activated by selecting Modify Element from the EERWAY palette, or it can
be activated by selecting Modify Element from the Modify palette as shown later in this
section.
This palette can also be activated by selecting Modify from the MicroStation command
window, then selecting Modify Element Commands from Modify menu, then selecting
Palette.
98
________________ Palettes in the EE Raceway Graphics Environment
Design
This palette is activated by selecting Design from the MicroStation command window, then
selecting Palette from the resulting menu.
Modify
This palette is activated by selecting Design from the MicroStation command window, then
selecting Modify from the resulting menu.
Graphics
5. EERWAY
99
________________
EE Raceway Modeling Reference Guide - February 2003
Modify Group
This palette is activated by selecting Modify Group from the Modify Palette. You can also
activate this palette by selecting Modify from the MicroStation command window, then
selecting Modify Group Commands, then selecting Palette.
Setup Commands
This palette is activated by selecting Setup from the MicroStation command window, then
selecting Palette.
100
________________ Palettes in the EE Raceway Graphics Environment
Model Commands
This palette is activated by selecting Model Commands from the Setup Commands palette.
Runtime Setup
This palette is activated by selecting Runtime from the MicroStation command window, then
selecting Palette.
Graphics
5. EERWAY
101
________________
EE Raceway Modeling Reference Guide - February 2003
Utilities
This palette is activated by selecting Utilities from the MicroStation command window, then
selecting Palette.
Database
This palette is activated by selecting Database from the MicroStation command window, then
selecting Palette.
102
________________ Identifying Elements
Identifying Elements
Any structure, line, or shape you place is called an element. In many commands, you must
identify an element to perform certain manipulations.
To identify an element, place a data point on it. The system highlights the element. If the
correct element highlights, press <D> again to accept the element. If there is more than one
element in the location you want to identify, the wrong element may highlight. If the wrong
element highlights, press <R> to reject that element. The system then highlights another
element.
When you are moving an element, one data point can serve more than one function in the
same command. For example, the point you place to accept the element becomes the point
from which the element is moved. Several of the command descriptions include steps where
the accepting data point also serves as the placement point.
Graphics
5. EERWAY
103
________________
EE Raceway Modeling Reference Guide - February 2003
Precision key-ins let you accurately place elements by using a working units system based on
Master Units, Subunits, and Positional Units, also known as MU:SU:PU. You must
understand the MU:SU:PU system before you can use precision key-ins.
Working units are coordinate units corresponding to the position and definition of a point in
the design file. The working unit dictates the degree of accuracy for placement of elements in
a drawing and determines the scale relationship of elements in the design. The following
explains the format of MU:SU:PU.
PU — Positional Unit, the smallest degree of accuracy that is possible in the design file
(a fraction of an inch)
In EERWAY, predetermined values for working units in imperial and metric projects were
used to create the delivered cell library. If using this cell library, we recommend that you use
these default settings:
While these are the suggested working units for delivered cell libraries, you are
not limited to using only them. You may set your working units to any desired
value, if a user-created cell library is being used. (See your system manager for
more information about the working units settings used at your location.)
104
________________ Working Units and Precision Key-ins
Below are some examples of values and how to key them in:
1/2 foot
= :6 (6 subunits)
1/2 inch
18 inches
Precision Key-ins
Precision key-ins let you place points accurately to create elements and shapes with exact
lengths and areas. You specify a distance and an angle from the last point placed, or you can
specify the delta values in X and Y to place another point. Key-ins are entered through the
alphanumeric keyboard.
DL= (delta coordinates) To place a precision point, key in the delta x and delta y in
MU:SU:PU that you want the point to be placed. The new point is placed relative to the
previous point. For example, if you want to place a point 18 inches over and 18 inches
up, key in DX=1:6,1:6.
Graphics
5. EERWAY
XY= (absolute coordinates) To place a precision point, key in its absolute x and y
coordinates.
105
________________
EE Raceway Modeling Reference Guide - February 2003
106
________________ Workflow and Procedures
6. Workflow
This section describes the overall workflow of EE Raceway Modeling software, as an operator
would typically use it. This includes setting up the design file, creating a raceway model, and
running reports and processes on the file. Preparation for the application or system manager
is described in System/Application Manager Information, page 415 .
EE Databases
Reports
Interference detection
Because the steps of the workflow are covered in detail elsewhere in the
document, this section will refer you to other documentation wherever
possible.
107
________________
EE Raceway Modeling Reference Guide - February 2003
Typically you begin drawing raceways with one-line elements (one-lines). These one-line
drawings are the centerlines of raceways and through propagation become the three-
dimensional shapes (three-lines) that occupy the volume of the raceways. EE Raceway
Modeling software allows you to place one-lines and then propagate them into three-lines or
raceways.
The figure below displays one-line elements on the left. On the right are the same elements
after propagation.
This section is divided into individual descriptions of the steps involved in the drawing
process. In general, you should perform these steps in the order in which they are described.
The following steps comprise the drawing process and this section:
Drawing setup
Place one-lines
Propagation
108
________________ System Manager Setup
6. Workflow
Before you begin an individual drawing, the system/application manager should determine the
defaults and parameters that will affect your project and drawing (tray sizes, for example).
The system manager must also add vendor catalogs (parts, specifications, and vendor names)
and the desired systems and one-line types to the reference database (see
Specification, page 507 for information about adding specifications to the database).
You can review the default and parameters settings while in the design file, using the Set
Raceway Defaults command (see the section entitled Setup Commands for information about
this command). Your system manager should also tell you the project name and design
filename.
For additional system manager information, see the appendix entitled System/Application
Manager Information and the section entitled Installation Instructions.
109
________________
EE Raceway Modeling Reference Guide - February 2003
Drawing Setup
Use the Define System command to define your system(s) for the design file from the
reference database. The command displays all systems available in the reference database. If
you need systems not available to you, ask the system manager to add them to reference
database. See Define System, page 258 for more information.
Then, use the Set Active System command to specify the system you want active as you are
drawing raceways. You can change the active system throughout the design session. See
Set Active System, page 295 for more information.
Use the Define One-Line Type command to define one-line types for the design file from the
reference database. The command displays all one-line types available in the reference
database. If you need one-line types that are not available to you, ask the system manager to
add them to the reference database. See
Define One-Line Type, page 260 for more information.
Then, use the Set Active One-Line Type command to specify the one-line type you want
active as you are drawing raceways. You can change the active one-line type throughout your
drawing session. See Set Active One-Line Type, page 294 for more information.
Set Symbology
Once you have defined your systems and one-line types, you can change the default
symbology settings for them. Doing so involves two commands: Set Symbology Control
and Symbology Control.
Use the Set Symbology Control command to define the matrix of systems and one-line types
for the design’s symbology control. See Set Symbology Control, page 262 for more
information.
Use the Symbology Control command to review and modify the symbology settings for
those systems and one-line types you selected with the Set Symbology Control command.
You can also review and modify the default symbology settings with this command. See
Symbology Control, page 264 for more information.
110
________________ Drawing Setup
6. Workflow
Each one-line type has its own set of parameters or catalogs. As you place one-line segments,
you are also placing the data associated with that one-line type in the reference database into
the design file for loading later into the project database. To review and modify this data you
will use the Set Active One-Line Parameters command. See Set Active One-Line Type
Parameters, page 289 for more information.
111
________________
EE Raceway Modeling Reference Guide - February 2003
Place One-Line
You will place all one-lines, regardless of type, using the Place One-Line or Place Manual
Fitting commands, and the Precision Input form. See
Place One-Line, page 132 ; Place Manual Fitting, page 147 ; and
Precision Input Form, page 119 for more information on these commands. To draw a
raceway, first place one-line segments (centerlines) in connected groups called runs. A run is
a group of connected segments that do not branch or change specification. initially in
phantom mode, placing tentative segments, until you accept them with the Accept option on
the Precision Input form. If not accepted, a phantom run disappears.
When you accept the run, it becomes a permanent part of the design file (unless you later
choose to delete it). An accepted run has a Raceway Connect Point (RCP) attached to each
end of the run. Each run has a cross section on each end depicting the type of raceway and its
orientation (for trays and wireways).
Once you place and accept a run, you can continue placing one-lines. See Design
Commands, page 129 for a description of the Place One-Line command.
112
________________ Propagation
Propagation
6. Workflow
A one-dimensional raceway is composed of one-line segments. To convert this one-
dimensional view of the raceway to a three-dimensional view, use the Propagate command,
see Propagate Element, page 194 for more information.
When you propagate a one-line segment into a three-line element, the three-line element’s
shape is determined by the one-line type (tray, for example). The length of each three-line
segment is determined by the length of the one-line, and the width and height (or diameter) of
a segment are determined by the active parameters when you placed the one-line. The default
fitting radius determines the radius of any bends between raceway segments. This radius is
used to propagate fittings between straight segments.
Sketch: In sketch mode, one-lines are propagated into three-lines based on the cross section
and the radius, extension, and transition information stored for the one-lines and RCPs.
Sketch is the quicker mode of propagation for two reasons. First, all information necessary
for sketching the three-line is stored in the design file, so reference database access is not
required. Second, the three-dimensional elements are drawn in-line without accessing the
Eden symbol library.
Sketch propagation places the sketched fittings based on the environment in which the one-
lines come together. For example, where two tray sections come together at a 90 degree
angle, propagation will automatically sketch a 90 degree elbow.
Eden: In Eden mode, one-lines are propagated into three-lines based on the specification
information. The system analyzes the environment in which the one-lines meet when
determining the type of fitting to place. It then searches the database for the appropriate part
for the proper specification. Once found, the specification dimensions and part information
are sent to the Eden symbol library where the symbol is generated.
While this mode of propagation is considerably slower than sketch, it allows you to define the
shape of your fittings. For example, EE Raceway provides rounded tray elbows. If you
require mitred elbows for production, you can define the fitting through Eden. Eden
propagation allows you greater detail and accuracy in three-dimensional fitting design. This
may be particularly useful for later interference detection.
113
________________
EE Raceway Modeling Reference Guide - February 2003
Fittings placed through the manual placement command are Eden symbols. Any
repropagation of such fittings will yield the same Eden symbols as well, regardless of the
active propagation mode. This ensures that fittings will always be repropagated with the same
orientation, definition, and specification.
After propagation (whether performed in sketch or Eden mode), the one-line elements remain
in the design file. You can turn off the one-line levels for display and plotting purposes.
To highlight errors that occur during propagation, select the Highlight Propagation Errors
command, see
Highlight Propagation Errors, page 314 . For a detailed description of these error messages,
see
Error Messages, page 377 .
114
________________ Databases
Databases
6. Workflow
A basic understanding of EE Raceway databases is necessary for efficient use of the software.
For the purposes of this discussion, a database is a collection of information about raceway
models. There are two databases that can be associated with your drawing: the reference
database and the project database.
Reference Database
A large amount of annotation is used in raceway models. Much of this annotation is
repetitious and not unique to any element in the drawing. The EE Raceway reference
database provides a simple method for generating this repetitious annotation. The reference
database automatically supplies default annotation values for the project database. (The
system manager may customize these values.) You can also add this information to this
drawing using the Annotate Element command.
The default annotation can be associated with RCPs, one-lines, three-lines, and title blocks.
For title blocks, the default can be unique for each title block cell. The Raceway parameter
information is supplied from the vendor catalog in the reference database, using the
annotation forms.
Override Keys
EE Raceway supports EE reference database override keys. The override key gives you the
ability to add to and/or modify default database information for RCPs, one-lines, three-lines,
and title blocks. The override key acts as a pointer to a row of data in the EE reference
database. The default annotation information, supplied by the reference database, can now be
overridden by specifying another valid database key.
The Annotate Element command is used to place and modify the override key linkages. The
form that displays with this command contains the reference database key value in a separate
field below the annotation input area (see Annotate Element, page 178 ). You can both key in
override values and display different annotation information.
Project Database
The project database contains information about all the particular elements (RCPs, one-lines,
three-lines, title blocks) in each drawing in a project. The project database is normally created
when the project is created. (The project database can be created any time before the Load
Database process is run.) It will contain information about a particular drawing only after the
Load Database process has been run on that drawing. Once the project database is loaded,
you can report on this information using the reports available through the EE Raceway
Drawing Menu.
115
________________
EE Raceway Modeling Reference Guide - February 2003
With the addition of RIS to the EE Raceway product, a distinction is now made between
schema and database. The database is the file where the non-graphic drawing data (one-
lines, three-lines, etc.) are stored. A schema is a RIS-specific file that contains a description
of the columns and tables of the database, and also identifies which users will be allowed to
use the database.
116
________________ Reports
Reports
6. Workflow
Currently, there are several reports delivered with the EE Raceway Modeling software: four
standard reports and a rule check report. You can access these reports from the EE Raceway
Drawing Menu by selecting the Report option. These reports run on the project and reference
databases.
See Electrical Engineer (EE) Raceway Environment, page 59 for general information about
running reports. For more detailed information about the individual reports, see Reports,
page 545 .
117
________________
EE Raceway Modeling Reference Guide - February 2003
Interference Detection
Interference detection is processed through Plant Design software. However, the EE
Raceway Modeling product creates an envelope file for input to the Plant Design interference
detection task.
You will use the Interference Detection Envelope File Creation process to create the
envelope file needed for interference detection. This process reads the design file and then
creates a data file that contains envelopes (spaces in which valid raceway shapes reside).
See Create Interference Envelope (default name), page 342 for more information about the
Interference Detection process.
118
________________ Precision Input Form
Input
7. Precision
Identify an absolute point
When you select a command from the menu, a precision input form displays and remains in
view as long as you are working in the command. This section describes each button and
field available on the precision input form.
Several designs of the precision input form are delivered with EE Raceway.
See System/Application Manager Information, page 415 for instructions
about changing the form design.
119
________________
EE Raceway Modeling Reference Guide - February 2003
View
This field displays the active working view. The displayed view determines the orientation of
the elements you are placing in the design. The orientation of elements is most visible when
placing annotation.
To change the displayed working view, select the field, and scroll through the available views
until the appropriate view displays.
Maximize/Minimize
Enlarges the form to its maximum size or reduces the form to its normal size.
Cancel
Terminates the active command, while collapsing the precision input form. You can exit a
command at any point by selecting Cancel.
Reject
Enters a negative response to an active prompt. It can also reset a current command action by
one step. In most cases, Reject performs the same actions as pressing <R>.
Accept
Enters an affirmative response to an active prompt. It also accepts any information you have
entered through the form, and prompts the system to continue to the next step. In most cases,
Accept performs the same actions as pressing <D>.
120
________________ Precision Input Form
Move/Move To Toggle
Used to specify a delta distance or absolute coordinates, and direction. A
set of directional buttons accompanies each option. Both options accept
key-in for distance, while only Move To accepts a data point for input.
The Move (delta move) toggle allows you to specify the distance and
direction to place an active point. Using Move, you will select a directional
button and key in a distance to place a point. For example, by selecting
North and keying in 20, you move to a point that is 20 master units north
of the original active point.
Input
7. Precision
The Move To (absolute move) toggle allows you to place an active point at
an exact coordinate. Using Move To, you will select a directional button
and key in an absolute coordinate. For example, by selecting North and
keying in 20, you move to a point that is at coordinate 20 (in master units)
in the north direction.
Display Fields
Displays some of your active parameters and general messages. The top field displays the
active system and one-line type. The middle field displays the active one-line type
specification description. The bottom field displays various precision input messages.
The Active Point Coordinates display shows the coordinates of the active segment point.
The coordinates display in the following order:
East/West
North/South
Elevation
The following two options are only available when placing ductbanks.
121
________________
EE Raceway Modeling Reference Guide - February 2003
Justification Point
The justification point defines the location of the three-line duct bank graphic in relation to
the one-line graphic. Three justification points are available: lower left, lower center, and
lower right.
By using the justification point and the height and width option described below, you can
build duct bank elements similar to the one shown below.
These fields are used to define a ductbank element’s dimensions during placement.
122
________________ Construct Point
Construct Point
This command specifies a series of movement options before accepting the shortest distance
to the displayed location. In Construct Point mode, you can route segments non-
orthogonally. You may place as many points as you want in this mode, but they are only
tentative until you select the Accept button. If you do select Accept, only the coordinates of
the last point you placed are accepted by the command. Selecting the Reject button
discontinues the command and returns you to the last point you placed before entering
Construct Point mode.
Input
7. Precision
This command identifies a midpoint or any point on a segment at which to place an active
point. When you select the command, a toggle displays with the following options:
The Any Point option allows you to identify either end of a segment
and then specify a distance along that segment at which to place a
point. The operating sequence for the Any Point option is:
— OR —
123
________________
EE Raceway Modeling Reference Guide - February 2003
— OR —
5. Specify Distance
Key in the distance from the reference point to the point you
want to enter, and select Accept.
— OR —
— OR —
124
________________ Extend/Reduce Run
Extend/Reduce Run
The Extend/Reduce Run command allows you to extend or reduce the length of an
upcoming run by the value you specify. The command accepts as values the height and width
of the active one-line type (as defined in its specification), or any distance you key in.
You cannot use this command to place a first point. You must already have defined an active
point to establish the active direction before using Extend/Reduce Run.
Input
7. Precision
upcoming run by the value you specify.
When you select the Height or Width buttons, the Full/Half toggle
displays. Using the toggle, you can enter the full height/width of the
active one-line type, or half the height/width of the active one-line
type as the distance by which to extend the run. The distance
displays at the bottom of the form. Only after you select Accept will
the system extend the upcoming run by the displayed distance.
When you select the Distance button, you must key in a value by
which to extend the run. The distance you key in displays at the
bottom of the form. Only after you select Accept will the system
extend the run by the displayed distance.
When you select the Height or Width buttons, the Full/Half toggle
displays. Using the toggle, you can enter the full height/width of the
active one-line type, or half the height/width of the active one-line
type as the distance by which to reduce the run. The distance
displays at the bottom of the form. Only after you select Accept will
the system reduce the upcoming run by the displayed distance.
When you select the Distance button, you must key in a value by
which to reduce the run. The distance you key in displays in master
units at the bottom of the form. Only after you select Accept will
the system reduce the run by the displayed distance.
125
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Distance and Direction command from the main precision input form.
The Distance and Direction form displays. The coordinates of the active point and the
angles of the active direction are displayed on the form.
2. Specify Distance/Direction
Distance - Define the true length from the active point in the direction to be
defined.
Move to - These options define the absolute coordinate for the point in the
direction to be defined. Select the direction and key in the absolute coordinate or
snap to an element to retrieve its corresponding coordinate.
Move - These options define the change in the selected coordinate for the point in
the direction entered.
3. You can define the direction from the active point one of two ways:
Active Direction - The direction is defined by the active horizontal and vertical
angles initially displayed.
Angles - Key in the horizontal angle and the vertical angle in decimal degrees.
Negative values are acceptable.
126
________________ Distance and Direction
Input
7. Precision
vertical angles.
The vertical angle is measured up or down from the horizontal plane of the active point.
Select the Process button to accept the displayed distance and direction and return to
the main Precision Input form.
— OR —
Select the Reset button or press <R> to reject the distance and direction option and
return to the main Precision Input form.
— OR —
Runtime Setup
The Runtime Setup command is used to define, modify, and review the active drawing
parameters in your design file. See
Runtime Setup Commands, page 287 for more information on the available commands.
127
________________
EE Raceway Modeling Reference Guide - February 2003
128
________________ Design Commands
8. Design Commands
The Design palette is activated by selecting Design from the EERWAY Command Menu Bar,
then selecting Palette from the resulting pull-down menu.
The commands on this palette place raceway elements – one-lines, manual fittings, raceway
connect points (RCPs), drop points, and equipment pointer symbols – in the design file. You
can also use these commands to enter an active point, change the active design parameters,
rotate cross sections, and size conduit and duct banks. There are also commands available for
routing one-lines around vessels and for inserting vertices in an existing one-line.
Commands
8. Design
Place One-Line — Places the centerlines of raceway elements.
Route Around Vessel — Routes elements parallel to an arc, circle, and right cylinder.
Insert RCP — Places a raceway connect point (RCP) in your raceway model.
Rotate Cross Section — Rotates a cross section at the current cross section angle.
Place Drop Point — Places a drop point symbol in the design file.
Place Equipment Pointer — Places an equipment pointer symbol in the design file.
Set Active Parameters — Sets the active parameters in the design file based on an
identified one-line or RCP.
Place Manual Fitting — Places a manual fitting in the design file at the specified
orientation and location.
129
________________
EE Raceway Modeling Reference Guide - February 2003
Conduit Sizing — Sizes conduit by "placing" cables in the conduit to determine the percent
fill.
Place Field Routed Raceway — Places short raceway sections from the raceway model to
equipment. These sections represent raceway components that are field routed by the
installer.
Define Duct Cross Section — Defines the cross section configuration of the contained
conduit for an underground conduit duct bank.
130
________________ Using the Design Commands
You must have conduit one-lines placed in the design file before you can use the Conduit
Sizing command. Likewise, you must have ductbank one-lines placed before you can use the
Define Duct Cross Section command.
8. Design
You must be familiar with precision input and its functions before using any of the Design
commands, because it is through the Precision Input form that you will enter values for the
placement of points and for the location of raceway elements. For detailed information about
precision input, see
Precision Input Form, page 119 .
Group Workflow
There is no required or suggested sequence for using the commands in this group.
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
131
________________
EE Raceway Modeling Reference Guide - February 2003
Place One-Line
This command places the centerlines of raceway elements based on points you give it. The
active one-line type determines the type of one-line you place (tray, conduit, and so forth),
while the active system determines the system to which the one-line belongs. Active raceway
parameters supply the default data associated with each one-line segment as you sketch.
One-line routes begin and terminate with a raceway connect point (RCP). RCPs are required
when you are changing the system, one-line type, or specifications of a one-line, or when you
place a fitting. Whenever you begin or terminate a one-line segment, you will have at least
one of five possible routing options. The following list describes each routing option in
detail:
New RCP — If you do not identify a one-line or RCP for the beginning and/or
termination point, the system places a new RCP and routes the one-line from/to the
RCP. Any one-line segment you are placing in space, unattached to another element, is
new.
Break One-Line — If you identify a one-line for the beginning and/or termination
point, the system places a new RCP and breaks the existing one-line into two one-line
segments. These two segments will retain the systems, one-line type, raceway
parameters, and annotation of the original one-line.
Continue One-Line — If you identify an RCP for the beginning and/or termination
point, you can resume routing an existing one-line. You can also combine two existing
one-line segments using Continue.
Attach to RCP — If you identify an RCP for the beginning and/or termination point,
you can attach to an existing RCP. This allows you to use the existing RCP as a
beginning and/or termination point.
Connect to One-Line — If you identify either a one-line or an RCP for the beginning
and/or termination point, you can connect to an existing one-line. Connect will place a
drop point cell on the identified one-line at the point of identification. Drop points
establish connectivity between one-lines and RCPs where they are of different one-line
types.
Valid connections to one-lines are determined by the priority level assigned to each
one-line type in the database. The values are defined by the ee_priority_level
column in the ol_type table. One-line types with lower priority can only connect to
one-line types with higher priority. If the priority levels are equal between one-line
types, then connect will not be an option.
The chart below illustrates the parameters that are assigned to one-lines as you place or
modify them, based on every possible combination of routing options.
132
________________ Place One-Line
Active — Indicates that the one-line you are placing is assigned the active raceway
parameters.
Last — Indicates that the one-line you are placing is assigned the parameters of the last
one-line you identified.
8. Design
First — Indicates that the one-line you are placing is assigned the parameters of the
first one-line you identified.
You should keep the following points in mind when using the Place One-Line command:
If an RCP on the end of a one-line belongs to a manual fitting, the command will not
allow the continue option.
If you reject all routing options for the beginning and/or termination points of a one-
line, then the command places a new RCP by default. This allows RCPs to be placed
on top of one another without establishing connectivity, though it is not a recommended
practice.
If the beginning or termination action is break, attach, or continue, then the identified
one-line or RCP must have at least one system in common with the active systems.
If the beginning and termination actions are continue, then the two identified one-lines
must have all systems in common.
If the beginning or termination action is break, attach, or continue, then the identified
one-line must be of the same one-line type as the active one-line type.
133
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form. You must set an active one-line type and system in the design file. See
Set Active One-Line Type and Set Active System in Runtime Setup Commands, page 287 .
In addition, you should be familiar with the Set Raceway Defaults command (see Set
Raceway Defaults, page 256 ).
Steps
1. Select the Place One-Line command.
2. Begin entering points to sketch the one-lines. Refer to the description of routing
options at the beginning of this section to determine proper routing.
The system places cross sections and RCPs (if they do not already exist) on the ends of
the one-line.
Press <D> to accept the cross section rotation, and return to step 2.
The system saves the rotation and returns to the beginning of the command, prompting
you to Enter first data point.
— OR —
Press <R> to rotate the cross section by the rotation angle defined in Raceway
Defaults.
The system rotates the cross section and prompts you again to accept or continue
rotating it.
134
________________ Route Around Vessel
The route is attached to two terminating RCPs which may or may not have a fitting on them.
If the RCP has a fitting on it, the fitting angle will be used when routing off the RCP and
around the vessel. If the RCP does not have a fitting, the route will come off the RCP at a 90
degree angle to the one-line.
A fitting on the RCP can only have two attach points, such as an elbow. Wye
and tee fittings cannot be used.
8. Design
Before Using This Command
You can enter all values for the placement of points through a precision input form. Using the
form, you can locate elements, route one-lines, accept input, reject input, reset a command
action, and exit a command. You must be familiar with precision input and its functions
before using this command. For detailed information about precision input, see Precision
Input Form, page 119.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
135
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Route Around Vessel command.
Select the RCP where you want the route to begin and press <D> to accept it.
— OR —
Select the RCP on the other side of the vessel where you want the route to end and press
<D> to accept it.
— OR —
Press <R> to back up one step and respecify the first RCP.
Select the vessel (the arc, circle, or right cylinder element) between the RCPs, which
you want to route around and press <D> to accept it.
— OR —
Press <R> to back up one step and respecify the second RCP.
Key in the minimum distance, the closest, the route can be placed to the vessel. You
cannot key in a negative value.
The route is not placed at the minimum distance from the vessel all the
way around. The minimum distance key-in defines the closest the route
can come to the vessel.
If you want the route to maintain the minimum distance all the way
around the vessel, be sure that the distance from the RCPs to the vessel
is the same as the minimum distance you key in.
— OR —
Press <R> to back up one step and respecify the vessel to route around.
136
________________ Route Around Vessel
Key in the number of one-line segments to use when routing around the vessel. The
number of segments must be greater than one (two segments or more).
The route is calculated and the elements display on one side of the vessel.
— OR —
Press <R> to back up one step and key in a new minimum distance from vessel value.
7. Accept/reject
Press <D> to accept that the elements should be placed on that side of the vessel.
— OR —
Press <R> to place the elements on the other side of the vessel.
— OR —
Press <R> twice to back up one step and key in a new number of one-line segments.
8. Design
137
________________
EE Raceway Modeling Reference Guide - February 2003
Insert RCP
This command breaks an identified one-line in the design file and inserts a raceway connect
point (RCP).
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Insert RCP command from the menu.
The system highlights a valid one-line. If you do not locate an acceptable one-line
element, the system displays the message Element not found. The message
disappears when you identify a valid element.
138
________________ Insert RCP
If you accept the one-line, the command inserts the RCP as specified.
— OR —
If you reject the one-line, the system prompts you to identify another. Go to Step 2.
— OR —
8. Design
139
________________
EE Raceway Modeling Reference Guide - February 2003
You can change the rotation angle in the EE Raceway Defaults form, see Set Raceway
Defaults, page 256 for more information.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Rotate Cross Section command.
Identify a cross section and accept it with a <D>. If you identified a duct bank cross
section, go to step 4. Otherwise continue to step 3.
140
________________ Rotate Cross Section
The system highlights a valid cross section. If you do not locate an acceptable element,
the system displays the message Element not found. The message disappears when
you identify a valid cross section.
— OR —
Press <D> to accept the current cross section orientation and exit the command.
If Automatic Propagation is on, the elements will repropagate at the new orientation
angle.
— OR —
The system rotates the cross section by the defined rotation angle. See Set Raceway
Defaults, page 256 for information about changing the angle of rotation.
8. Design
4. Select New Cross Section Justification
Select a new justification point from the precision input form and accept it.
141
________________
EE Raceway Modeling Reference Guide - February 2003
Valid connections to one-lines are determined by the priority level assigned to each one-line
type in the database. You can, for instance, establish connectivity between a piece of conduit
and a tray at the point where the cables drop out of the tray into the conduit. You can also
establish connectivity between two one-lines where graphic coincidence does not occur.
The point on the one-line where you place the drop point symbol defines the drop-out point.
If the drop point symbol is not on the one-line, the drop-out point will be calculated by
determining the closest point on the one-line to the drop point symbol.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Place Drop Point command.
The system highlights a valid RCP. If you do not locate an acceptable element, the
system displays the message Element not found. The message disappears when you
identify a valid RCP.
142
________________ Place Drop Point
— OR —
Identify a one-line in the design file. The identification point is the point at which the
system will place the drop point.
— OR —
8. Design
Accept/reject
The system places the drop point as specified, and returns you to the previous prompt.
— OR —
Go to step 4.
143
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Place Equipment Pointer command.
The system highlights a valid RCP. If you do not locate an acceptable element, the
system displays the message Element not found. The message disappears when you
identify a valid RCP.
— OR —
Place a data point at the desired location for the equipment pointer symbol.
— OR —
144
________________ Define Active Point
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
8. Design
1. Select the Define Active Point command.
Specify a data point in the design file where you want the active point to be.
The command makes the specified data point the active point, and exits the command.
145
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Set Active Parameters command.
— OR —
3. Accept/reject
The system sets the active one-line type, system, and one-line type parameters based on
the highlighted element. The command exits automatically.
— OR —
146
________________ Place Manual Fitting
You will use manual placement in situations where placing a sparse model will not be
sufficient or is not possible. For example, you may need to place fittings manually when
dealing with tight spaces, unusual angles, or fitting-to-fitting placement. You can place
special fittings (conduit bodies, pullboxes, and light fixtures) as well as spec driven fittings
(horizontal elbows, vertical tees, and so forth) using this command.
During placement, the location of a manual fitting is determined by the location of the active
point. If the active point lies in the vicinity of a fitting, the system locates the closest
attachment point on that fitting. If the new fitting and the existing one do not share the same
system and one-line type, then the system places the new fitting by itself. Such a fitting is
placed with its own RCP. When placing a straight section, or placing a fitting on the end of a
straight section, the system extends the one-line for that straight to terminate on the RCP of
the fitting. Otherwise, the new fitting is attached to the existing fitting and a one-line is
automatically placed.
When attaching a manual fitting to the placement point of another fitting (or a straight), the
8. Design
system derives the default orientation for placing the new fitting from the placement point.
147
________________
EE Raceway Modeling Reference Guide - February 2003
Commands
Define Active Point — Defines the active point in the design file for the placement of
fittings. If manual placement cannot locate a fitting, the previous orientation will be retained.
Otherwise, the command derives the orientation from the place point. See Define Active
Point, page 145 .
Set Active System — Displays the current active system and allows you to select a new
active system. See Set Active System, page 295 .
Set Active One-Line Type — Displays the current active one-line type and allows you to
select a new active one-line type. Selecting a new active one-line type updates the part
information elsewhere on the form. See Set Active One-Line Type, page 294 .
Set Active Parameters — Defines the active system, one-line type, and active one-line type
parameters in the design. Changing the active parameters updates the part information
elsewhere on the form. See Set Active Parameters, page 146 .
Field Descriptions
Type — Displays the active three-line type for the current specification. The list
contains all available three-line types (elbow, straight, wye, etc.) for that specification.
To change the displayed three-line type, select a value from the list. Modifying the
value in the Part field may also change the active and available Type values.
Subtype — Displays the active subtype for the displayed Type value. The list contains
all available subtypes (vertical, horizontal, inside vertical, etc.) for the active type and
subtype in the current specification. To change the displayed subtype, select a value
from the list. Modifying the value for Type also may change the active and available
subtypes.
Qualifier — Displays the active qualifier for the displayed Type and Subtype. The list
contains all available qualifiers (adjustable, rigid, etc.) for the active type and subtype in
the current specification. To change the displayed qualifier, select a value from the list.
Modifying Type or Subtype values may change the available qualifiers.
148
________________ Place Manual Fitting
Symbol — Displays the name of the Eden symbol you are placing. You can only
review the values in this field.
Angle — Displays the active angle associated with the Type, Subtype, and Qualifier
for the current specification. The list contains available angles. To change the
displayed angle, select an angle from the list or select the field, and key in the new
value.
Length — Displays the length by which to project a straight. If straight is not your
8. Design
active Type, the Length field does not display on the form. To change the displayed
length, select the field, and key in the new value.
Part — Displays the active part. The list contains all available parts for the current
specification. To change the displayed part, select a value from the list.
— OR —
Change any of the values for Type, Subtype, Qualifier, Spec1, (if applicable) Spec2,
or Angle (if applicable).
Spec1 — Displays the active specification for the displayed Type, Subtype, and
Qualifier. The list contains all available specifications. To change the displayed
specification, select a value from the list.
To display the specification itself, select the corresponding Display button. Doing so
displays a specification form.
149
________________
EE Raceway Modeling Reference Guide - February 2003
Column name - Displays the aliases of those columns in the database that are
associated with the specified type. You can only review the information in this column.
Column value - Displays the column name values currently associated with the
specified type. You can review and modify the values in this column. To change a
value, select the Override button. Then select the field, and key in a new value.
Select - Retrieves the row(s) from the specification table that meet the select criteria
defined in the form. If only one row matches this criteria, then the Column values fill
in with the matching row’s values. If more than one row matches the criteria, then a
second form, containing all matching rows, displays.
You can use certain relational operators as search criteria. For a list of
valid operators, see Annotate Element, page 178 .
Clear - Clears the Column values from the lower portion of the form, and then
automatically depresses the Override button so that you can select a different row(s)
from the specification.
Override - Allows you to override those columns whose access is Read Only (R). You
can activate the Override button by selecting it directly or by selecting the Clear
button, which automatically activates it.
Spec2 — Displays the active secondary specification, if any, for the given Spec1,
Type, Subtype, and Qualifier. The list contains all available secondary specifications
for the current settings. Secondary specifications are generally used with reducers.
You can display the current specification itself by selecting the Display button. Doing
so displays a specification form. See Spec1 for a description of the form.
Overrides from the secondary specification are not passed to the Eden
symbol.
Placepoint — Defines the point of attachment for the fitting you are currently placing.
To change the active placepoint, select the slide bar, and drag it along the scale until it
reaches the appropriate value.
150
________________ Place Manual Fitting
Automatic Size — Automatically selects the correct size fitting. You must specify the
manual fitting type before using the button.
The fitting size is determined by comparing the spec table nominal size of all one-lines
at the RCP and selecting the largest nominal size among them. That nominal size is
then compared to the fitting table nominal sizes. If in the fitting table there is a nominal
size the same as the largest one-line nominal size, then that fitting is used. If there is no
fitting of that nominal size, then the first fitting that is of greater nominal size than the
one-line nominal size is used. If there is no nominal size fitting larger than the one-line
nominal size, then the largest fitting available is used.
Automatic Fit — Re-orients the fitting in reference to the one-line it is associated with.
Angle - Defines the angle by which to rotate the orientation tee. To change the
displayed angle, select the field, and key in a new value.
About - Defines the axis about which to rotate the orientation tee. To change the
displayed axis, select the field, and toggle between the three axes (Primary,
Secondary, Normal) until the appropriate axis displays.
— OR —
8. Design
Identify the appropriate axis name (text) on the orientation matrix diagram (to the right
of the Angle and About fields.)
I Button — Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis, and
the Normal axis with the positive Z axis.
If you set the Driven By Spec/Table toggle to Table, the Place Manual Fitting form
displays.
151
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Table — Displays the active special part table from the database. The list contains the
available special part tables from the database. To change the active special part table,
select a table name from the list.
Attribute — The next four display lists on the form are the first four Part Key
attributes from the active table and will change depending on which Table is active.
The attribute display lists are used to interactively query the database for the desired
Part Key.
For example, you set the active Table to cond_body. size, type, material, and vendor
display as the active attributes. Each attribute displays only those values that have
corresponding matching values for the other three attributes in the database. In other
words, if you set material to feraloy, vendor to 3, and size to 1/2 inch, then only those
types that are 1/2 inch in size from vendor 3 and made of feraloy will be displayed in
the types list. Similarly, if you set type to form 7c, material to feraloy, and vendor to
3, then only the sizes the form 7c comes in, made of feraloy from vendor 3, will be
displayed in the size list.
Select/All toggles — Overrides the interactive queries of the attribute fields. When set
to All, all available values for that attribute are displayed in the list, regardless of the
other attribute settings.
Part Key — Displays the current part for the displayed Table that matches the attribute
values. Modifying the Table value also changes the active and available Part values.
You can display the current table information for the part by selecting the Display
button.
See the description of the Spec1 field earlier in this section for detailed information
about the form parameters.
152
________________ Place Manual Fitting
When deciding whether your fitting information will come from a specification or from a
table in the database, you should first consider a few points. Specification-driven fittings rely
on the specification information (width, height, radius, etc.) to construct the three-line
symbols. All parts of a given specification will inherit the attributes of that specification. On
the other hand, some fittings derive their information from their own database tables because
they are not so easily classified into a common group of parts. Such fittings are called special
parts. The following table indicates fittings that are specification-driven and those that are
special parts:
straight pullbox
elbow conduit body
wye light fixture
cross
dropout
8. Design
Steps
1. Select the Place Manual Fitting command.
To derive fitting attributes from a specification in the database, set the toggle to Driven
By Spec.
— OR —
To derive fitting attributes from a special part table in the database, set the toggle to
Driven By Table. Go to step 4.
3. Change fitting descriptions, orientations, and location until the desired fitting is seen in
dynamics (phantom mode) in the design file.
4. Select Accept to accept the fitting with the current settings, orientation, and location.
The system accepts the fitting at the specified location and orientation.
153
________________
EE Raceway Modeling Reference Guide - February 2003
— OR —
154
________________ Conduit Sizing
Conduit Sizing
This command places cables (wires) in a conduit to determine the correct conduit size based
on the conduit’s percent fill calculation.
8. Design
155
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Column Alias — Displays the column aliases for each column in the database table.
Value — Select and key in values to use as search criteria to find corresponding cables
in the database. This command also accepts certain relational operators as search
criteria. You should be familiar with the following operators:
= equal to numeric This is the default operator. If you do not enter another
operator, the system assumes =.
> greater than numeric This operator indicates that the queried values should
be greater than the given value.
< less than numeric This operator indicates that the queried values should
be less than the given value.
>= greater than numeric This operator indicates that the queried values should
or equal to be greater than or equal to the given value.
<= less than or numeric This operator indicates that the queried values should
equal to be less than or equal to the given value.
!= not equal to numeric This operator indicates that the queried values should
NOT be equal to the given value.
% wild card CHAR This operator is a wild card, representing zero or more
characters. The queried values must have every
character aside from the % in common with the given
value.
Code List — Indicates whether a Value has an associated code list. A code list is a list
of valid database values for that Column Alias. If an * displays in the column, then the
Value has an associated code list. To display the code list, select the *.
156
________________ Field Descriptions
Process Query — Queries the database to find cables matching the search criteria
defined in the Value fields. If only one cable is found that matches the criteria, it is
added to the conduit. If more than one cable matches the search criteria, the Pseudo-
Cable form displays, from which you can select a cable or cables to route in the
conduit.
Increase Size ONLY / Increase/Decrease size — Defines how the conduit should be
sized. There are two methods to choose from:
— Increase Size ONLY - When a conduit is calculated to be full, the next size larger
conduit in the spec table is used until an adequately sized conduit is found.
8. Design
— Increase/Decrease size - The smallest conduit available in the spec that meets the
percent fill criteria is used.
Percent Fill — Displays how full the conduit is as a percentage. The field displays in
red and the message Warning: Percent Fill exceeds maximum allowed displays
when the conduit has reached its capacity as defined by the electrical code you are
using. The Percent Fill calculation is based on the conduit’s cross-sectional area
divided by the summation of all of that conduit’s cables’ cross-sectional areas.
Selected Cables — Displays information on all cables that have been selected to go in
the active conduit.
Select Conduit — Displays the Conduit Sizing precision input form. Using this form
you can select another conduit in which to route cables without having to exit the
command.
Copy Contents — Copies cables from a selected conduit into the active conduit. Any
cables in the active conduit before the copy are removed.
Append Contents — Adds cables from a selected conduit into the active conduit
leaving any cables in the active conduit there.
157
________________
EE Raceway Modeling Reference Guide - February 2003
Delete All Cables — Deletes all cables in the active conduit. This option is available
only when Remove Cable is selected.
Quantity — Defines the number of cables of that type. This field can be edited to take
positive integers other than zero (zero and blank are invalid entries).
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must use the Set Conduit Sizing Attributes command to define how the conduit sizes
will be selected. See Set Conduit Sizing Attributes, page 268 for more information.
Steps
1. Select the Conduit Sizing command.
2. Identify CONDUIT
3. Define the cables for the conduit. You can query the database and select them from the
form or copy them from a conduit that has "cable" in it.
4. Set the Increase size ONLY / Increase/Decrease size toggle to the sizing method you
want.
158
________________ Field Descriptions
If the largest size conduit available does not satisfy the percent fill calculation, a
warning message displays.
— OR —
Select Cancel to exit the command and ignore any changes you have made.
8. Design
159
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Insert One-Line Vertex command.
The point that identifies the one-line in this step is the point where the
vertex is inserted.
3. Accept/reject
The vertex is inserted. If Automatic Propagation is on, the one-line will repropagate
and the vertex will display with its cross-section.
— OR —
160
________________ Place Field Routed Raceway
8. Design
Field Descriptions
Column name — Displays the aliases for the columns (attributes) in the reference
schema that unique identify equipment. The column names reside in the ee_unique
table in the reference schema. This field is informational only.
Column value — Defines a value for the corresponding equipment identifying attribute
in the Column name field. To change the value, select the field and key in the new
value.
Display — Enables or disables the annotation of the Column value. When on, the
value is displayed in the design. You are prompted to position the annotation after the
equipment pointer is placed in the design.
Keyin/Calculate — Defines the method for entering the distance from the beginning of
the placed one-line to the equipment (that is, field route length.)
When set to Keyin, you must key in the length in the Distance to equipment field.
The Distance to equipment specifies the field routed length (in subunits) of the placed
one-line. This length represents the estimated length of raceway to the equipment from
the beginning point of the placed one-line. To change the displayed length, select the
field and key in a new length.
161
________________
EE Raceway Modeling Reference Guide - February 2003
When the Keyin/Calculate toggle is set to Calculate, you are prompted to identify the
location of the equipment. The software calculates the orthogonal distance (that is, sum
of the x, y, z deltas) from the beginning of the placed one-line to the identified
equipment location. The calculated distance is stored with the one-line as field routed
length.
First Point & Orientation/Beginning & Ending Point — Defines the method for
entering the plant coordinates of the one-line element. When placing the one-line
element using the First Point & Orientation method the Rotate Orientation gadgets
display.
After specifying the orientation and the length of the one-line, you are prompted for the
first point (that is, placement point) of the one-line element.
When placing the one-line element using the Beginning & Ending Point method, you
are prompted for the beginning and ending plant coordinates of the one-line.
Angle — Defines the angle by which to rotate the orientation tee. To change the
displayed angle, select the field, and key in a new value.
About — Defines the axis about which to rotate the orientation tee. To change the
displayed axis, select the field, and toggle between the three axis (Primary, Secondary,
Normal) until the appropriate axis displays. Or you can identify the appropriate axis
name (text) on the orientation matrix diagram (to the right of the Angle and About
fields.)
I Button — Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis, and
the Normal axis with the positive Z axis.
Length of Placed Raceway Field — Displays the length by which to project the one-
line along the orientation tee from the first point. To change the displayed length, select
the field, and key in a new value.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
162
________________ Place Field Routed Raceway
Operator Sequence
1. Select the Place Field Routed Raceway command.
Identify a one-line element to which you want to connect the field routed raceway
section and accept it when it highlights.
— OR —
8. Design
163
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Button Matrix — Each button represents an area in the duct bank’s cross section that
extends the size of the duct bank. By assigning a conduit, cable or gap to a button, you
assign that area in the duct bank. All assigned buttons (areas) are then used to calculate
the duct bank’s cross section. Unassigned or unused buttons in the matrix are not used
in calculating the ductbank’s cross sectional size unless they are in the middle of
assigned buttons.
Copy section layout from — Copies an existing duct cross section layout from a
specified duct into the active duct.
164
________________ Define Duct Cross Section
Add — Assigns a conduit, cable or gap to a matrix button. A form displays all
available conduit/cables in the project database for the defined control number. The
conduit/cable identification will appear on the button after assignment.
8. Design
Control Number — Displays the control number to use for retrieving the conduit/cable
information from the project database. You can define any control number that is
loaded to the project database.
You define whether you are routing conduit or cables by setting the Duct toggle in the
EE Raceway Defaults form. See Set Raceway Defaults, page 256 for more
information.
Horizontal spacing — Defines the horizontal spacing between each button (area).
Vertical spacing — Defines the vertical spacing between each button (area).
Gap Distance — Defines a gap between two conduit/cables in the matrix. The gap is
measured from the center of the left conduit/cable to the center of the right
conduit/cable and can only be defined on the top row of buttons. The gap distance will
appear on the button after assignment.
165
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Define whether you are placing conduit or cables in the duct bank by setting the Duct toggle
in the EE Raceway Defaults form. Likewise, you can define a margin width, a space
between the button matrix and the outside of the ductbank in the EE Raceway Defaults form.
See
Set Raceway Defaults, page 256 for more information.
Steps
1. Select the Define Duct Cross Section command.
Select the duct bank element for which to define the cross section layout and accept it
with <D>.
4. Select Confirm (√) to exit the form and save your changes.
The duct bank section layout, all conduit/cable information, is assigned to the duct
one-line. The duct bank size is checked and resized as necessary, both width and
height. If Automatic Propagation is on, the duct bank will automatically repropagate.
— OR —
If you select Cancel after having modified the ductbank’s layout, a warning
form displays confirming that you want to exit without saving changes. If
you select Confirm (√) on the warning form, any changes you made will be
ignored. If you select Cancel on the warning form, you cancel your "exit
without saving" and are returned to the command.
166
________________ Place Stub Up
Place Stub Up
This command manipulates conduit stub ups. Stub ups are pieces of conduit associated with a
conduit or cable contained in an underground duct bank and are placed in the raceway model
for making above ground conduit connections. The stub up is connected to the corresponding
underground duct bank section by means of a drop point.
8. Design
Before Using this Command
You must define conduit as an available one-line type using the Define One-Line Type
command. See Define One-Line Type, page 260 .
You must define conduit as the active one-line type using the Set Active One-Line Type
command. See Set Active One-Line Type, page 294 .
You must define the conduit sizing attributes using the Set Conduit Sizing Attributes
command. See Set Conduit Sizing Attributes, page 268 .
You must define the duct cross section layout using the Define Duct Cross Section
command. See Define Duct Cross Section, page 164 .
You must select the a conduit specification using the Set Active One-Line Type Parameters
command. See Set Active One-Line Type Parameters, page 289 .
The conduit specification and the conduit sizing attributes (for example,
vendor, units, material) are used to determine the conduit stub up sizes
available.
167
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Button Matrix — Each button represents an area in the duct bank’s cross section that
has or has not been assigned during the Define Duct Cross Section command. This
matrix is used in the Change Association and Place Stub Up options to identify which
cross section (that is, conduit/cable) to manipulate.
Select Duct Segment — Selects an existing duct segment in the raceway model as the
active duct segment.
Change Association — Changes the association of a conduit stub up from the currently
associated conduit/cable to another conduit/cable in the active duct segment.
Place Stub Up — Places a conduit stub up in the raceway model associated with a
conduit/cable in the active duct segment.
Stub Up Size — After selecting the Place Stub Up button and selecting a
conduit/cable from the active duct segment, this field displays the associated conduit
stub up size. You can optionly override the displyed value by selecting a conduit stub
up size from the available sizes as determined by matching the conduit sizing attributes
to the active conduit specification.
If underground conduit routing is selected for this model, the size of stub up will be
retrieved from the conduit schedule table in project schema based upon conduit number
that user selected from matrix.
If underground cable routing is selected for this model or the conduit size is not defined
for the conduit number, you are required to select the desired size from the available
sizes. The displayed value is simply the value from the previous place stub up
selection.
Stub Up Length — Displays the conduit stub up length as measured in the model
master units (feet, meters) The user can optionally override the displayed value.
168
________________ Steps
Steps
1. Select the Place Stub Up command.
2. Select Option
— OR —
— OR —
— OR —
8. Design
— OR —
— OR —
The identified duct one-line’s cross section layout displays in the Button Matrix.
— OR —
169
________________
EE Raceway Modeling Reference Guide - February 2003
— OR —
Accept the highlighted element. It also deletes all cross sections, propagated elements,
annotation, and RCP’s that are associated with the selected one-line. Go to Step 7.
— OR —
Select stub up for modification. is displays in the form message field. The precision
input form displays.
— OR —
— OR —
170
________________ Steps
Go to Step 2.
— OR —
8. Design
Select location to place stub up. displays in the message field.
Place a data point at the desired location for the top of the conduit stub up. The system
places the stub up and connects it to the duct bank by means of a drop point located on
the duct bank one-line closest to the bottom of the conduit stub up.
Go to Step 14.
— OR —
— OR —
171
________________
EE Raceway Modeling Reference Guide - February 2003
172
________________ Modify Commands
9. Modify Commands
The Modify commands manipulate elements, such as RCPs, one-lines, and three-lines, within
the design file. Available element manipulations include copying, moving, deleting,
annotating, and propagation. You can elect to manipulate either single elements or those
elements belonging to an active group.
The Modify palette is activated by selecting Modify from the EERWAY Command Menu
Bar, then selecting Palette.
Commands
The commands on the Modify palette both activate other command palettes. These palettes
and their commands will be described in this chapter.
Modify Element Commands — Manipulate single elements within the design file.
9. Modify
Modify Group Commands — Define elements for inclusion in a group and
manipulate elements belonging to the active group.
173
________________
EE Raceway Modeling Reference Guide - February 2003
You must be familiar with precision input and its functions before using any of the Modify
commands, because it is through the Precision Input form that you will enter values for the
placement of points and for the location of raceway elements. For detailed information about
precision input, see
Precision Input Form, page 119 .
Group Workflow
There is no required or suggested sequence for the commands in this group.
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
174
________________ Modify Element Commands
The Modify Element commands manipulate individual elements, including RCPs, one-lines, and
three-lines, within the design file. You can use individual commands to move, copy, and delete
specified elements, to review or edit element annotation, and to check for duplicate one-lines and
coincident RCPs in the design file. Modify Element commands also allow you to propagate one-
lines in your raceway model.
Commands
Annotate Element — Places, reviews, and edits intelligent annotation for raceway elements.
9. Modify
Copy Element — Copies an element as specified within the design file.
Move One-Line Segment — Moves a one-line segment while maintaining connectivity to existing
elements.
175
________________
EE Raceway Modeling Reference Guide - February 2003
Edit/Insert Manual Fitting — Modifies fittings that were manually placed in the model.
Place Fitting by Rule — Places a non-standard fitting at an RCP using a set of rules defined in the
reference database.
Check Coincident RCPs — Checks for coincident RCPs in the design file.
Check Duplicate One-lines — Checks for duplicate or overlapping one-lines in the design file.
Delete Element — Removes a valid raceway element, and elements associated with it, from the
design file.
Remove RCP — Deletes a specified RCP (raceway connect point) from the design file.
Change System Parameters — Changes the system percentage and the project rule for a selected
element.
176
________________ Using the Modify Element Commands
You must be familiar with precision input and its functions before using any of the Modify
Element commands, because it is through the Precision Input form that you will enter values
for the placement of points and for the location of raceway elements. For detailed information
about precision input, see
Precision Input Form, page 119 .
Group Workflow
There is no required or suggested sequence for using the commands in this group.
9. Modify
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
177
________________
EE Raceway Modeling Reference Guide - February 2003
Annotate Element
This command places, reviews, and edits intelligent annotation for individual raceway
elements. By definition, intelligent annotation is recognized by the EE Raceway product and
can be added to an EE database. You can also add cosmetic text to a raceway model for
display purposes, though the product does not recognize such annotation nor can the product
add it to an EE database.
The Annotate Element command recognizes one-lines, three-lines, Raceway Connect Points
(RCP), straights, and fittings. For straights and fittings, you are allowed only to review the
annotation.
Using this command, you can change the specifications or sizes of raceway components.
The following graphic shows the Annotate Element form for an RCP.
The following graphic shows the Annotate Element form for a one-line.
178
________________ Field Descriptions
Field Descriptions
Column name — Displays the aliases for those columns in the database that are
associated with the specified element. The displayed columns reside in the mscolumns
table in the database. You can only review the Column name column information.
Column value — Displays the current value for the column whose alias displays in the
Column name field. You can review and modify the values in this field. To change
the values associated with the element, select the field, and key in the new value. You
can enter blank spaces into the design, using your keyboard space bar. Empty
<Return>s, however, enter nothing into the design. Entering a space or a text value for
an attribute will override that value in the reference database. To delete an override on
a reference database attribute, select the Column value field and delete the blank
character. Once you have deleted the override, a value will display in the field only if
the value can be retrieved from the reference database. Otherwise, the field remains
null.
If blanks exist for a field, the cursor will jump to the end of the blanks
when the field is tagged beyond value.
Source — Displays the source of the corresponding column value. If Ref displays in
the column, then the value derives from the reference database. If Dgn displays in the
column, then the value derives from the design file. If you change a column value, the
column displays New until you select Confirm (√) to save your changes. The next time
you enter the annotation form, the Source column will display either Ref or Dgn, where
New had displayed. Where UD displays in the column, the corresponding column
value comes from user data. When modified, the value is saved back to user data.
9. Modify
Access — Indicates whether or not you can manipulate a particular column value. If
you can view and modify (read and write) the column value, the Access column
displays a R/W. If you can only view (read) the column value, then it will display an
R. You can only review the information in this column.
Display On/Off — Enables or disables the graphic display for each column value.
Where the toggle is On, the value will display in the design where you place it. You
will be prompted to place displayed values when placing one-lines in the drawing.
Reference Database Key — This field allows you to insert an override key into the
reference database.
When you enter a new value in the EE Reference Database Key field, it becomes an
override key to the reference database.
The key field is updated, and corresponding database values are retrieved and displayed
on the annotation form. If the specified key does not exist in the reference database, an
error message displays and the annotation form returns to the previous values. Any
annotation you placed in the drawing will override the reference database defaults on
the form.
179
________________
EE Raceway Modeling Reference Guide - February 2003
If you delete the value in this field, a value will automatically redisplay if it can be
retrieved from the reference database. Otherwise, the field remains null.
If an override linkage is not present on a device or a title block, then the cell name or
the Default key will be used to locate default data. If the linkage is not present on a
connect point or one-line, the key specified in the user element is used. If no key exists
in the user element, the Default key is used. Once you place an override key on an
element, you can modify it, but cannot delete it.
To change the displayed value, select the field, and key in a new value.
Key Description — Displays the description from the reference database of the current
EE Reference Database Key. You can only review the information in this field.
The lower portion of the Active [One_Line Type] Parameters form displays a
specification table. The EE spec key field on the upper portion of the form is used as
the key for the Column name values on the lower portion of the form.
Select — Retrieves the row(s) from the specification table that meet the select criteria
defined in the form. The select criteria are those values that display in the Column
value column on the lower portion of the annotation form. You can use relational
operators when keying in your own select criteria. Available operators are described
later in this section.
If only one row matches the select criteria you provide, then the Column values fill in
with the matching row’s values. If more than one row matches the criteria, then a
second form containing all matching rows displays.
From this form you can select the row(s) containing the desired values. To add values
from the displayed specification table rows, select the row you want, and then select
Confirm (√). If you select Cancel (X), the system cancels the form and retrieves the
values from the EE spec key field on the original form.
Clear — Clears the Column values from the lower portion of the form, and then
automatically depresses the Override button to select a different row(s) from the
specification table. Clearing the column values allows you to key in new select criteria.
Override — This button allows you to override those columns whose access is Read
Only (R). You can activate the Override button by selecting it directly or by selecting
the Clear button, which automatically activates it.
180
________________ Field Descriptions
This command accepts certain relational operators as search criteria. You should be familiar
with the following operators:
= equal to numeric This is the default operator. If you do not enter another
operator, the system assumes =.
> greater than numeric This operator indicates that the queried values should be
greater than the given value.
< less than numeric This operator indicates that the queried values should be
less than the given value.
>= greater than numeric This operator indicates that the queried values should be
or equal to greater than or equal to the given value.
<= less than or numeric This operator indicates that the queried values should be
equal to less than or equal to the given value.
!= not equal to numeric This operator indicates that the queried values should
NOT be equal to the given value.
% wild card CHAR This operator is a wild card, representing zero or more
characters. The queried values must have every
character aside from the % in common with the given
value.
9. Modify
value.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
181
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Annotate Element command.
Identify the element to annotate (one-line, three-line, drop point, equipment pointer, or
RCP).
The system highlights the specified element. If you do not locate an acceptable element,
the system displays the message Element not found. The message disappears when
you identify a valid element.
— OR —
3. Accept/Reject
The annotation form displays when you accept the element. The form displays all the
current values associated with the element. It also identifies all the possible values
(column values) associated with this element.
— OR —
5. Select Confirm (√) to save your changes and exit the annotation form.
— OR —
Select Cancel (X) to exit the annotation form without saving your changes. Return to
Step 2.
The prompt indicates the column alias being placed. The column value displays in drag
mode attached to the cursor.
The new value displays in the design file. This step repeats for each new value. When
there are no more values to place, return to Step 2.
182
________________ Field Descriptions
Any value placed with the Annotate Element command will be entered
into the drawing and, optionally, displayed. When you load the project
database, these values are loaded into the project database.
When you annotate any raceway element, if you see graphics extending
into the next raceway element, repropagate all of the connected raceway
elements.
9. Modify
183
________________
EE Raceway Modeling Reference Guide - February 2003
Copy Element
This command copies raceway elements to specified locations within the design file. You can
use this command to copy one-lines and their associated elements. This command will copy a
single RCP provided that no one-lines are attached.
Equipment pointers and drop points cannot be copied using this command.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
184
________________ Steps
Steps
1. Select the Copy Element command.
Identify the one-line or RCP element you intend to copy and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable element,
the system displays the message Element not found. The message disappears when
you identify a valid element.
The system copies the element to the specified location in the design file.
— OR —
9. Modify
185
________________
EE Raceway Modeling Reference Guide - February 2003
Move Element
This command moves individual raceway elements as specified within the design file. You
can use this command to move one-lines, RCPs, drop points, equipment pointers, and
annotation. If an RCP is moved, all attached one-lines will be rerouted to the new position of
the RCP. All associated annotation, three-line fittings, and equipment pointers will also be
moved.
If a one-line is moved, all attached RCPs will be moved and all attached one-lines will be re-
routed to the new one-line position. All associated annotation, three-line fittings, and
equipment pointers will also be moved.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
186
________________ Steps
Steps
1. Select the Move Element command.
Identify the element you intend to move and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable element,
the system displays the message Element not found. The message disappears when
you identify a valid element.
— OR —
— OR —
9. Modify
187
________________
EE Raceway Modeling Reference Guide - February 2003
Clone Element
This command copies raceway elements multiple times to specified locations within the
design file. You can use this command to copy one-lines and their associated elements. This
command will copy a single RCP provided that no one-lines are attached.
Equipment pointers and drop points cannot be copied using this command.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
188
________________ Steps
Steps
1. Select the Clone Element command.
Identify the element you want to clone (copy) and accept it with <D>. The point you
identify the element with becomes the origin of the copy.
— OR —
A warning box displays verifying the number of times you want to clone the identified
element.
— OR —
Identify the location of the first copy. If you are placing more than one clone, each
9. Modify
successive clone is placed the same distance and direction from the previous clone as
the first clone is from the original element.
Return to step 2.
189
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
190
________________ Steps
Steps
1. Select the Move One-Line Segment command.
Select the one-line segment you want to move and accept it with <D>.
The point that identifies the one-line segment in this step will be
reference point used when placing the one-line segment at the new
location.
— OR —
Identify the new location of the one-line segment. Repeat this step.
— OR —
If you have the Automatic Propagation toggle set to on, the one-line will
automatically repropagate after the move. See
Propagation Setup, page 297 for more information on this toggle.
9. Modify
191
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Move One-Line Vertex command.
Select the vertex of the one-line you want to move and accept it with <D>.
The one-line vertex closest to the point where you identify the one-line
is automatically selected.
— OR —
— OR —
If you have the Automatic Propagation toggle set to on, the one-line
will automatically repropagate after the move. See
Propagation Setup, page 297 for more information on this toggle.
9. Modify
193
________________
EE Raceway Modeling Reference Guide - February 2003
Propagate Element
This command expands one-line segments and RCPs into three-dimensional elements (a
process called propagation). Manually placed or edited fittings will propagate exactly as
placed. All other element will propagate depending on the specific situation of the element.
To view errors that occur during propagation, select the Highlight Propagation Errors
command, see
Highlight Propagation Errors, page 314 . This command displays to the screen the pro.err
file, which resides in the <current_project>/rway/tmp directory.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You can set active parameters for propagation through the Propagation Setup form. For
information about the form, see Propagation Setup, page 297 .
194
________________ Propagate Element
Steps
1. Select the Propagate Element command.
The system highlights the specified element. If you do not locate an acceptable one-line
or RCP, the system displays the message Element not found. The message disappears
when you identify a valid element.
— OR —
3. Accept/reject
The system propagates the identified one-line and returns you to step 2 to continue
identifying elements for propagation.
— OR —
Fittings
9. Modify
This section describes some of the fittings available with the delivered raceway one-line
types. The attributes associated with each fitting are contained in the tray_part table in the
reference database. For information about this table, see
Specification, page 507 .
Fittings are produced through propagation and can be divided into the following categories:
195
________________
EE Raceway Modeling Reference Guide - February 2003
The following illustrations detail some of the fittings available for each raceway one-line type:
Tray Fittings
Wireway Fittings
196
________________
Propagate Element
Conduit Fittings
9. Modify
197
________________
EE Raceway Modeling Reference Guide - February 2003
Options
Remove RCP — Deletes an RCP from the design file. See Remove RCP, page 214 .
Field Descriptions
Type — Displays the active three-line type for the current specification. The list
contains all available three-line types (elbow, straight, wye, etc.) for that specification.
To change the displayed three-line type, select a value from the list. Modifying the
value in the Part field may also change the active and available Type values.
Subtype — Displays the active subtype for the displayed Type value. The list contains
all available subtypes (vertical, horizontal, inside vertical, etc.) for the active type and
subtype in the current specification. To change the displayed subtype, select a value
from the list. Modifying the value for Type also changes the active and available
subtypes.
Qualifier — Displays the active qualifier for the displayed Type and Subtype. The list
contains all available qualifiers (adjustable, rigid, etc.) for the active type and subtype in
the current specification. To change the displayed qualifier, select a value from the list.
Modifying Type or Subtype values may change the available qualifiers.
Symbol — Displays the name of the Eden symbol you are placing. You can only
review the values in this field.
Angle — Displays the active angle associated with the Type, Subtype, and Qualifier
for the current specification. The list contains available angles. To change the
displayed angle, select an angle from the list or select the field, and key in the new
value.
198
________________ Edit/Insert Manual Fitting
When placing a fitting (such as a vertical tee), if the placepoints and RCPs do
not line up correctly, key in a negative angle, (-90 degrees) to shift the RCPs
and placepoints to the correct location.
Length — Displays the length by which to project a straight. If straight is not your
active Type, the Length field does not display on the form. To change the displayed
length, select the field, and key in the new value.
Part — Displays the active part. The list contains all available parts for the current
specification. To change the displayed part, select a value from the list. You can also
change any of the values for Type, Subtype, Qualifier, Spec1, and (if applicable)
Spec2.
Spec1 — Displays the active specification for the displayed Type, Subtype, and
Qualifier. The list contains all available specifications.
9. Modify
The specification form has these parameters:
— Column name - Displays the aliases of those columns in the database that are
associated with the specified type. You can only review the information in this
column.
— Column value - Displays the column name values currently associated with the
specified type. You can review and modify the values in this column. To change a
value, select the Override button. Then select the field, and key in a new value.
199
________________
EE Raceway Modeling Reference Guide - February 2003
— Select - Retrieves the row(s) from the specification table that meet the select criteria
defined in the form. If only one row matches this criteria, then the Column values
fill in with the matching row’s values. If more than one row matches the criteria,
then a second form containing all matching rows displays.
You can use certain relational operators as search criteria. For a list of valid
operators, see Annotate Element, page 178 .
— Clear - Clears the Column values from the lower portion of the form, and then
automatically depresses the Override button so that you can select a different
row(s) from the specification.
— Override - Allows you to override those columns whose access is Read Only (R).
You can activate the Override button by selecting it directly or by selecting the
Clear button, which automatically activates it.
Spec2 — Displays the active secondary specification, if any, for the given Spec1,
Type, Subtype, and Qualifier. The list contains all available secondary specifications
for the current settings. Secondary specifications are generally used with reducers.
You can display the current specification itself by selecting the Display button. Doing
so displays a specification form. See Spec1 for a description of the form.
Overrides from the secondary specification are not passed to the Eden symbol.
Placepoint — Defines the point of attachment for the fitting you are currently placing.
To change the active placepoint, select the slide bar, and drag it along the scale until it
reaches the appropriate value.
Automatic Size — Automatically selects the appropriate size fitting base on the one-
lines connected to the fitting.
The fitting size is determined by comparing the spec table nominal size of all one-lines
at the RCP and selecting the largest nominal size among them. That nominal size is
then compared to the fitting table nominal sizes. If in the fitting table there is a nominal
size the same as the largest one-line nominal size, then that fitting is used. If there is no
fitting of that nominal size, then the first fitting that is of greater nominal size than the
one-line nominal size is used. If there is no nominal size fitting larger than the one-line
nominal size, then the largest fitting available is used.
200
________________ Edit/Insert Manual Fitting
— Angle - Defines the angle by which to rotate the orientation tee. To change the
displayed angle, select the field, and key in a new value.
— About - Defines the axis about which to rotate the orientation tee. To change the
displayed axis, select the field, and toggle between the three axes (Primary,
Secondary, Normal) until the appropriate axis displays.
OR
Identify the appropriate axis name (text) on the orientation matrix diagram (to the
right of the Angle and About fields.)
I Button — Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis, and
the Normal axis with the positive Z axis.
If you set the Driven By Spec/Table toggle to Table, the form changes.
Field Descriptions
9. Modify
Table — Displays the active special part table from the database. The list contains the
available special part tables from the database. To change the active special part table,
select a table name from the list.
Attribute — The next four display lists on the form are the first four Part Key
attributes from the active table and will change depending on which Table is active.
The attribute display lists are used to interactively query the database for the desired
Part Key.
For example, you set the active Table to cond_body. size, type, material, and vendor
display as the active attributes. Each attribute displays only those values that have
corresponding matching values for the other three attributes in the database. In other
words, if you set material to feraloy, vendor to 3, and size to 1/2 inch, then only those
types that are 1/2 inch in size from vendor 3 and made of feraloy will be displayed in
the types list. Similarly, if you set type to form 7c, material to feraloy, and vendor to
3, then only the sizes the form 7c comes in, made of feraloy from vendor 3, will be
displayed in the size list.
201
________________
EE Raceway Modeling Reference Guide - February 2003
Select/All toggles — Overrides the interactive queries of the attribute fields. When set
to All, all available values for that attribute are displayed in the list, regardless of the
other attribute settings.
Part Key — Displays the current part for the displayed Table. The list contains all
available parts from the table. To change the active part, select a part from the list.
Modifying the Table value also changes the active and available Part values.
You can display the current table information for the part by selecting the Display
button.
See the description of the Spec1 field earlier in this section for detailed information
about the form parameters.
For information about the Placepoint and Rotate Orientation fields as well as
the form commands, see the descriptions earlier in this section. These fields
and the commands operate identically in either Driven By Spec or Driven By
Table modes.
When deciding whether your fitting information will come from a specification or from a
table in the database, you should first consider a few points. Specification-driven fittings rely
on the specification information (width, height, radius, etc.) to construct the three-line
symbols. All parts of a given specification will inherit the attributes of that specification. On
the other hand, some fittings derive their information from their own database tables because
they are not so easily classified into a common group of parts. Such fittings are called special
parts. The following table indicates fittings that are specification-driven and those that are
special parts.
straight pullbox
elbow conduit body
wye light fixture
cross
dropout
202
________________ Edit/Insert Manual Fitting
Steps
1. Select the Edit/Insert Manual Fitting command.
Select the fitting or RCP you want to edit and accept it with <D>.
— OR —
To derive fitting attributes from a specification in the database, set the toggle to Driven
By Spec.
— OR —
To derive fitting attributes from a special part table in the database, set the toggle to
Driven By Table. Go to step 4.
— OR —
Select Cancel to exit the form without editing the fitting or RCP.
9. Modify
203
________________
EE Raceway Modeling Reference Guide - February 2003
Modify One-Line
This command modifies the route of an existing one-line. You cannot modify the termination
points of a one-line.
You will identify the one-line to be modified at the point where modification should begin.
When identified, one segment of the one-line will display as a solid line with increased line
weight; the other segment appears as a dashed line. The dashed segment will then be
modified. You can reverse the segment to be modified by pressing <R>.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Modify One-Line command.
The system highlights a valid one-line. If you do not locate an acceptable element, the
system displays the message Element not found. The message will disappear when
you identify a valid element.
204
________________ Modify One-Line
3. Raceway one-line
Accept/reject
Accept the highlighted element. Accepting the element identifies the one-line for
modification.
The one-line highlights. Part of the one-line displays with an increased line weight,
while the part to be modified displays as a dashed line.
— OR —
4. Accept/reject
— OR —
— Pressing <R> (or Reject) once reverses the segments to be modified. Repeat this
step.
— Pressing <R> (or Reject) a second time rejects the one-line. Go to step 2.
Enter points to draw new one-line routes. You can press <R> (or Reject) to reject the
last segment drawn. To terminate the new routes, place a data point on the original
9. Modify
one-line, or at the RCP containing the end of the one-line you are modifying.
— OR —
The system saves the rotation and returns to the beginning of the command, prompting
you to Identify Raceway One-Line.
— OR —
Rotate the cross section by the rotation angle defined in Raceway Defaults.
205
________________
EE Raceway Modeling Reference Guide - February 2003
The system rotates the cross section and prompts you again to accept or continue
rotating it.
— OR —
206
________________ Place Fitting by Rule
The fitting size is determined by comparing the spec table nominal size of all one-lines at the
RCP and selecting the largest nominal size among them. That nominal size is then compared
to the fitting table nominal sizes. If in the fitting table there is a nominal size the same as the
largest one-line nominal size, then that fitting is used. If there is no fitting of that nominal
size, then the first fitting that is of greater nominal size than the one-line nominal size is used.
If there is no nominal size fitting larger than the one-line nominal size, then the largest fitting
available is used.
The spec table and the fitting table are defined in the rule.
9. Modify
Before Using This Command
You can enter all values for the placement of points through a precision input form. Using the
form, you can locate elements, route one-lines, accept input, reject input, reset a command
action, and exit a command. You must be familiar with precision input and its functions
before using this command. For detailed information about precision input, see Precision
Input Form, page 119.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form. You must define the rules in the reference database. See
EE Databases, page 425 for a list of the delivered default rules.
207
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Place Fitting by Rule command.
If no rule is defined for the selected RCP’s situation, then the message Unable to find
a rule that applies. displays. Otherwise the correct fitting as defined by the rule is
placed on the RCP.
— OR —
208
________________ Combine Coincident RCPs
Connectivity is re-established for the attached one-lines after RCPs have been combined.
Steps
1. Select the Combine Coincident RCPs command.
If no coincident RCPs are found, the message No coincident RCPs found displays
and the command exits.
— OR —
If coincident RCPs are found, the Combine Coincident RCPs form displays listing the
coincident RCP information.
Each set of coincident RCPs is listed in the form separated by the horizontal dotted line. 9. Modify
One-Line Type — Displays which one-line type each RCP belongs to.
Status — Defines if the RCPs can be merged. If Combinable, then the RCPs
can be merged. If Invalid, then you need to fix the coincident RCPs in your
model.
209
________________
EE Raceway Modeling Reference Guide - February 2003
2. For each set of coincident RCPs, select the RCP information on the form to highlight
the associated elements in the model.
3. Choose which RCP in the set of RCPs you want to keep and leave that line highlighted.
The RCPs are combined, and the Status of the remaining RCP, the one you selected,
changes to Kept. The status of the removed RCP changes to Combined.
210
________________ Delete Duplicate One-Lines
Steps
1. Select the Delete Duplicate One-Lines command.
If no duplicate one-lines are found, then the message No duplicate one-lines found
displays and the command exits.
— OR —
If duplicate one-lines are found, then the Delete Duplicate One-Lines form displays.
Each set of duplicate one-lines is listed in the form separated by a dotted horizontal line.
2. For each set of duplicate one-lines in the form, select the one-line information on the
form to highlight that one-line in the model.
9. Modify
3. Choose which one-line out of each set you want to keep. The Status of the one-line
you chose changes to Save.
The one-line is deleted and its Status changes to Deleted. The Status of the one-line
you wanted to keep changes to Kept.
5. Continue to select the one-line to keep and deleting the other. Select Cancel when
finished.
211
________________
EE Raceway Modeling Reference Guide - February 2003
Delete Element
This command removes elements from the design file. You can use this command to delete
one-lines, RCPs (only if no one-lines are attached), cosmetic graphics, drop points, equipment
pointers, and annotation.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Delete Element command from the menu.
The system highlights the specified element. If you do not locate an acceptable element,
the system displays the message Element not found. The message disappears when
you identify a valid element.
212
________________ Delete Element
— OR —
3. Raceway [element]
Accept/reject
If you accept the highlighted element, the system deletes it. It also deletes all cross
sections, propagated fittings, annotation, and RCPs (unless shared by another one-line)
that are associated with the selected element.
Return to step 2.
— OR —
9. Modify
213
________________
EE Raceway Modeling Reference Guide - February 2003
Remove RCP
This command removes a raceway connect point (RCP) from the design file. You cannot use
the Delete Element commands to remove an RCP, unless the RCP has no one-lines attached.
The command will remove an identified RCP only if all of the following conditions are true:
Once such an RCP is removed, the two one-lines form a single one-line element. If both one-
lines are annotated, the annotation for the second one-line is deleted.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
214
________________ Remove RCP
Steps
1. Select the Remove RCP command.
The system highlights the specified element. If you do not locate an acceptable RCP,
the system displays the message Element not found. The message disappears when
you identify a valid RCP.
— OR —
Press <D> to accept the highlighted RCP for deletion. Return to step 2.
If you accept the RCP, the command deletes it or displays an error message to the
screen.
— OR —
If you reject the RCP, the system prompts you to identify another. Go to Step 2.
9. Modify
215
________________
EE Raceway Modeling Reference Guide - February 2003
Delete Fitting
This command deletes the raceway fitting from a selected RCP, useful for removing manually
placed special fittings (like pullboxes and conduit bodies) and replacing them with bends.
This command does not remove the RCP.
Steps
1. Select the Delete Fitting command.
— OR —
3. Accept/Reject
Press <D> to accept the highlighted fitting and delete it. Return to step 2.
— OR —
216
________________ Remove One-Line Vertex
You can not delete the end points of the one-line using this command.
At any point during this operating sequence, you can exit the command session either by
9. Modify
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Remove One-Line Vertex command.
The one-line vertex closest to the point where you identify the one-line
is automatically selected.
— OR —
3. Accept/reject
Press <D> to accept the highlighted vertex as the one to remove. Return to step 2.
— OR —
Press <R> to reject the highlighted vertex and choose another one. Return to step 2.
218
________________ Minimize Joints
Minimize Joints
This command reduces to a minimum the number of vertices in an identified one-line, while
retaining the original geometry of the one-line. If automatic propagation is toggled on, the
command will repropagate the one-line. (See Propagation Setup, page 297 for information
about the Automatic Propagation toggle.)
The following example demonstrates the effect of the Minimize Joints command on a one-
line. (Automatic propagation is on to show the resulting seamless representation.)
9. Modify
action, and exit a command. You must be familiar with precision input and its functions
before using this command. For detailed information about precision input, see Precision
Input Form, page 119.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
219
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Minimize Joints command from the menu.
The system highlights a valid one-line. If you do not locate an acceptable element, the
system displays the message Element not found. The message will disappear when
you identify a valid element.
The command reduces the number of vertices comprising the one-line to a minimum
(while retaining the original geometry). Go to step 2.
— OR —
220
________________ Change System Parameters
Field Descriptions
Primary System — Displays the primary system. The primary system determines the
symbology of the elements.
Project Rule Set — Displays the Project Electrical Code from the your project
schema’s project table. This is defined in EEmgr with the EE CMS Project Definition
process. The Project Rule Set determines which rules can be assigned to the active
systems. If the Project Rule Set is not defined, Project Rules cannot be assigned.
Systems — Displays all the systems associated with the selected element.
9. Modify
Percent — Specifies the current Percent space allocation assigned to each of the
selected systems. The total Percent space allocation cannot exceed 100 percent. The
total of the system Percents is displayed in the field at the bottom of the Percent
column. All the selected systems percentages are summed to calculate the total
percentage. The Percent represents the portion of the raceway’s width assigned to that
system. This Percent is used when calculating the cable fill of the raceway section in
the EECMS product.
Project Rule — Displays the Project Rule assigned to each of the selected systems for
calculating raceway fill. When a row is selected, a list of available rules for the Project
Rule Set defined with the EE CMS Project Definition process is displayed for review
and selection. To clear the Project Rule, select the row and select the Cancel (X) on the
list of Rules.
List — Indicates whether or not a Project Rule can be assigned. If an * displays in the
List column, then the Project Rule can be assigned. To display a list of available rules
for the Project Rule Set defined with the EE CMS Project Definition process, select the
*.
221
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Change System Parameters command.
— OR —
3. Raceway [element]
Accept/reject
5. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without making any changes to the selected
element.
222
________________ Modify Group Commands
The Modify Group palette is activated by selecting the Modify Group command from the
Modify palette, or by selecting Modify from the EERWAY Command Menu Bar, then
selecting Modify Group Commands, then selecting Palette.
You can use individual Modify Group commands to move, copy, and delete elements of
specified groups, and to review or edit element annotation. You can also propagate one-lines
in a particular group using these commands.
Topics
9. Modify
Define Group — Identifies raceway elements for inclusion in a particular group.
Copy Element by Group — Copies within the design file some or all elements of a
specified group.
Annotate Element by Group — Places, reviews, and edits intelligent annotation for
raceway elements within a specified group.
223
________________
EE Raceway Modeling Reference Guide - February 2003
Place Fitting by Rule Group — Places non-standard fittings using a set of rules defined in
the reference database.
Replace Systems Group — Changes the defined active system type of a one-line.
Minimize Joints by Group — Reduces to a minimum the number of vertices of some or all
one-lines in a specified group.
Delete Element by Group — Removes from the design file some or all elements of a
specified group.
224
________________ Using the Modify Group Commands
You must be familiar with precision input and its functions before using any of the Modify
Group commands, because it is through the Precision Input form that you will enter values
for the placement of points and for the location of raceway elements. For detailed information
about precision input, see
Precision Input Form, page 119 .
Group Workflow
You must use the Define Group command to create and activate an element group before
9. Modify
using other Modify Group commands.
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
225
________________
EE Raceway Modeling Reference Guide - February 2003
Define Group
This command compiles a group from elements you specify. A group is a temporary
association of Raceway elements in your model. Once you have defined a group of Raceway
elements using this command, you can manipulate the group as a whole or in part.
Identifying the contents of an existing group can be done graphically, using the Hilite option.
In general, however, you should assign your groups meaningful names that reflect their
contents.
All groups you create using this command are dropped when you exit the EE Raceway design
session.
Single Element/Entire Group — Determines how Modify Group commands will act
upon existing groups. If the toggle is set to Single Element, then a command will
prompt you to accept/reject every element within a specified group before performing
the command action. If the toggle is set to Entire Group, then a command will prompt
you once to accept/reject the specified group as a whole before performing the
command action.
Use caution when you are manipulating groups in Entire Group mode. The
system prompts you just once to accept/reject a group for manipulation.
Available Groups — Lists the groups you have already created. The active group is
highlighted in the list. The key-in field above the list accepts input for group name
when you are defining a new group. To change the active group, select a group from
the list. To enter a group name, select the group name key-in field, and key in a name.
Create — Creates a group containing the elements you specify in the EE Element
Types list. The system adds the elements using the selection method you specified in
the Graphic Method list.
226
________________ Define Group
To initiate the Create operation, select the button, key in a group name, and select
Accept. The system then compiles a group according to your specifications. When
processing is complete, review the form Message Area for information about the
number of elements the new group contains.
Drop — Removes the active group (the highlighted group in the Available Groups
list).
To initiate the Drop operation, select a group from the Available Groups list, select
Drop, and then select Accept.
To initiate the Copy action, select an existing group from the Available Groups list,
select Copy, and key in a new group name.
Add to — Adds elements you specify from the EE Element Types list to an existing
group. The system compiles the elements using the selection method you specified in
the Graphic Method list.
To initiate the Add to operation, select an existing group from the Available Groups
list, select Add to, and then select Accept. The system compiles the elements using the
selection method you specified in the Graphic Method list. When processing is
complete, review the form Message Area for information about the number of elements
added to the group.
Drop from — Removes elements you specify in the EE Element Types list from an
existing group. If you remove all elements from a group, the system automatically
drops the entire group.
To initiate the Drop from action, select an existing group from the Available Groups
list, select Drop from, and then select Accept. The system drops the elements using
9. Modify
the selection method you specified in the Graphic Method list. When processing is
complete, review the form message display for information about the number of
elements dropped from the group.
Hilite — Highlights in the design file the entire contents of an existing group.
To initiate the Hilite action, select an existing group from the Available Groups list,
and select Hilite. It is not necessary to select Accept. The system automatically
highlights the group contents in the drawing.
Clear Hilite — Clears all highlighting placed in the design when you use the Hilite
command.
EE Element Types — Displays all available element types available for inclusion in or
deletion from a group. Types include one-lines, three-lines, RCPs, drop points, to
equipment, and all annotation. You must choose at least one element type when
creating, adding elements to, or dropping elements from a group.
227
________________
EE Raceway Modeling Reference Guide - February 2003
Select All — Selects every element type from the EE Element Types list.
Clear All — Clears all selected element types from the EE Element Types list.
EE Method — This list displays optional restrictions for the items selected in the EE
Element Types list. You can use the three options in this list to restrict the elements in
your group to those belonging to particular one-line types or systems.
When you select a one-line type from this list, only those element types (RCPs, one-
lines, three-lines, and so forth) belonging to that one-line type will be included in your
group.
You can select individual one-line types from this list, or you can select all displayed
one-line types (using Select All). Clear All cancels the selections you have made from
the list.
Once you have displayed the One-Line Type list, you must Cancel (X) or Confirm
(√) your selections before selecting the Accept button on the main form.
When you select a system from this list, only those element types (RCPs, one-lines,
three-lines, and so forth) belonging to that system will be included in your group.
You can select individual systems from this list, or you can select all displayed systems
(using Select All). Clear All cancels the selections you have made from the list.
Once you have displayed the System list, you must Cancel (X) or Confirm (√) your
selections before you can select the Accept button on the main form.
– Attributes - Displays a list of available element types from which you can define
selection attributes.
228
________________ Define Group
When you select an element type from this list, an attribute list form displays for that
element type in which you can specify the attributes to include in the group
identification.
Once you have defined the attributes, select the Accept button on the main form. To
reset out of the attribute list form and disregard the attributes, select the Cancel (X)
button on the attribute form.
Graphic Method — Displays the available methods for selecting group elements. You
will use these methods to identify elements for group creation, insertion into groups, or
deletion from groups. These methods can serve to further restrict the element types you
are including in your group.
For example, if you identified one-line trays for insertion into a group, and select Fence
Block from this list, the system inserts into the group only those one-line trays
contained within the fence you place.
– Selection - Prompts you to identify specified element types in the design file to drop
from or include in a group.
– Fence Block - Drops from or includes in a group those specified element types
contained within a fence block you place in the design.
– Fence Shape - Drops from or includes in a group those specified element types
contained within a fence shape you place in the design.
– View - Drops from or includes in a group those specified elements types contained in
a view you identify.
– All Elements - Drops from or includes in a group all specified element types in the
design.
9. Modify
229
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Define Group command.
— Use the EE Element Types, EE Method, and Graphic Method lists to define
which elements to place in the group and how you want to select them in the design
file.
— Using the Graphic Method you defined, select your elements for the group.
The group is created. The number of elements added to the group displays at the
bottom of the form.
— OR —
3. Set the Entire Group/Single Element and Hilite On/Hilite Off toggles the way you
want.
230
________________ Copy Element by Group
Equipment pointers and drop points are not copied even if they are part of the
defined group.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group.
Steps
1. Select the Copy Element by Group command from the menu.
9. Modify
The Copy by Group precision input form displays. If you have not defined a group,
the message No active group defined displays.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
Go on to step 3 if Single Element is the active toggle on the Define Group form.
Go to step 5 if Entire Group is the active toggle on the Define Group form.
231
________________
EE Raceway Modeling Reference Guide - February 2003
3. Raceway [element]
Accept/reject
— OR —
The system highlights another group element if any elements remain uncopied. Repeat
this step. Otherwise, the command exits automatically.
— OR —
5. Define origin
Enter a point for the location of the element you are copying.
The system copies the element as specified. If there are group elements that remain
uncopied, you are returned to step 3. Otherwise, the command exits automatically.
— OR —
The system returns you to step 3 if there are group elements that remain uncopied.
Otherwise, the command exits automatically.
232
________________ Annotate Element by Group
The Annotate Element command recognizes one-lines, three-lines, Raceway Connect Points
(RCP), straights, and fittings. For straights and fittings, you are allowed only to review the
annotation (read only access).
Using this command, you can change the specifications or sizes of raceway components.
9. Modify
Field Descriptions
Column name — Displays the aliases for those columns in the database that are
associated with the specified element. The displayed columns reside in the mscolumns
table in the database. You can only review the Column name column information.
Column value — Displays the current value for the column whose alias displays in the
Column name field. You can review and modify the values in this field.
To change the values associated with the element, select the field, and key in the new
value. You can enter blank spaces into the design, using your keyboard space bar.
Empty <Return>s, however, enter nothing into the design. Entering a space or a text
value for an attribute will override that value in the reference database. To delete an
override on a reference database attribute, select the column value field and delete the
blank character. Once you have deleted the override, a value will display in the field
only if the value can be retrieved from the reference database. Otherwise, the field
remains null.
233
________________
EE Raceway Modeling Reference Guide - February 2003
If blanks exist for a field, the cursor will jump to the end of the blanks when
the field is tagged beyond value.
Source — Dislays the source of the corresponding column value. If Ref displays in the
column, then the value derives from the reference database. If Dgn displays in the
column, then the value has been defined from the design file. If you change a column
value, the column displays New until you select Confirm (√) to save your changes.
The next time you enter the annotation form, the Source column will display either Ref
or Dgn, where New had displayed. Where UD displays in the column, the
corresponding column value comes from user data. When modified, the value is saved
back to user data.
List column — Indicates whether or not a column value has an associated codelist. If
an * displays in the List column, then the column value has a corresponding codelist.
To display the codelist, select the *.
Access column — Indicates whether or not you can manipulate a particular column
value. If you can view and modify (read and write) the column value, the Access
column displays a R/W. If you can only view (read) the column value, then it will
display an R. You can only review the information in this column.
Display On/Off — This toggle enables or disables the design display for each column
value. Where the toggle is On, the value will display in the design where you place it.
You will be prompted to place displayed values when placing one-lines in the drawing.
Reference Database Key — This field allows you to insert an override key into the
reference database. When you enter a new value in the EE Reference Database Key
field, it becomes an override key to the reference database.
The key field is updated, and corresponding database values are retrieved and displayed
on the annotation form. If the specified key does not exist in the reference database, an
error message displays and the annotation form returns to the previous values. Any
annotation you placed in the drawing will override the reference database defaults on
the form.
If you delete the value in this field, a value will automatically redisplay if it can be
retrieved from the reference database. Otherwise, the field remains null.
If an override linkage is not present on a device or a title block, then the cell name or
the Default key will be used to locate default data. If the linkage is not present on a
connect point or one-line, the key specified in the user element is used. If no key exists
in the user element, the Default key is used. Once you place an override key on an
element, you can modify it, but cannot delete it.
To change the displayed value, select the field, and key in a new value.
Key Description — Displays the description from the reference database of the current
EE Reference Database Key. You can only review the information in this field.
234
________________ Annotate Element by Group
The lower portion of the Active [One_Line Type] Parameters form displays a
specification table. The EE spec key field on the upper portion of the form is used as
the key for the Column name values on the lower portion of the form.
Select — Retrieves the row(s) from the specification table that meet the select criteria
defined in the form. The select criteria are those values that display in the Column
value column on the lower portion of the annotation form. You can use relational
operators when keying in your own select criteria. Available operators are described
later in this section.
If only one row matches the select criteria you provide, then the Column values fill in
with the matching row’s values. If more than one row matches the criteria, then a
second form containing all matching rows displays.
From this form you will select the row(s) containing the desired values. To add values
9. Modify
from the displayed specification table rows, select the row you want, and then select
Confirm (√). If you select Cancel (X), the system cancels the form and retrieves the
values from the EE spec key field on the original form.
Clear — Clears the Column values from the lower portion of the form, and then
automatically depresses the Override button to select a different row(s) from the
specification table. Clearing the column values allows you to key in new select criteria.
Override — This button allows you to override those columns whose access is Read
Only (R). You can activate the Override button by selecting it directly or by selecting
the Clear button, which automatically activates it.
235
________________
EE Raceway Modeling Reference Guide - February 2003
This command accepts certain relational operators as search criteria. You should be familiar
with the following operators:
> greater than numeric This operator indicates that the queried values should
be greater than the given value.
< less than numeric This operator indicates that the queried values should
be less than the given value.
>= greater than numeric This operator indicates that the queried values should
or equal to be greater than or equal to the given value.
<= less than or numeric This operator indicates that the queried values should
equal to be less than or equal to the given value.
!= not equal to numeric This operator indicates that the queried values should
NOT be equal to the given value.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form. You must define a temporary group of elements, using the Define
Group command. (For information about the command, see Define Group, page 226 .)
Placing a fence around elements in the design also constitutes a group for the purposes of this
command. A fence group overrides the active group.
236
________________ Annotate Element by Group
Steps
1. Select the Annotate Element by Group command from the menu.
— OR —
3. Raceway [element]
Accept/reject
The system displays the Annotate Element form for the identified element.
— OR —
9. Modify
Reject the highlighted group element.
The system highlights another group element. Repeat this step. If no group elements
remain, the command exits.
5. Select Confirm (√) to save your changes and exit the annotation form.
— OR —
Select Cancel (X) to exit the annotation form without saving your changes. Go to Step
3.
The prompt indicates the column alias you are placing. The column value displays in
drag mode attached to the cursor.
237
________________
EE Raceway Modeling Reference Guide - February 2003
The new value displays in the design file. The system places all new displayed
annotation for the specified element.
If you set the toggle to Global, the system places the same annotation for all identical
element types in the group. When there are no more values to place for the element
type, the system prompts you to annotate other element types within the group. Go to
step 3.
— OR —
If you set the toggle to Single, the system returns you to step 3 to annotate other
elements within the group. Go to step 3.
Any value placed with the Annotate Element by Group command will
be entered into the drawing and, optionally, displayed. When you load
the project database, these values are loaded into the project database.
238
________________ Clone Element by Group
Equipment pointers and drop points are not copied even if they are part of the
defined group.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group.
Steps
1. Select the Clone Group command.
9. Modify
The Clone Group precision input form displays. If you have not defined a group, the
message No active group defined displays.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
Go on to step 3 if Single Element is the active toggle on the Define Group form.
Go to step 5 if Entire Group is the active toggle on the Define Group form.
239
________________
EE Raceway Modeling Reference Guide - February 2003
3. Raceway [element]
Accept/reject
— OR —
The system highlights another group element if any elements remain uncopied. Repeat
this step. Otherwise, the command exits automatically.
— OR —
5. Define origin
Identify a point in the group to use as the origin for the copies.
A warning box displays verifying the number of times you want to clone the identified
group.
— OR —
Identify the location of the first copy. If you are placing more than one clone, each
successive clone is placed the same distance and direction from the previous clone as
the first clone is from the original group.
Return to step 2.
240
________________ Propagate by Group
Propagate by Group
This command expands into three-dimensional elements all or selected valid one-line
segments and RCPs from the active group.
To view errors that occur during propagation, select the Highlight Propagation Errors
command. This command displays to the screen the pro.err file, which resides in the
<current_project>/rway/tmp directory). For information about using this command, see
Highlight Propagation Errors, page 314 .
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group.
9. Modify
You can set active parameters for propagation through the Propagation Setup form. For
information about the form, see Propagation Setup, page 297 .
Steps
1. Select the Propagate by Group command from the menu.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
241
________________
EE Raceway Modeling Reference Guide - February 2003
— If Entire Group is the active toggle on the Define Group form, the command
propagates all valid elements within the fence, and exits automatically. Go to step
1.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— OR —
3. Raceway [element]
Accept/reject
The system propagates the element, and then highlights another group element for
propagation. If no group elements remain, the command exits automatically.
Repeat this step until you have processed all elements within the group, or until you
exit the command.
— OR —
The system highlights another group element for propagation. If no group elements
remain for propagation, the command exits automatically.
Repeat this step until you have processed all elements within the group, or until you
exit the command.
— OR —
242
________________ Place Fitting by Rule by Group
The fitting size is determined by comparing the spec table nominal size of all one-lines at the
RCP and selecting the largest nominal size among them. That nominal size is then compared
to the fitting table nominal sizes. If in the fitting table there is a nominal size the same as the
largest one-line nominal size, then that fitting is used. If there is no fitting of that nominal
size, then the first fitting that is of greater nominal size than the one-line nominal size is used.
If there is no nominal size fitting larger than the one-line nominal size, then the largest fitting
available is used.
The spec table and the fitting table are defined in the rule.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
9. Modify
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group. You must
define the rules in the reference database. See
EE Databases, page 425 for a list of the delivered default rules.
243
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Place Fitting by Rule by Group command.
The Group Place Fitting by Rule precision input form displays. If you have not
defined a group, the message No active group defined displays.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
Go on to step 3 if Single Element is the active toggle on the Define Group form.
Go to step 5 if Entire Group is the active toggle on the Define Group form.
3. Raceway [element]
Accept/reject
— OR —
The system highlights another group element if any elements remain uncopied. Repeat
this step. Otherwise, the command exits automatically.
If no rule is defined for the selected RCP’s situation, then the message Unable to find
a rule that applies. displays. Otherwise the correct fitting as defined by the rule is
placed on the RCP.
— OR —
244
________________ Add Systems Group
If you try to add a system that already exists on the element, it will not be duplicated.
Steps
9. Modify
1. Select the Add Systems Group command.
2. Press <D> to accept the group as the one to add systems to.
— OR —
3. Select the system or systems you want to add and select Confirm (√).
— OR —
245
________________
EE Raceway Modeling Reference Guide - February 2003
Changing the active system will cause the graphic symbology to change to the
symbology define for the new system.
Field Descriptions
Systems — This button allows the selection of the active system. When a new active
system is selected, the subsystem are all unselected. The active system is automatically
included as a subsystem. The active system determines the symbology of the raceway.
Subsystem — This button allows the selection of subsystems. While this button is
depressed, the Percent and Project Rule can be defined for each subsystem.
Project Rule Set — Displays the Project Electrical Code from the your project
schema’s "project" table. This is defined in EEmgr with the EE CMS Project
Definition process. The Project Rule Set determines which rules can be assigned to the
active systems. If the Project Rule Set is not defined, Project Rules cannot be assigned.
Systems — Displays all the available systems. Selecting a row in this field defines the
Active System or Subsystems.
Percent — Displays the current Percent space allocation assigned to each of the
selected systems. The total Percent space allocation cannot exceed 100 percent. The
total of the system Percents is displayed in the field at the bottom of the Percent
column. All the selected systems percentages are summed to calculate the total
percentage. The Percent represents the portion of the raceway’s width assigned to that
system. This Percent is used when calculating the cable fill of the raceway section in
the EECMS product.
246
________________ Replace Systems by Group
Project Rule — Displays the Project Rule assigned to each of the selected systems for
calculating raceway fill. When a row is selected, a list of available rules for the Project
Rule Set defined with the EE CMS Project Definition process is displayed for review
and selection. To clear the Project Rule, select the row and select the Cancel (X) on the
list of Rules.
List — Indicates whether or not a Project Rule can be assigned. If an * displays in the
List column, then the Project Rule can be assigned. To display a list of available rules
for the Project Rule Set defined with the EE CMS Project Definition process, select the
*.
When defining the group for this command, you must define a group that contains
all elements that have connectivity. You can not replace a system on just one
element in a network of elements that have connectivity. A network may be
thought of as all RCPs, drop points, one-lines, and so forth that are associated
through a series of graphically connected one-lines.
Steps
1. Select the Replace Systems by Group command.
9. Modify
2. Press <D> to accept the group.
— OR —
3. Select the new system type from the form and select Confirm (√).
— OR —
247
________________
EE Raceway Modeling Reference Guide - February 2003
The following example demonstrates the effect of the Minimize Joints command on a one-
line. (Automatic propagation is on to show the resulting seamless representation.)
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group.
248
________________ Minimize Joints by Group
Steps
1. Select the Minimize Joints by Group command from the menu.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
— If Entire Group is the active toggle on the Define Group form, the vertices of all
one-lines within the fence are reduced to a minimum number, and the command
exits automatically.
— If Single Element is the active toggle on the Define Group form, the system
prompts you to minimize the number of vertices for each one-line within the fence.
Go to step 3.
— OR —
9. Modify
3. Raceway one line
Accept/reject
The system minimizes the number of vertices comprising the one-line, and then
identifies another valid one-line within the group (if any remain). Repeat this step. If
there are no valid one-lines remaining in the group, the command exits automatically.
— OR —
The system then identifies another valid one-line in the group, if any remain. Repeat
this step. If there are no valid one-lines remaining in the group, the command exits
automatically.
249
________________
EE Raceway Modeling Reference Guide - February 2003
The system minimizes the number of vertices for all valid one-line elements within the
group. The command exits automatically.
— OR —
250
________________ Delete Element by Group
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
You must define a temporary group of elements, using the Define Group command, see
Define Group, page 226. Placing a fence around elements in the design also constitutes a
group for the purposes of this command. A fence group overrides the active group.
Steps
1. Select the Delete Element by Group command from the menu.
The Delete by Group precision input form displays. If you have not defined a group,
the message No active group defined displays.
9. Modify
— If you have a fence in the design, go to step 2.
— If Single Element is the active toggle on the Define Group form, go to step 3.
— If Entire Group is the active toggle on the Define Group form, go to step 4.
— If Entire Group is the active toggle on the Define Group form, the contents of the
group are deleted, and the command exits automatically.
— If Single Element is the active toggle on the Define Group form, the system
prompts you to delete each element within the fence. Go to step 3.
— OR —
251
________________
EE Raceway Modeling Reference Guide - February 2003
3. Raceway [element]
Accept/reject
The system deletes the element, and prompts you to delete another group element.
Repeat this step. If there are no remaining group elements for deletion, the command
exits automatically.
— OR —
The system prompts you to delete another group element if any remain for deletion. If
there are no remaining group elements for deletion, the command exits automatically.
The system deletes all valid elements within the group. The command exits
automatically.
— OR —
252
________________ Setup Commands
In a new design file, you must use the Setup commands before using any other command group.
Your system/application manager should ensure that the reference database contains the necessary
systems and one-line types before you use these commands.
Commands
Set Raceway Defaults — Defines, reviews, and modifies the raceway default parameters for
symbols, working view, model annotation, RCPs, report IDs, and cross sections.
Define System — Selects any or all systems from those available in the reference database for
use in the design file.
Define One-Line Type — Selects any or all available one-line types from those available in the
reference database for use in the design file.
Set Symbology Control — Selects the standard graphic symbology control for all systems and
one-line types in a design file.
Symbology Control — Defines, reviews, and modifies the graphic symbology control for those
one-line types you specified using the Set Symbology Control command.
Set Text Defaults — Defines, reviews, and modifies the default parameters for text, text nodes,
10. Setup
Set Conduit Sizing Attributes — Defines which conduit attributes will be used selecting the
correct size conduit in the Conduit Sizing command.
Cell Creation Commands — Create various types of raceway cells necessary for creating EE
Raceway models.
253
________________
EE Raceway Modeling Reference Guide - February 2003
Model Commands — Place and manipulate a model information in the design file.
254
________________ Using the Setup Commands
Group Workflow
Before using the symbology commands in this group (Set Symbology Control and
Symbology Control), you must have defined at least one system and one-line type from the
database using the Define System and Define One-Line Type commands.
Operating Information
See individual command descriptions for specific operating information.
10. Setup
255
________________
EE Raceway Modeling Reference Guide - February 2003
Changes in these fields do not affect existing systems. Use the Set
Symbology Control to make changes to individual, existing systems.
Default settings are applied to new systems created in or added to a
design file.
Duct — Specifies whether to use conduit or cable when using the Define Duct Cross
Section command, see
Define Duct Cross Section, page 164 for more information.
Margin Width — Defines the distance, in sub-units, between the routed cable/conduit,
represented by the matrix buttons, and the shell of the duct bank when using the Define
Duct Cross Section command, see Define Duct Cross Section, page 164 for more
information.
Global Symbology — Displays the default symbology settings for Model Annotation.
The system uses these settings when annotating the model either during cell creation or
after you have placed one in the design file. You can review, define, and/or modify the
settings. To change a displayed value, select the field, and key in a new value.
Cross Section — Displays the default Scale Factor and Rotation Angle for cross
sections. You can review, define, and/or modify the values in these fields. To change a
displayed value, select the field, and key in a new value.
256
________________ Set Raceway Defaults
Working view — Displays the current working view for the design file. The working
view determines the orientation of text and cells you place through precision input.
Additionally, precision input uses the working view to place and locates points in the
design. To change the current working view, select the slide bar, and drag it along the
scale until the desired view number displays. The scale includes views 1 through 8.
Symbols — Displays the names of the cells that represent equipment pointers and drop
points. To change a displayed value, select the field, and key in a new value.
RCP — Displays the Default Weight for RCPs. You can review, define, and/or
modify the value in this field. This value will also become the default RCP weight on
the Symbology Control form. To change the displayed value, select the field, and key
in a new value.
Default Key — Displays the current default keys for RCP (raceway connect point),
equipment pointer, and drop point annotation. You can review, define, and/or modify
this key. To display the current default data from the database for a particular element
(RCP, equipment pointer, or drop point), select first the key field and then the Display
button. The information will display in the scrollable list in the lower right corner of
the form. You can only view this data.
Steps
1. Select the Set Raceway Defaults command.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
10. Setup
257
________________
EE Raceway Modeling Reference Guide - February 2003
Define System
This command allows you to select any or all available systems from the reference database
for use in the design file. The System Definition form displays those systems available for
selection from the reference database, as well as those already selected for the current design
file.
If you need systems not available to you, you should ask the system/application manager to
add them to the reference database. Caution should be used when adding these to the
database, so as to avoid duplication of elements.
In order to place one-lines, you must have at least one system defined in the
design file.
Steps
1. Select the Define System command.
2. Select the systems in the From Database column that you want to define in the present
design file. To define ALL systems from the reference database in the present design
file, select the Select All button.
The systems you select display in the To Design column and will be defined in the
design file once you select the Confirm button (√).
— OR —
Select those systems listed in the To Design column that you no longer want defined
for the design file. To remove ALL systems from definition in the design file, select the
Clear All button.
258
________________ Define System
The systems you select are deleted from the To Design column and will no longer be
defined in the design file.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
10. Setup
259
________________
EE Raceway Modeling Reference Guide - February 2003
If you need one-line types not available to you, you should ask the system/application
manager to add them to the reference database. Caution should be used when adding these to
the database, so as to avoid duplication of elements.
You must define one-line types for the design file before you can use related
commands, such as Set Active One-Line Type and Place One-Line Type.
Steps
1. Select the Define One-Line Type command.
2. Select the one-line types in the From Database column that you want to define in the
present design file. To define ALL one-line types from the reference database in the
design file, select the Select All button.
The one-line types you select display in the To Design column and will be defined in
the design file once you select the Confirm button (√).
— OR —
Select those one-line types listed in the To Design column that you no longer want
defined for the design file. To remove ALL one-line types from definition in the design
file, select the Clear All button.
260
________________ Define One-Line Type
The one-line types you select are deleted from the To Design column and will no longer
be defined in the design file.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
10. Setup
261
________________
EE Raceway Modeling Reference Guide - February 2003
When you enter a new design file, all symbology is taken from the system defaults.
Therefore, to make any changes in symbology, you must first use the Set Symbology Control
command to specify the systems and one-line types that can be changed. You can specify the
one-line types for which to change the standard symbology by setting them to override mode.
In cases where you do not specify overrides for the one-line types within a system, those one-
line types will use a system default. The Symbology Control command allows you to set up
the symbology details for all the override cases within a system. You can also modify the
system default symbology details if necessary. For more information, see
Symbology Control, page 264 .
262
________________ Steps
Steps
1. Select the Set Symbology Control command.
2. Using your cursor, select the individual area that matches a system and one-line type to
"turn on" an override for that case.
— OR —
Toggle the Available button in each field to None to change the defaults symbology for
all one-line types within a system. Each one-line type within the system will then have
its own symbology defined, so default symbology is not necessary for that system.
— OR —
Select a one-line type from the list to "turn on" the override for that type in all systems.
— OR —
Select the individual Override settings you wish to "turn off" (return to default status).
To turn off ALL selected Override settings, select the No Overrides button.
The Override settings you selected are deleted from the Override field and the default
settings restored.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
10. Setup
263
________________
EE Raceway Modeling Reference Guide - February 2003
Symbology Control
This command defines, reviews, and modifies the graphic symbology for those one-line types
you specified using the Set Symbology Control command (see Set Symbology Control, page
262 for more information about this command).
The Symbology Control form displays the current symbology settings for all systems and
corresponding one-line types.
You must have at least one system and one-line type defined for the design file
in order to use this command.
System — Displays the system for which you can currently change the symbology
settings. The display list contains a list of available systems. To change the displayed
system, select another system from the list, or select the field, and key in a system
name.
One Line Type Overrides — Displays the one-line type within the displayed system
for which you can change the symbology settings. The display list contains a list of
available one-line types within the currently displayed system.
If you have not set overrides for all one-line types within a system,
System Default will display in the One-Line Type display list.
To change the displayed one-line type (or system default), select another one-line type
from the list, or select the field, and key in the new value.
Symbology — Displays the symbology settings for the selected system and one-line
type. You can review and edit these settings. To change a value in the list, select the
field, and key in a new value.
264
________________ Symbology Control
Steps
1. Select the Symbology Control command.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
10. Setup
265
________________
EE Raceway Modeling Reference Guide - February 2003
Field Descriptions
Font — Displays the default font style number.
Height — Displays the default text height in a ratio of master units to sub units (#:#).
Width — Displays the default text width in a ratio of master units to sub units (#:#).
Line spacing — Displays the default vertical spacing between lines of text in a ratio of
master units to sub units (#:#).
Line length — Displays the default length for lines of text in a ratio of master units to
sub units (#:#).
Text String — These buttons and the associated display list display the current
justification for text strings in the design file. You can modify the justification using
either the buttons or the list. To change the current text string justification, select the
button that graphically represents the desired justification, or select a value from the
list.
Text Nodes — These buttons and the associated display list display the current
justification for text nodes in the design file. You can modify the justification using
either the buttons or the list. To change the current text node justification, select the
button that graphically represents the desired justification, or select a value from the
list.
266
________________ Set Text Defaults
Engineering Units — These fields (Master units, Sub units, and Positional units)
display the current PDS engineering units. You can only review the displayed settings.
Steps
1. Select the Set Text Defaults command.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
10. Setup
267
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Set Conduit Sizing Attributes command.
— THEN —
Select Confirm (√) to save your changes and exit the form.
— OR —
Select Cancel (X) to exit the form without saving any changes.
268
________________ Create Cell Commands
You must have a cell library attached to the design file in order to activate the Create Cell
commands. EE Raceway is delivered with a sample cell library, rway.cel, which resides in
win32app\eerway\dgn. If you want to modify the delivered library, copy it to a non-
production directory, and modify the copied version. You must have write access to the
library before modifying it.
Create Model Cell — Creates or recreates a model cell to carry the sheet name of a
drawing.
Create Equipment Pointer Cell — Creates an equipment pointer symbol for later
placement in the design file.
Create Drop Point Cell — Creates a drop point symbol for later placement in the
design file.
10. Setup
269
________________
EE Raceway Modeling Reference Guide - February 2003
You should be familiar with precision input and its functions before using any of the Create
Cell commands, because it is through the Precision Input form that you will enter values for
the placement of points and for the location of raceway elements. For detailed information
about precision input, see
Precision Input Form, page 119 .
Group Workflow
There is no required or suggested sequence for using the Create Cell commands.
Operating Information
See individual command descriptions for specific operating information.
270
________________ Create Model Cell
Make sure you have a cell library attached to the design file before using this
command and be sure the library is not read only. To display a list of
available cell libraries, key in rc=.
Steps
1. Select the Create Cell command.
If no fence is defined, place the first data point of a fence block diagonal. Include all
the graphic elements of the component. Be sure to include any existing annotation that
you want as part of the cell. Make enough room within the fence to include all text
elements within the fence. Do not include any elements within the fence that you do
not want as part of the cell.
— OR —
Place the second data point of a fence block diagonal. Include all the graphic elements
of the component. Be sure to make room to include any text elements within the fence.
10. Setup
5. Accept/reject fence
(This is the first prompt if a fence is already established when you start the command.)
— OR —
271
________________
EE Raceway Modeling Reference Guide - February 2003
6. When you accept the fence, a form displays prompting you to Close or Annotate.
7. The Annotate Element form displays, allowing you to add annotation to the cell and
displaying those values already in the cell.
8. To enter a value, select the Column value field, key in the value, and press <Return>.
To make a change or correction, select the field again and key in the new value. Turn
the Display toggle on for any text attribute you want displayed in the cell. For detailed
information about the annotation form, see Annotate Element, page 178 .
— OR —
Select Cancel (X) to exit the command without saving the changes. Return to step 7.
For all new displayed text attributes, you are prompted to place any new values. Any
values (including empty enter data fields) already present in the cell are edited
automatically. The prompt tells you which value you are placing.
Underlines (for empty enter data fields) will not be displayed on the
screen cursor like other new values. However, they will be placed in the
cell (and visible) when you press <D>.
272
________________ Create Model Cell
Move the text to the desired position in the drawing and press <D>.
The value is placed in the cell as you indicated. This step repeats for each enter data
field. When complete, you are returned to step 7. All new non-displayed text attributes
are placed at the center of the active fence.
10. If you try to close with the fence around invalid elements, various error messages will
display. Refer to
Error Messages, page 377 for descriptions of these messages.
When you select Close, the Close cell parameters form displays.
11. To enter a value, select the input box, key in the value, and press <Return>. To make a
change or correction, select the input box again and key in the new value. You must
enter a cell name. The description is optional. When complete, confirm your entries
by selecting Confirm (√).
Place a data point to define the cell origin. This point must be within the graphic extent
of the fenced elements.
The cell is created and placed into the attached cell library. The message
Accept/reject Successful Completion displays as long as the fence is still active.
— OR —
10. Setup
273
________________
EE Raceway Modeling Reference Guide - February 2003
Make sure you have a cell library attached to the design file before using this
command and be sure the library is not read only. To display a list of
available cell libraries, key in rc=.
Steps
1. Select the Create Cell command from the command menu.
If no fence is defined, place the first data point of a fence block diagonal. Include all
the graphic elements of the component. Be sure to include any existing annotation that
you want as part of the cell. Make enough room within the fence to include all text
elements within the fence. Do not include any elements within the fence that you do
not want as part of the cell.
— OR —
Place the second data point of a fence block diagonal. Include all the graphic elements
of the component. Be sure to make room to include any text elements within the fence.
5. Accept/reject fence
(This is the first prompt if a fence is already established when you start the command.)
— OR —
274
________________ Create Equipment Pointer Cell
6. When you accept the fence, a form displays prompting you to Close or Annotate.
7. The Annotate Element form displays, allowing you to add annotation to the cell and
displaying those values already in the cell.
8. To enter a value, select the Column value field, key in the value, and press <Return>.
To make a change or correction, select the field again and key in the new value. Turn
the Display toggle on for any text attribute you want displayed in the cell. For detailed
information about the annotation form, see Annotate Element, page 178 .
— OR —
Select Cancel (X) to exit the command without saving the changes. Return to step 7.
For all new displayed text attributes, you are prompted to place any new values. Any
values (including empty enter data fields) already present in the cell are edited
automatically. The prompt tells you which value you are placing.
Underlines (for empty enter data fields) will not be displayed on the
screen cursor like other new values. However, they will be placed in the
cell (and visible) when you press <D>.
275
________________
EE Raceway Modeling Reference Guide - February 2003
Move the text to the desired position in the drawing and press <D>.
The value is placed in the cell as you indicated. This step repeats for each enter data
field. When complete, you are returned to step 7. All new non-displayed text attributes
are placed at the center of the active fence.
10. If you try to close with the fence around invalid elements, various error messages will
display. Refer to
Error Messages, page 377 for descriptions of these messages.
When you select Close, the Close cell parameters form displays.
11. To enter a value, select the input box, key in the value, and press <Return>. To make a
change or correction, select the input box again and key in the new value. You must
enter a cell name. The description is optional. When complete, confirm your entries
by selecting Confirm (√).
Place a data point to define the cell origin. This point must be within the graphic extent
of the fenced elements.
The cell is created and placed into the attached cell library. The message
Accept/reject Successful Completion displays as long as the fence is still active.
— OR —
276
________________ Create Drop Point Cell
Make sure you have a cell library attached to the design file before using this
command and be sure the library is not read only. To display a list of
available cell libraries, key in rc=.
Steps
1. Select the Create Cell command from the command menu.
If no fence is defined, place the first data point of a fence block diagonal. Include all
the graphic elements of the component. Be sure to include any existing annotation that
you want as part of the cell. Make enough room within the fence to include all text
elements within the fence. Do not include any elements within the fence that you do
not want as part of the cell.
— OR —
Place the second data point of a fence block diagonal. Include all the graphic elements
of the component. Be sure to make room to include any text elements within the fence.
5. Accept/reject fence
(This is the first prompt if a fence is already established when you start the command.)
— OR —
6. When you accept the fence, a form displays prompting you to Close or Annotate.
7. The Annotate Element form displays, allowing you to add annotation to the cell and
displaying those values already in the cell.
8. To enter a value, select the Column value field, key in the value, and press <Return>.
To make a change or correction, select the field again and key in the new value. Turn
the Display toggle on for any text attribute you want displayed in the cell. For detailed
information about the annotation form, see Annotate Element, page 178 .
— OR —
Select Cancel (X) to exit the command without saving the changes. Return to step 7.
For all new displayed text attributes, you are prompted to place any new values. Any
values (including empty enter data fields) already present in the cell are edited
automatically. The prompt tells you which value you are placing.
Underlines (for empty enter data fields) will not be displayed on the
screen cursor like other new values. However, they will be placed in the
cell (and visible) when you press <D>.
278
________________ Create Drop Point Cell
Move the text to the desired position in the drawing and press <D>.
The value is placed in the cell as you indicated. This step repeats for each enter data
field. When complete, you are returned to step 7. All new non-displayed text attributes
are placed at the center of the active fence.
10. If you try to close with the fence around invalid elements, various error messages will
display. Refer to
Error Messages, page 377 for descriptions of these messages.
When you select Close, the Close cell parameters form displays.
11. To enter a value, select the input box, key in the value, and press <Return>. To make a
change or correction, select the input box again and key in the new value. You must
enter a cell name. The description is optional. When complete, confirm your entries
by selecting Confirm (√).
Place a data point to define the cell origin. This point must be within the graphic extent
of the fenced elements.
The cell is created and placed into the attached cell library. The message
Accept/reject Successful Completion displays as long as the fence is still active.
— OR —
10. Setup
279
________________
EE Raceway Modeling Reference Guide - February 2003
Model Commands
These commands are used to place and manipulate model information in your design file.
Commands
Lock Model — Locks the symbology control parameters, the defined systems, and the
defined one-line types.
Move Model Annotation — Moves the model annotation within the design file.
280
________________ Using the Model Commands
You must lock the model in order to load the drawing into the project database.
You should be familiar with precision input and its functions before using any of the Model
commands, because it is through the Precision Input form that you will enter values for the
placement of points and for the location of raceway elements. For detailed information about
precision input, see
Precision Input Form, page 119 .
Group Workflow
Before you can annotate or move annotation in the model, you must have locked the model
using the Lock Model command.
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
10. Setup
281
________________
EE Raceway Modeling Reference Guide - February 2003
Lock Model
This command locks the model. The locking of the model locks the symbology control
parameters and the defined systems and one-line types. Therefore, you should lock your
model after setup, but before placing graphics in a file in order to protect your parameters.
You must lock the model in order to load the drawing into the project database.
Steps
1. Select the Lock Model command.
The model is locked. If the model was locked when you selected this command, the
message Model is already locked displays.
282
________________ Move Model Annotation
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Move Model Annotation command.
The Move Model Annotation precision input form displays. The command checks the
design file for the existing model annotation and places it in drag mode.
— OR —
10. Setup
283
________________
EE Raceway Modeling Reference Guide - February 2003
Unlock Model
This command unlocks the model. If you want to change the symbology control or add new
systems and one-line types to a model that has been locked, you must first unlock the model
using this command.
Steps
1. Select the Unlock Model command.
— OR —
Select Cancel (X) to exit the command without unlocking the model.
284
________________ Annotate Model
Annotate Model
This command adds or changes the annotation for the model. This command cannot prevent
the duplication of sheet numbers within a project. The Load Database process, however, will
prevent such duplication. The sheet number should be unique for each drawing.
Steps
1. Select the Annotate Model command.
2. Select the Column value field for sheet on the form and key in a new sheet number.
If you want to display the annotation in the model, toggle the Display fields in the form
to On.
— OR —
Select Cancel (X) to exit the command without saving your changes.
4. If you toggled Display to On, you are prompted to place the annotation in the model.
10. Setup
285
________________
EE Raceway Modeling Reference Guide - February 2003
286
________________ Runtime Setup Commands
11. Runtime
The Runtime Setup commands allow you to define, modify, and review the active drawing
parameters in your design file.
The Runtime Setup palette is activated by selecting Setup from the EE Raceway Command
Menu Bar, then selecting Palette from the resulting pull-down menu.
Commands
Set Active One-Line Parameters — Displays the active one-line parameters, based on the
current active one-line type, and allows you to set new active parameters.
Set Active One-Line Type — Displays the current active one-line type and allows you to
select a new active one-line type.
Set Active System — Displays the current active system and allows you to set a new active
system.
Propagation Setup — Sets the active parameters for propagation in the design file.
Set Active Levels — Displays the current active level(s) and allows you to turn Off
displayed levels and to turn On new level displays.
287
________________
EE Raceway Modeling Reference Guide - February 2003
Group Workflow
There is no required or suggested sequence for using the commands in this group.
Operating Information
See individual command descriptions for specific operating information.
288
________________ Set Active One-Line Type Parameters
11. Runtime
This command displays the active one-line parameters based on the current active one-line
type you set using the Set Active One-Line Type command (see Set Active One-Line Type,
page 294 ).
The Set Active One-Line Type Parameters command allows you to enter values through the
appropriate form, which is based on the current active one-line type. For example, if you
defined tray as your active one-line type, then the Active TRAY Parameters form will
display when you use this command.
Column name — Displays the aliases for those columns in the database that are
associated with the specified one-line type. You can only review the information in this
field.
Column value — Displays the current value for the column whose alias displays in the
Column name field. You can review and modify the values in this field.
To change the values associated with a one-line type, select this field, and key in the
new value. You can enter blank spaces into the design, but empty <Return>s enter
nothing into the design. Entering a space or a text value for an attribute will override
that value in the reference database. To delete an override on a reference database
attribute, select the column value field and delete the blank character. Once you have
deleted the override, a value will display in the field only if the value can be retrieved
from the reference database. Otherwise, the field remains null.
If blanks exist for a field, the cursor will jump to the end of the blanks when
the field is tagged beyond value.
Save to Memory (M) — Temporarily saves your overrides and specification changes.
When you change the active one-line type or end your design session, you lose the
overrides and specifications you saved to memory. The previous set of specifications
becomes active again.
289
________________
EE Raceway Modeling Reference Guide - February 2003
Access — Indicates whether or not you can manipulate a particular column value. If
you can view and modify (read and write) the column value, the Access column
displays a R/W. If you can only view (read) the column value, then it will display an
R. You can only review the information in this column.
Display On/Off — Enables or disables the design display for each column value.
Where the toggle is On, the value will display in the design where you place it. You
will be prompted to place displayed values when placing one-lines in the drawing.
EE Reference Database Key — This field allows you to insert an override key in the
reference database. When you enter a new value in the EE Reference Database Key
field, it becomes an override key to the reference database. The key field is updated,
and corresponding database values are retrieved and displayed on the annotation form.
If the specified key does not exist in the reference database, an error message displays
and the annotation form returns to the previous values. Any annotation you placed in
the drawing will override the reference database defaults on the form.
If you delete the value in this field, a value will automatically redisplay if it can be
retrieved from the reference database. Otherwise, the field remains null.
If an override linkage is not present on a device or a title block, then the cell name or
the Default key will be used to locate default data. If the linkage is not present on a
connect point or one-line, the key specified in the user element is used. If no key exists
in the user element, the Default key is used. Once you place an override key on an
element, you can modify it, but cannot delete it. To change the displayed value, select
the field, and key in a new value.
Key Description — This field displays the description from the reference database of
the current EE Reference Database Key. You can only review the information in this
field.
The lower portion of the Active [One_Line Type] Parameters form displays a
specification table. The EE spec key field on the upper portion of the form is used as
the key for the Column name values on the lower portion of the form.
Select — Retrieves the row(s) from the specification table that meet the select criteria
defined in the form. The select criteria are those values that display in the Column
value column on the lower portion of the annotation form. You can use relational
operators when keying in your own select criteria.
290
________________ Set Active One-Line Type Parameters
If only one row matches the select criteria you provide, then the Column values fill in
with the matching row’s values. If more than one row matches the criteria, then a
second form containing all matching rows displays.
11. Runtime
From this form you will select the row(s) containing the desired values. To add values
from the displayed specification table rows, select the row you want, and then select
Confirm (√). If you select Cancel (X), the system cancels the form and retrieves the
values from the EE spec key field on the original form.
Clear button — This button clears the Column values from the lower portion of the
form, and then automatically depresses the Override button to select a different row(s)
from the specification table.
Override button — This button allows you to override those columns whose access is
Read Only (R). You can activate the Override button by selecting it directly or by
selecting the Clear button, which automatically activates it.
291
________________
EE Raceway Modeling Reference Guide - February 2003
This command accepts certain relational operators as search criteria. You should be familiar
with the following operators:
> greater than numeric This operator indicates that the queried values should
be greater than the given value.
< less than numeric This operator indicates that the queried values should
be less than the given value.
>= greater than numeric This operator indicates that the queried values should
or equal to be greater than or equal to the given value.
<= less than or numeric This operator indicates that the queried values should
equal to be less than or equal to the given value.
!= not equal to numeric This operator indicates that the queried values should
NOT be equal to the given value.
Steps
1. Select the Set Active One-Line Type Parameters command.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
292
________________ Set Active One-Line Type Parameters
Any value you place with the Set Active One-line Parameters
command will be entered into the drawing and, optionally, displayed.
When you load the project database, these values are loaded into the
project database.
11. Runtime
293
________________
EE Raceway Modeling Reference Guide - February 2003
You must set an active one-line type in order to use the Place One-Line Type
command.
Steps
1. Select the Set Active One-Line Type command.
2. From the list, select the one-line type you want to make active.
3. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
294
________________ Set Active System
11. Runtime
This command displays the current active system and all available systems, based on those
you selected from the reference database using the Define System command (see
Define System, page 258 ). Using the Set Active System form, you can select a new active
system from the set of those available.
You can have multiple systems defined for a single one-line type as a way of defining split
trays or elements. This is done by specifying a system and one or more subsystems. The
active system is automatically included as a subsystem. The active system determines the
symbology of the one-line type, whereas subsystems do not.
You can have no more than six systems active for each one-line type.
Field Descriptions
Systems — Selects the active system. When a new active system is selected, the
subsystems are all unselected. The active system is automatically included as a
subsystem. The active system determines the symbology of the raceway.
Subsystem — Selects the subsystems. While this button is depressed, the Percent and
Project Rule can be defined for each subsystem.
Active System — Displays the active system which determines the symbology of the
raceway.
Project Rule Set — Displays the Project Electrical Code from the your project
schema’s project table. This is defined in EEmgr with the EE CMS Project Definition
process. The Project Rule Set determines which rules can be assigned to the active
systems. If the Project Rule Set is not defined, Project Rules cannot be assigned.
Systems Column — Displays all the available systems. Selecting a row in this field
defines the Active System or Subsystems.
295
________________
EE Raceway Modeling Reference Guide - February 2003
Percent — Displays the current percent space allocation assigned to each of the
selected systems. The total space allocation cannot exceed 100 percent. The total of
the system percents is displayed in the field at the bottom of the Percent column. All
the selected systems percentages are summed to calculate the total percentage. The
Percent represents the portion of the raceway’s width assigned to that system. This
Percent is used when calculating the cable fill of the raceway section in the EECMS
product.
Project Rule — Displays the Project Rule assigned to each of the selected systems for
calculating raceway fill. When a row is selected, a list of available rules for the Project
Rule Set defined with the EE CMS Project Definition process is displayed for review
and selection. To clear the Project Rule, select the row and select the Cancel (X) on the
list of Rules.
List — Indicates whether or not a Project Rule can be assigned. If an * displays, then a
Project Rule can be assigned. To display a list of available rules for the Project Rule
Set defined with the EE CMS Project Definition process, select the *.
Steps
1. Select the Set Active System command.
2. Select the system and subsystem(s) you want to make active. To access the list of
subsystems, press the Subsystem button.
3. Define the percentages and the project rules you want to use.
4. Select Confirm (√) to save your changes and exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
296
________________ Propagation Setup
Propagation Setup
11. Runtime
This command sets the active parameters for propagating one-line elements in the design file.
For additional information about propagation, see The Drawing Process, page 108 .
Field Descriptions
Propagation Style — Defines the active style of propagation.
Cutback - Propagates straight sections, cutting them back to leave room for fittings.
Sketch - Sketches standard straights and fittings, using the dimensions of the cross
sections and the transition, radius, and extension on the one-lines and RCPs. Sketch
propagation is considerably faster than Eden propagation, but lacks the detail that Eden
propagation provides.
Eden - Retrieves one-line type and RCP dimensions from specifications in the database
and from overrides. Propagation sends these dimensions to the Eden symbol.
All fittings you place manually are propagated with Eden, regardless of
the settings on this form.
297
________________
EE Raceway Modeling Reference Guide - February 2003
If you set the toggle to On, elements are automatically propagated when placed. Also,
any changes you make to an element, like editing the size, that affect the graphical
display of the propagation, will cause the propagation to be deleted and redrawn to
reflect the change.
Steps
1. Select the Propagation Setup command.
3. Select Confirm (√) to save your changes and to exit the command.
— OR —
Select Cancel (X) to exit the command without saving any changes to the form.
298
________________ Set Active Levels
11. Runtime
This command displays the current active level(s) and allows you both to turn off any active
levels and to activate new levels.
View — Displays the active view. All level display settings on the form are valid for
whatever view is active. To change the active view, select a value from the list, or
select the field, and key in a new value.
Levels — Indicate what levels display in the design. They also allow you to turn off or
on the display of some or all available levels.
1 - 63 indicate whether or not each available level displays in the design. When a level
has its display turned on, the button appears to be depressed. To turn on or off the
display of a particular level, select the appropriate level number.
All Off — Turns off the display of all levels in the design.
Restore — Returns the display of levels in the selected view to its state prior to
entering the Set Active Levels command.
Turn Levels On/Off — This toggle enables or disables the display for the levels
associated with the one-line types in your design file.
To turn on or off the display of a particular level, select the Turn Levels On/Off
toggle, and then select the desired level number displayed in the Systems/One Line list.
299
________________
EE Raceway Modeling Reference Guide - February 2003
Graphics — Displays the level display for title block annotation in the design file.
Steps
1. Select the Set Active Levels command.
3. Select Confirm (√) to save your changes and to exit the command.
— OR —
Select Cancel (X) to exit the command without saving your changes.
300
________________ Display Element Information
11. Runtime
This command displays raceway element characteristics. If either a one-line, a straight
section, a fitting within a run, or an RCP within a run is selected, then run information is
displayed. This information includes: segment lengths, location and radius of each bend in
the run, and coordinate location of ends and bends.
If a fitting or an RCP that is at the termination of a run is selected, then the four key attributes
associated with the fitting are displayed.
Steps
1. Select the Display Element Information command.
— OR —
3. Accept/reject
Press <D> to accept the element and display that element’s information. Return to step
2.
— OR —
Press <R> to reject the highlighted element and select another element. Return to step
2.
301
________________
EE Raceway Modeling Reference Guide - February 2003
302
________________ Utilities Commands
12. Utilities
Commands
Toggle Construction Display On/Off — Turns the display of
construction class elements on or off.
Display Element Type and ASID ID — Displays the element type and
ASID ID of an identified element.
303
________________
EE Raceway Modeling Reference Guide - February 2003
304
________________ Using the Utilities Commands
12. Utilities
You must be familiar with precision input and its functions before using any of the Modify
commands, because it is through the Precision Input form that you will enter values for the
placement of points and for the location of raceway elements. For detailed information about
precision input, see
Precision Input Form, page 119 .
Group Workflow
In general, you will use those commands that display the attribute information of an element
(Display ASID ID, for example) before the commands that highlight elements based on the
attribute information you specify (Highlight Element by ASID ID, for example).
Operating Information
During the operating sequence for any of these commands, you can exit the command session
by pressing <Esc> or by selecting Cancel (X) on the precision input form. Pressing <R> or
selecting Reject on the precision input form will either reset the active command by one step
or reject a highlighted element in the design file.
305
________________
EE Raceway Modeling Reference Guide - February 2003
All non-displayed EE text elements are automatically placed in construction class. Therefore,
this command allows you to view all the non-displayed EE elements as well as any other
construction class elements.
Steps
1. Select the Toggle Construction Display On/Off command from the menu.
The top of the prompt area displays all views in which the Toggle Construction
Display On/Off command is toggled to On.
2. Select view
Place a data point in the view in which you want the annotation display toggled On or
Off. When construction display is On, the view number displays in a prompt.
Once you have exited the command, select the Update View command to see the
results of the display toggle.
306
________________ Highlight Element by Sector/Word
12. Utilities
You can specify a filename instead of the sector/word position to highlight an element. The
file must contain the sector/word position of the element(s) you want to highlight. The file
will display in a form on the screen, allowing you to select the sector/word value from the
displayed file. If you do not specify a pathname for the file, the command searches for it in
the <current_project>/rway/tmp directory.
Steps
1. Select the Highlight Element By Sector/Word command.
— OR —
Key in the name of a file containing the sector and word values. Go to Step 4.
4. Element highlighted
The element with the specified sector and word highlights in the view you identified.
307
________________
EE Raceway Modeling Reference Guide - February 2003
After you select a line, select Confirm (√) to accept the sector and word value in the
line. Go to Step 6.
— OR —
Select the Return button to cancel the file display form. Return to Step 1.
— OR —
The element with the specified sector and word highlights in the view you identified.
Press <D> to select another sector/word value from the File Display form. (When you
press <D> the form redisplays.) Go to Step 4.
— OR —
Press <R> to exit the file you identified in Step 1. Return to Step 1.
308
________________ Highlight Element by ASID ID
12. Utilities
propagation errors exist in your design file, you can specify the file pro.err. The file will
display in a form on the screen, allowing you to select the ASID ID from the displayed file. If
you do not specify a pathname for a file, the command searches for it in the
<current_project>/rway/tmp directory.
Steps
1. Select the Highlight Element By Asid Id command.
The All Elements button highlights all raceway elements associated with the element
having the given ASID ID: the element itself and all of its children.
The Parent of Elements button highlights the raceway elements that are the parents of
the element having the given ASID ID.
The Children of Elements button highlights the raceway elements that are the children
of the element having the given ASID ID.
The Only the Element button highlights only the raceway element having the given
ASID ID.
— OR —
309
________________
EE Raceway Modeling Reference Guide - February 2003
— OR —
— OR —
— OR —
5. Element highlighted
The raceway element(s) associated with the specified ASID ID highlight in the view you
identified.
— OR —
— OR —
310
________________ Highlight Element by ASID ID
7. After you select a line, select Confirm (√) to accept the ASID ID in the line. Go to step
8.
— OR —
Select the Return button to cancel the File Display form. Return to step 2.
— OR —
Select Cancel (X) to modify the highlight by asid mode. Return to step 1.
12. Utilities
8. Point to view for window
The element(s) associated with the specified ASID ID highlight in the view you
identified.
Press <D> to select another ASID ID from the file display form. (When you press <D>
the form redisplays.) Go to step 5.
— OR —
Press <R> to exit the file you identified in step 3. Return to step 3.
311
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Highlight Element By Link command.
— OR —
Key in the name of a file containing the entity and mslink values. Go to Step 4.
4. Element highlighted
The element with the specified entity and mslink values highlights in the view you
identified.
312
________________ Highlight Element by Link
After you select a line, select Confirm (√) to accept the entity and mslink values in the
line. Go to Step 6.
— OR —
Select the Return button to cancel the File Display form. Return to Step 1.
— OR —
12. Utilities
Point to the view where you want the element highlighted.
The element with the specified entity and mslink values highlights in the view you
identified.
Press <D> to select more entity and mslink values from the file display form. (When
you press <D> the form redisplays.) Go to Step 4.
— OR —
Press <R> to exit the file you identified in Step 1. Return to Step 1.
313
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Highlight Propagation Errors command.
2. Review the errors listed on the form. To highlight a particular error(s) in the design
file, select the error(s) from the list, and select Confirm (√).
The propagation error(s) highlights in the design file, and the pro.err form redisplays.
— OR —
— OR —
314
________________ Display Sector/Word Value
Steps
12. Utilities
1. Select the Display Sector/Word command.
2. Identify element
Select the element to display the sector/word for, and accept it with a <D>.
The sector and word for the selected element displays in the MicroStation command
window.
— OR —
315
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select the Display Element Type and ASID ID command.
2. Identify element
Select the element for which to display the ASID ID and accept it with <D>.
The element type and ASID ID display in the MicroStation command window.
— OR —
316
________________ Display Link
Display Link
This command displays the entity (table) and mslink, in the MicroStation command window,
of an identified element.
Steps
12. Utilities
1. Select the Display Link command.
2. Identify element
Select the element you want to display the link for and accept it with <D>.
The entity and mslink values display in the MicroStation command window in the
following format: Entity (table number) = <value>, mslink = <value>
— OR —
317
________________
EE Raceway Modeling Reference Guide - February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a command
action by one step or to reject a highlighted element, press <R> or select Reject on the
precision input form.
Steps
1. Select the Display System and One-Line Type command from the menu.
The precision input form displays, along with the Print System and One-Line Type
form.
— OR —
318
________________ Display System and One-Line Type
3. Raceway [element]
Accept/reject
The fields on the form fill with information about the element’s one-line type, system,
and subsystems (if applicable). The system prompts you to identify another element.
12. Utilities
— OR —
— OR —
319
________________
EE Raceway Modeling Reference Guide - February 2003
Commands
Activate Design Volume Coordinate System — Activates the Design Volume
Coordinate System (DVCS) allowing you to define a local coordinate system for a
particular model.
Activate Plant Coordinate System — Activates the Plant Coordinate System (PCS).
The Plant Coordinate System is common to all models and drawings in a project.
Show Active Coordinate System — Displays the active coordinate system in the
status field.
When the coordinate system is switched between the PCS and DVCS, model
graphics do not rotate to reflect the active coordinate system. Instead, the
coordinate system rotates when the active coordinate system is changed.
320
________________ Database Commands
Topics
Load Database — Loads the project database with information generated from the EE
Raceway drawing.
13. Database
Rulecheck — Displays the design rule errors occurring in the design process.
321
________________
EE Raceway Modeling Reference Guide - February 2003
Group Workflow
You must load the database before you can run a report or rulecheck.
Operating Information
Because the operating sequence, command key-ins, and screen prompts vary for each
command, instructions for using these commands are described in each individual command
section.
322
________________ Load Database
Load Database
This command loads a relational database with information generated by the EE Raceway
design file. Information in the design file is merged with information from the reference
schema and loaded into the project schema.
All RCP’s and segments must have a tag number before using this command.
When you run the Load Database command on a design file that has been loaded previously
into the database, the command removes the occurrences of the previous load and completely
reloads the design file.
You must create a RIS schema on an existing relational database before loading, using the
Database Utilities option from the EE Project Menu Both a project and a reference schema
must exist before running the Load Database process.
13. Database
rcp_to_drw pds_east* The PDS east coordinate of the corresponding RCP’s
origin.
drop_point ee_dist_down_ol** The distance down the one-line to the point on the
one-line closest to the drop point origin.
drop_point ee_dist_to_rcp** The orthogonal distance from the drop point origin to
the RCP’s origin, and the orthogonal distance from
the drop point origin to the closest point on the one-
line.
323
________________
EE Raceway Modeling Reference Guide - February 2003
straight pds_east* The PDS east coordinate of the center point of the
straight’s range.
straight pds_north* The PDS north coordinate of the center point of the
straight’s range.
fitting pds_east* The PDS east coordinate of the center point of the
fitting’s range.
fitting pds_north* The PDS north coordinate of the center point of the
fitting’s range.
* The Raceway bill of material by volume report relies on these columns to be in the fitting
and straight tables. The columns are optional for Load Database.
** You can override the value for these columns by annotating the appropriate elements in the
design file.
*** These values indicate the portion of a split raceway dedicated to each system within
the split raceway.
324
________________ Steps
Steps
1. Select Load database command.
Key in unique filenames in the Error file and Output file fields, or accept the
13. Database
displayed defaults.
The default error and message files will be overwritten every time the
process runs. You must specify unique filenames to save the default
files.
When you are finished completing the input information, select Confirm (√), and the
process begins.
When complete, the process will return one of two messages (described below) to the
screen.
Messages
Error occurred during process
If any errors occur, the message above displays. The error file lists all the errors that
occurred during processing. This file will be displayed automatically to the screen,
where you may review the errors.
If no errors occurred, the message above displays. The message file is created on every
run of the process, and is displayed automatically to the screen. It lists everything that
was loaded into the database.
325
________________
EE Raceway Modeling Reference Guide - February 2003
Report
This command accesses the standard EE Raceway reports. These reports report on the project
and reference databases. You must load the project database before running any reports.
All reports are kept in the /reports directory; see Create Project for the
directory structure.
Overview
This section contains general information about running all EE Raceway reports. See
Reports, page 545 for more detailed information about individual reports.
The system manager can change the names of the reports that display in the
listing area and can add additional reports by editing the report.dat file
(win32app\eerway\data).
When you process a report, an input screen displays, allowing you to enter all input necessary
to run the report.
Key in any information that is not supplied by default. You can change the name of the
output file or error file. To change the output filename, select the output file box and key in a
new name. (No file extension is automatically appended to the name you key in.)
326
________________ Report
If you want to save reports throughout a project, you should name the output files
yourself. If a new output file has the same name as an existing file, the new file
will overwrite that file. You should give each report you want to save a unique
name.
Steps
1. Select the Report command.
3. Select Confirm (√) to invoke the input form for the specified process.
4. Define the report input form as needed and select Confirm (√) to process the report.
13. Database
report is pulled.
Any Raceway component extending outside the clipping volume defined by the High and
Low Range Coordinates will not be included in the report output.
You can find the coordinates you want to use by using the active point coordinate display on
the precision input form. The coordinate values need to be in subunits and entered in the form
field with a space between the coordinates: easting northing elevation For example, 234
532 34
327
________________
EE Raceway Modeling Reference Guide - February 2003
328
________________ Rule Checks
Rule Checks
This command accesses the standard EE Raceway Rule Checks. These rule checks are
reports that identify violations of certain design rules by working on the project database. You
must load the project database before running any rule checks.
Overview
13. Database
This section contains general information about running all EE Raceway rule checks. For
more detailed information about each rule check, see Reports, page 545 .
The system manager can change the names of the reports or add new reports to
the listing area by editing the rule_chk.dat file in win32app\eerway\data.
The name of the rule check report displays at the top. Accept the default information that
displays in the input fields, or change that information according to your specifications.
329
________________
EE Raceway Modeling Reference Guide - February 2003
If you want to save reports throughout a project, you should name the output files
yourself. If a new output file has the same name as another file created previously,
the new file will destroy the previously created file. You should give each report
that you want to save a unique name.
Steps
1. Select the Rule command.
2. Select the rule check report you want to run from the listing area.
3. Select Confirm (√) to invoke the input form for the specified process.
4. Define the input form as needed and select Confirm (√) to process the rule check
report.
330
________________ Raceway Processes
Load Database — Loads the project database with information generated from the EE
Raceway drawing.
Unload Design — Removes all the information associated with a particular drawing
from the project database, based on the design filename you specify.
Unload Sheet — Removes all the information associated with a particular drawing
from the project database, based on the internal sheet name you specify.
Cleanup Database — Removes any data from a project database that is not currently
associated with a design in the project’s ../rway/dgn directory.
Create Interference Envelope (default name) — Reads the design file and creates a
data file that contains envelopes for input to Plant Design interference detection tasks.
Create Interference Envelope (given name) — Reads the design file and creates a
data file, with the name you specify, that contains envelopes for input to Plant Design
interference detection tasks.
Processes
14. EERWAY
331
________________
EE Raceway Modeling Reference Guide - February 2003
Load Database
This process loads a relational database with information generated by an EERWAY design
file. Information in the design file is merged with information from the reference schema and
loaded into the project schema.
332
________________ Load Database
* The Raceway bill of material by volume report relies on these columns to be in the fitting
and straight tables. The columns are optional for Load Database.
** You can override the value for these columns by annotating the appropriate elements in the
design file.
*** These values indicate the portion of a split raceway dedicated to each system within
the split raceway.
Steps
1. Select Load database from the Process menu, and select Confirm (√).
Processes
14. EERWAY
Select a design file from the Drawing List or key in a design filename (you may
specify multiple design files).
333
________________
EE Raceway Modeling Reference Guide - February 2003
Key in unique filenames in the Error file and Output file fields, or accept the
displayed defaults.
The default error and message files will be overwritten every time the
process runs. You must specify unique filenames to save the default
files.
The current operating mode is displayed in a box at the lower right of the screen.
You may choose between Foreground, Background, and Batch operating modes for
most processes (see Process, page 64 ).
When you are finished completing the input information, select Confirm (√), and the
process begins. When complete, the process will return one of two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the message above displays. The error file lists all the errors that occurred
during processing. This file will be displayed automatically to the screen, where you may
review the errors.
If no errors occurred, the message above displays. The message file is created on every run of
the process, and is displayed automatically to the screen. It lists everything that was loaded
into the database.
You can view both files using the Output option on the Utilities page.
334
________________ Batch File Option
Example of rway.bat:
SET MS=D:\WIN32APP\USTATION
SET MS_EXE=D:\WIN32APP\USTATION
SET EES_REFDB=CERT60_REF
SET EE_SCHEMA=CERT60_PRJ
SET EERD_MSGS=D:\WIN32APP\INGR\EERWAY\MSG\
SET EERD_TBLS=D:\WIN32APP\INGR\EERWAY\MSG\
Processes
14. EERWAY
335
________________
EE Raceway Modeling Reference Guide - February 2003
Unload Design
This process unloads a design from a relational database, based on the design filename you
specify. You must have loaded the database using the Load Database process before
unloading. The Unload Design process deletes all records of raceway connect points (RCP),
one-lines, and three-lines that are part of the specified drawing. The process will not modify
anything in the reference database, nor will it delete information from user-defined tables.
Steps
1. Select Unload from the Process menu, and select Confirm (√).
Select a design file from the Drawing List or key in a design filename (you may
specify multiple design files).
3. Key in unique filenames for the error and message files (or accept the default
filenames).
The default error and message filenames are displayed in appropriate fields. You may
change the defaults by selecting the fields and keying in new names.
The default error and message files will be overwritten every time the
process is run, unless you specify unique filenames in these fields.
336
________________ Unload Design
The current operating mode is displayed in a box at the lower right of the screen.
You may choose between foreground, background, and batch operating modes for
most processes (see Process, page 64 ).
When you are finished completing the input information, select Confirm (√), and the
process begins. When complete, the process will return one of two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in
the current working directory, lists all the errors that occurred during processing. The
file is automatically displayed to the screen for your review.
If no errors occurred, the message above displays. The .msg file, an ASCII file located
in the current working directory, is created on every run of the process, and lists
everything that was loaded into the database. The file is automatically displayed to the
screen for your review.
You can view both files using the Output option on the Utilities page.
Processes
14. EERWAY
337
________________
EE Raceway Modeling Reference Guide - February 2003
Unload Sheet
This process unloads an EE Raceway drawing from a relational database, based on the
internal sheet name you specify. You must have loaded the database using the Load
Database process before unloading.
The Unload Sheet process deletes all records of raceway connect points (RCP), one-lines, and
three-lines that are part of the specified drawing. The process will not modify anything in the
reference database.
The drawing you are unloading must have a title block, and the sheet name in the title block
must match the database entry for that drawing, since the process keys off the sheet name in
the title block. If the sheet name contains blanks, it must be specified in single quotes.
Steps
1. Select Unload Sheet from the Process menu, and select Confirm (√).
3. Key in unique filenames for the error and message files (or accept the default
filenames).
The default error and message filenames are displayed in appropriate fields. You may
change the defaults by selecting the fields and keying in new names.
338
________________ Unload Sheet
The default error and message files will be overwritten every time the
process is run, unless you specify unique filenames in these fields.
The current operating mode is displayed in a box at the lower right of the screen.
You may choose between foreground, background, and batch operating modes for
most processes (see Process, page 64 ).
When you are finished completing the input information, select Confirm (√), and the
process begins. When complete, the process will return one of two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The file is
automatically displayed to the screen for your review.
If no errors occurred, the message above displays. The .msg file, an ASCII file located in the
current working directory, is created on every run of the process, and lists everything that was
loaded into the database. The file is automatically displayed to the screen for your review.
Processes
14. EERWAY
You can view both files using the Output option on the Utilities page.
339
________________
EE Raceway Modeling Reference Guide - February 2003
Cleanup Database
This process removes information from the database that is not in any drawing currently
loaded in the database.
For example, information may have been added through the Relational Database Management
System (RDBMS) to test for a special case or to create customized tables. This process also
removes information on any EE Raceway drawing which has been deleted, but for some
reason was not removed from the database.
The Cleanup Database process deletes all records of raceway connect points (RCP), one-
lines, and three-lines that are part of the project database but which are not part of any
raceway design file. This process will not unload records of customized tables in the
database. The process uses the filenames in the drawing table of all current drawings. It then
makes a list of all valid drawings, and deletes anything from the database which is not
connected to one of these drawings. This process will not delete drawings. It will delete from
the database only that information which is not in any current drawing.
Steps
1. Select Cleanup Database from the Process Menu, and select Confirm (√).
Key in unique filenames in the Error file and Output file fields, or accept the
displayed defaults.
340
________________ Cleanup Database
The default error and message files will be overwritten every time the
process runs. You must specify unique filenames to save the default
files.
The current operating mode is displayed in a box at the lower right of the screen.
You may choose between Foreground, Background, and Batch operating modes for
most processes (see Process, page 64 ).
When you are finished completing the input information, select Confirm (√). The
process begins. When complete, the process will return one of two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing.
If no errors occurred, the message above displays. The .msg file, an ASCII file located in the
current working directory, is created. It will display mostly zeroes, and it includes a log of
what was unloaded during processing.
Processes
14. EERWAY
You can view either file using the Output option on the Utilities screen.
341
________________
EE Raceway Modeling Reference Guide - February 2003
After running the Interference Detection process in EE Raceway, you may send the file to
Plant Design software and run it against PDS interference detection. The purpose of the entire
process is to ensure that each raceway does not occupy the same space as other raceways.
Steps
1. Select Interference Detection from the Process menu and select the Confirm button
(√).
— OR —
Select a design file from the Drawing List (use the Select All button to select all files
from the list) or key in a design filename.
3. Key in unique filenames for the error and output files (or accept the displayed default
filenames).
The default error and output files will be overwritten every time you run
the process unless you specify unique filenames in the fields.
342
________________ Create Interference Envelope (default name)
The current operating mode displays in a box at the lower right of the screen.
You may choose between foreground, background, and batch operating modes (see
the section entitled EE Raceway Environment for information about operating modes).
When you finish completing the input information, select the Confirm button (√). The
process begins. When complete, the process returns one of the two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the above message displays. The .err file, an ASCII file located in the
<current_project>.prj/rway/tmp directory, lists all errors that occurred during the process.
This file displays immediately to the screen for your review. Otherwise, you can view the file
through the Output option on the Utilities screen.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
<current_project>.prj/rway/tmp directory, displays all processing information. This file
displays immediately to the screen for your review. Otherwise, you can view the file through
the Output option on the Utilities screen.
Processes
14. EERWAY
343
________________
EE Raceway Modeling Reference Guide - February 2003
After running the Interference Detection process in EE Raceway, you may send the file to
Plant Design software and run it against PDS interference detection. The purpose of the entire
process is to ensure that each raceway does not occupy the same space as other raceways.
Steps
1. Select Interference Detection from the Process menu and select the Confirm button
(√).
— OR —
Select a design file from the Drawing List (use the Select All button to select all files
from the list) or key in a design filename.
4. Key in unique filenames for the error and output files (or accept the displayed default
filenames).
The default error and output files will be overwritten every time you run
the process unless you specify unique filenames in the fields.
344
________________ Create Interference Envelope (given name)
The current operating mode displays in a box at the lower right of the screen.
You may choose between foreground, background, and batch operating modes (see
the section entitled EE Raceway Environment for information about operating modes).
When you finish completing the input information, select the Confirm button (√). The
process begins. When complete, the process returns one of the two messages (described
below) to the screen.
Messages
Error occurred during process
If any errors occur, the above message displays. The .err file, an ASCII file located in the
<current_project>.prj/rway/tmp directory, lists all errors that occurred during the process.
This file displays immediately to the screen for your review. Otherwise, you can view the file
through the Output option on the Utilities screen.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
<current_project>.prj/rway/tmp directory, displays all processing information. This file
displays immediately to the screen for your review. Otherwise, you can view the file through
the Output option on the Utilities screen.
Processes
14. EERWAY
345
________________
EE Raceway Modeling Reference Guide - February 2003
346
________________ Eden Processes
You will access the Eden processes from the EDEN option found on the EE Raceway
Drawing Menu. For information about accessing the processes, see Electrical Engineer (EE)
Raceway Environment, page 59 .
The path to the symbol library called in many of the Eden processes is defined by the variable
RWAY_EDEN_LIB. The delivered default symbol library path is win32app\eerway\eden. If
you want to place your Eden library in a different directory, then edit the .EErc file in your
home directory, exporting RWAY_EDEN_LIB to specify the appropriate directory.
The path to the extracted symbol source file called in many of the Eden processes is defined
by the variable RWAY_EDEN_SRC. The delivered default symbol source file path is
<current_project>/rway/tmp. If you want to place your source symbol files in a different
directory, then edit the to specify the appropriate directory.
For a general description of Eden symbol generation, see the PDS Eden Interface Reference
Guide. You should also consult the appendix in this guide entitled Eden Symbol Generation .
Compile EDEN Symbol — Compiles an Eden symbol file, and gives you the option
of placing the symbol in an Eden symbol library.
Delete EDEN Symbol — Deletes an Eden symbol from the Eden symbol library.
List EDEN Symbol Library — Lists Eden symbols in a selected Eden symbol library.
List EDEN User Functions — Lists Eden user functions in a selected Eden symbol
library.
Merge EDEN Symbol Libraries — Merges the contents of two Eden symbol
libraries into one library.
Extract EDEN Symbol From Library — Extracts a specified symbol from an Eden
symbol library.
Extract EDEN User Function From Library — Extracts a specified user function
from an Eden symbol library.
347
________________
EE Raceway Modeling Reference Guide - February 2003
Edit EDEN Symbol File — Uses a standard ASCII editor to edit a specified symbol
source file.
348
________________ Compile EDEN Symbol
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. For
information about the path to the symbol library, see the description at the beginning of
this chapter. To change the displayed default library name, select the field, and key in a
new library name.
Enter symbol source file — Displays the name of the symbol source file to compile.
For information about the path to the symbol source file, see the description at the
beginning of this chapter. To enter the symbol source file, select the field, and key in a
filename.
Enter option — Displays the default compile option (-o). The -o option lists the
compiled Eden symbol file, and then adds the symbol to the specified library. The -l
option simply lists the compiled Eden symbol file. To change the displayed option,
select the field, and key in a new option.
Processes
15. Eden
349
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select Compile EDEN Symbol from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
350
________________ Delete EDEN Symbol
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in a new library name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Enter symbol name — Displays the name of the symbol you intend to delete from the
library. To enter the symbol name, select the field, and key in the name.
For information about the path to the symbol source file, see the description at the
beginning of this chapter.
Processes
15. Eden
351
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select Delete EDEN Symbol from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in
the current working directory, lists all the errors that occurred during processing. The
.err file displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located
in the current working directory, contains any output from the process. The file
displays immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
352
________________ List EDEN Symbol Library
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in a new library name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Processes
15. Eden
353
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select List EDEN Symbol Library from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
354
________________ List EDEN User Functions
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in a new library name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Steps
1. Select List EDEN Symbol Library from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
355
________________
EE Raceway Modeling Reference Guide - February 2003
When you have completed the input information, select Confirm (√), and the list will
display.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
356
________________ Merge EDEN Symbol Libraries
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Merge into library name — Displays the name of the symbol library into which you
will merge the contents of a second library. To enter a library name, select the field,
and key in a name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Merge from library name — Displays the name of the symbol library whose contents
you will merge with first library. To enter a library name, select the field, and key in a
name.
For information about the path to the symbol library, see the description at the
beginning of this chapter. Processes
15. Eden
Steps
1. Select Merge EDEN Symbol Libraries from the list, and select Confirm (√).
357
________________
EE Raceway Modeling Reference Guide - February 2003
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
358
________________ Compress EDEN Symbol Library
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in the name of the library you intend to
compress.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Steps
1. Select Compress EDEN Symbol Library from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
359
________________
EE Raceway Modeling Reference Guide - February 2003
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
360
________________ Extract EDEN Symbol From Library
The path to the extracted symbol source file is defined by the variable RWAY_EDEN_SRC.
The delivered default source symbol path is win32app\eerway\eden. If you want to store
your source symbol files in another directory, then edit the .EErc file in win32app\eenuc,
exporting RWAY_EDEN_SRC to define the appropriate directory.
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in a new library name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Enter symbol name — Displays the name of the symbol you intend to extract from the
library. To enter the symbol name, select the field, and key in the name.
Processes
15. Eden
361
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select Extract EDEN Symbol From Library from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
362
________________ Extract EDEN User Function From Library
The path to the extracted user function source file is defined by the variable
RWAY_EDEN_SRC. The delivered default source user function path is
win32app\eerway\eden. If you want to store your source user function files in another
directory, then edit the .EErc file in win32app\eenuc, exporting RWAY_EDEN_SRC to
define the appropriate directory.
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter library name — Displays the default Eden symbol library name. To change the
displayed library name, select the field, and key in a new library name.
For information about the path to the symbol library, see the description at the
beginning of this chapter.
Enter symbol name — Displays the name of the user function you intend to extract
Processes
15. Eden
from the library. To enter the user function name, select the field, and key in the name.
363
________________
EE Raceway Modeling Reference Guide - February 2003
Steps
1. Select Extract EDEN User Function From Library from the list, and select Confirm
(√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
364
________________ Extract EDEN User Function From Library
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
Processes
15. Eden
365
________________
EE Raceway Modeling Reference Guide - February 2003
Output file — Displays the file to which process messages are sent. To change the
displayed output filename, select the field, and key in a new filename.
Error file — Displays the file to which error messages are sent. To change the
displayed error filename, select the field, and key in a new filename.
Enter editor — Displays the name of the default ASCII editor (vi) that you will use to
edit the Eden symbol file. To change the displayed editor, select the field, and key in a
new standard ASCII editor name.
Enter symbol file name — Displays the name of the symbol file you intend to edit. To
enter a symbol filename, select the field, and key in a symbol file name.
For information about the path to the symbol source file, see the description at the
beginning of this chapter.
366
________________ Steps
Steps
1. Select Edit EDEN Symbol File from the list, and select Confirm (√).
The current operating mode displays in a box at the lower right of the screen. You can
choose between foreground, background, and batch operating modes. For
information about operating modes, see EDEN, page 67 .
When you have completed the input information, select Confirm (√), and the Eden
process begins.
Messages
Error occurred during process
If any errors occur, the message above displays. The .err file, an ASCII file located in the
current working directory, lists all the errors that occurred during processing. The .err file
displays immediately to the screen for your review.
If no errors occurred, the above message displays. The .msg file, an ASCII file located in the
current working directory, contains any output from the process. The file displays
immediately to the screen for your review.
You can view either file on the screen, see Output, page 89.
Processes
15. Eden
367
________________
EE Raceway Modeling Reference Guide - February 2003
368
________________ Integrated Commands
The Integrated Commands palette is activated by selecting Integrated Commands from the
EE Raceway File Menu Bar, then selecting Palette from the resulting pull-down menu.
Commands
16. Integrated
369
________________
EE Raceway Modeling Reference Guide - February 2003
Reference PDS Model – There are no prerequisite conditions for using this command.
Window to Named PDS Item – You must have existing items in the active model or in
an attached PDS reference file.
Review PDS Clash – You must first have run IFC Clash Detection, and must have an
existing clash in the design area.
Group Workflow
There is no required or suggested sequence for using the commands in this group.
Operating Information
See individual command descriptions for specific operating information.
370
________________ Review PDS Attributes
To view pipe centerlines (to review the line segments), you need to display
construction type elements. Use the MicroStation Settings > View Attributes
> Turn on construction command.
Parameters
Attribute Name – Lists the item’s attributes.
Value – Displays the item’s attribute value that is defined in the database.
Commands
16. Integrated
371
________________
EE Raceway Modeling Reference Guide - February 2003
Parameters
Disciplines – Lists all disciplines. Select the discipline which contains the model you
want to attach; then, click Attach.
Areas – Lists all design areas defined in the active project. Select the design area
which contains the model you want to attach; then, click Attach.
— Attach by Model – Displays all models in the design area so you can select which
model you want to attach.
Propagated/Sparse – Specify whether you want to attach the sparse model or the
corresponding propagated model. This option only displays if you are attaching a
structural model.
Attach – Attaches a reference model. You must select a Discipline and a Design Area
before you can select a reference model to attach.
Detach – Detaches the selected reference model. You must click Show Attachments
and select the reference model you want to detach before clicking Detach.
372
________________ Reference PDS Model
Show Attachments – Displays all reference models attached to the active model.
Commands
16. Integrated
373
________________
EE Raceway Modeling Reference Guide - February 2003
Options
Active Model / Reference Files – Specifies whether to look for the item in the active
model or in the attached reference files.
Discipline – Specifies the discipline of the item you are looking for. You can select:
Piping, Equipment, PE HVAC, or Raceway. Depending on which discipline you select,
the item attributes you can search for changes.
— Piping Attributes – Line Number Label, Line ID, Inspection Iso ID, Piping
Component Number, Pipe Tag, Instrument Component Number, or Pipe Support
Number
— Raceway Attributes – RCP Tag, One Line Tag, Drop Point Tag, or Equipment ID
374
________________ Review PDS Clash
Parameters
Project Name – Displays the active project name.
Date – Displays the date and time the clashes were detected.
Unapprove Clash – Changes the status of the clash from approved to unapproved.
Approve Real Clash – Approves the clash as a real clash in the Project Control
Database.
Approve False Clash – Approves the clash as a false clash in the Project Control
Database.
Commands
16. Integrated
Clash Marker – Displays the number of the current clash. Select a marker number
with the left and right arrows; or, select the field and key in a marker number.
375
________________
EE Raceway Modeling Reference Guide - February 2003
Item A – Displays the model name and the corresponding design area that has the one
item of the clash. The descriptions of the clashing component display below the model
name and design area.
Item B – Displays the model name and the corresponding design area that has the one
item of the clash. The descriptions of the clashing component display below the model
name and design area.
Comments – Displays existing comments about the active clash. You can also select
the field and type in any additional information.
Select View – Zooms in and updates the selected view. Click Select View then select
the view you want to update.
376
________________ Appendix A: Error Messages
Messages
A: Error
This appendix has an alphabetical listing of error messages you may receive when you are running EE Raceway
Modeling. The likely reason for the error and the recovery are listed with the error message wherever this is
possible.
Recovery: Use the Set Active One-Line Type to set an active one-line type.
Ambiguous Command
Reason: The command name you keyed in is not unique.
377
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Review the fitting in the design. If the fitting is a specification-driven part, then the given
specification does not have that part defined in its part table.
Recovery: Make corrections so that the system will load without errors.
Recovery: Make corrections so that the one-line will load without errors.
378
________________ Appendix A: Error Messages
Messages
A: Error
Reason: The straight is attached to a one-line belonging to a system that failed to load.
Recovery: Make corrections so that the system will load without errors.
Recovery: None.
Recovery: Be sure the database exists and that you have privilege.
379
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Verify that a valid one-line type is active, and replace the one-line. If the problem persists, call
Intergraph support.
Recovery: Verify that a valid system is active, and replace the one-line. If the problem persists, call Intergraph
support.
Recovery: Either key in another name or delete the cell from the cell library so it may be recreated.
380
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Enter a new value within the range 0 to 127.
Recovery: None.
Recovery: Have the system manager place the file where it belongs.
Recovery: Use the Delete command to remove the associated one-lines and then replace them.
381
________________
EE Raceway Modeling Reference Guide - February 2003
Could not get one line type part table from user data.
Reason: Corrupt user data on one-line or RCP.
Recovery: Check the file permissions and the existence of the file.
Recovery: Check the file permissions and the existence of the file.
382
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Check the file permissions and the existence of the file.
Recovery: Check to see that the design file has a type 63 element and at least 7 blocks in it.
Recovery: None.
Recovery: None.
Recovery: Check to see that the design file has a type 63 element and at least 7 blocks in it.
383
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Check to see that the design file has a type 63 element and at least 7 blocks in it.
Recovery: Change the value to one that appears in the codelist table.
Recovery: Make sure you have write access to the design file.
Recovery: Make sure the key is correct. The database is case-dependent. If the key does not exist, insert it into
the reference database.
384
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Key in a filename with fewer than 128 characters.
Recovery: Create a drop point cell and/or enter the correct drop point cell name in the EE Raceway defaults
form.
Recovery: Modify the radius or extension of the fitting, change the spec, or replace the one-line so that it has
enough room to create the fitting.
Recovery: None.
385
________________
EE Raceway Modeling Reference Guide - February 2003
386
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Enter a new asid number.
Recovery: Make sure the pro.err file and the rway/tmp directory have read/write privileges.
387
________________
EE Raceway Modeling Reference Guide - February 2003
388
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Call Intergraph support.
Recovery: Make sure that RWAY_EDEN_LIB and EDEN_LIB are set up properly in your .EErc file.
389
________________
EE Raceway Modeling Reference Guide - February 2003
390
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Add privilege to the database.
391
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Delete the one-line containing the RCP and place it again.
Recovery: Delete the one-line containing the RCP and place it again.
Recovery: Run the Create Database process with the rwayref.sql file.
392
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Run the Create Database process with the rwayref.sql file.
393
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Edit the sheet name. The sheet name must be unique within the database.
Recovery: Return to the environment and make sure you are using the correct reference schema.
394
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Call Intergraph support.
395
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Write over the existing file or attach new file to existing file.
Recovery: Modify the radius, extension or transition of the fitting, change the spec, or replace the one-line so
that it has enough room to create the fitting.
396
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Enter a new value within the range 0 to 255.
Recovery: Make sure the referenced form file exists in the path defined by EE_FORM_PATH which is defined
in the product.
Recovery: Make sure the referenced form file exists in the path defined by EE_FORM_PATH which is defined
in the product.
397
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Remove the function name from the EERWAY_LOCKED_OUT variable in the ./config/assign file.
Recovery: Delete the highlighted element or move it outside the fence area.
398
________________ Appendix A: Error Messages
Invalid asid id
Reason: An element cannot be found in the design file with the given asid id.
Messages
A: Error
Recovery: Key in another asid id.
Invalid Connection
Reason: The identified RCP has a higher priority level than the identified one-line.
Recovery: Make sure the priority level of the identified RCP is less than or equal to the priority level of the
one-line.
Recovery: Change the criteria on the Manual Placement form or modify the symbol.
Recovery: Modify the reference database to contain a symbolname for each part.
399
________________
EE Raceway Modeling Reference Guide - February 2003
Invalid input
Reason: You entered an incorrect value.
Recovery: Key in a new value greater than 0. If it is a cable entry, click on the REMOVE button to delete.
400
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Turn Part Verification off OR add the fitting to the database.
Recovery: Turn Part Verification off OR add the elbow or straight to the database.
Recovery: You can only remove an RCP with exactly two one-lines attached.
Invalid response
Reason: You entered an invalid response to a system prompt.
401
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Delete the element and place it again or recreate the element.
402
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Fix other problems.
Recovery: Terminate before exceeding the max, and place the element or RCP.
Mismatched annotation
Reason: Annotation was found that has no parent inside of the fence area.
Must be LT, LC, LB, CT, CC, CB, RT, RC, or RB.
Reason: Invalid text justification entered.
403
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Define an active one-line type using the Set Active One-Line Type command.
Recovery: Define an active system using the Set Active System command.
404
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Key in another name.
No elements in fence
Reason: The defined fence does not contain a valid element within its borders.
No memory available!
Recovery: Exit the process and re-enter and/or reboot the workstation.
Recovery: Modify the reference database to include A, B, C for the cross section type.
Recovery: Press the Override button and key in the value again.
Recovery: Define a one-line type from the reference database using the Define One-Line Type command.
405
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Define a system from the reference database using the Define System command.
Recovery: Make sure the active specification is in the database through Define Raceway Parameters.
406
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Populate the database.
Recovery: Insert the rows into the codelist table that corresponds to the column.
Recovery: Attach a cell library that has read/write permissions or assign write permission to the current cell
library.
Recovery: The design file must be created using the EE Raceway seed file.
407
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Give length in the Length field on the Manual Placement form.
Recovery: None.
408
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Identify one of these elements.
409
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: Make sure EE_SYM_FILE and EE_SYM_PATH are defined in the directory.
Recovery: Add the missing entry into the mscatalog table by loading the mscat.unl file or inserting a row
through SQL.
410
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Enter a new value greater than zero.
Recovery: None.
Recovery: None
Recovery: Highlight the cell with that Asid and look to see if an envelope needs to be built for the complex
shape in that cell. Rebuild cell so that the complex shape meets a line or surface at 90 degrees. To ensure a
measure of 90 degrees, snap to the angle.
411
________________
EE Raceway Modeling Reference Guide - February 2003
Recovery: If necessary, you can add a column to the project database and copy the values over.
Recovery: Modify the specification or parts through annotation OR modify or replace the one-lines.
Recovery: Make sure EE_FORM_PATH is defined in the ./config/assign file and that its value is a full path.
Recovery: Make sure EE_SYM_PATH is defined in the ./config/assign file and that its value is a full path.
412
________________ Appendix A: Error Messages
Messages
A: Error
Recovery: Accept or reject the system selection form.
413
________________
EE Raceway Modeling Reference Guide - February 2003
414
________________Appendix B: System/Application Manager Information
Appendix B System/Application
Manager Information
This appendix and the following appendices outline the responsibilities for
the EE Raceway system or application manager. Included in these
appendices are important references and procedures needed to prepare and
customize the EE Raceway product:
Mgmt.
B: System/App
schema descriptions for both the reference and project databases. Important
new procedures related to RIS and the databases are described in this
section.
Appendix L: RIS Schema Definition File describes the file that maintains
all schema definitions known to RIS.
415
________________
EE Raceway Modeling Reference Guide - February 2003
416
________________ Appendix B: Customizing
Customizing
Some simple customization is described in the appendices entitled
Customizing, alias.cmd, and rway.cmds (all involve modifying existing text
files using an editor). More extensive customization is possible for
advanced users. Such customization includes writing processes and user
commands using the MicroStation software. Refer to the MicroStation
Applications Programmer’s Guide for this latter procedure.
Mgmt.
B: System/App
Several designs of the precision input form are delivered with EE Raceway.
The available precision input forms (described below) reside in
win32app\eerway\sym.
To change the form design, set the variable EE_PIFORM in the .EErc file
(win32app\eenuc) to a different form name.
417
________________
EE Raceway Modeling Reference Guide - February 2003
ee_transition real,
ee_radius real,
weight real,
material char(20),
ee_xs_cell char(6),
ee_spec_key char(28) not null,
description char(40)
);
create index i_fsvendor on trench_spec(vendor);
create index i_fsheight on trench_spec(ee_out_ht_diam);
create index i_fswidth on trench_spec(ee_out_width);
create unique index i_fseekey on trench_spec(ee_spec_key);
grant all on trench_spec to public;
2. Add any new vendors to the vendor table in the reference database.
You can add the necessary rows directly to the vendor codelist table
in the database, or you can add the data to your vendor.unl file.
For sample files, refer to the tray_spec and tray_part .unl files that
are delivered with EE Raceway.
418
________________ Appendix B: Customizing
5. Add records to the mscatalog table (in the reference database) for
both the <one-line_type>_spec and the <one-line_type>_part tables.
Mgmt.
B: System/App
mscatalog table or by inserting records in the mscatref.unl file.
6. Add records to the mscolumns table (in the reference database) for
both the <one-line_type>_spec and the <one-line_type>_part tables.
You can accomplish this either by adding the row directly to the
ol_type table or by inserting records in the olt.unl file.
9. Run the Update reference schema process to add your new one-line
type to the database.
419
________________
EE Raceway Modeling Reference Guide - February 2003
2. Add any new vendors to the vendor table in the reference database.
You can add rows directly to the vendor codelist table in the database,
or you can insert records in the vendor.unl file.
3. Add the new special fitting to the three-line type codelist table.
You can add the entry directly to the tl_type table in the database, or
you add the data to your tlt.unl file.
4. Create any new Eden symbols needed to graphically display the new
special fitting.
For basic information about creating Eden symbols, see the appendix
entitled Eden Symbol Generation.
For a sample special fitting .unl file, refer to the pullbox.unl file that
is delivered with EE Raceway.
7. Add a row to the mscatalog table (in the reference database) for the
special fitting table.
420
________________ Appendix B: Customizing
8. Add a row to the mscolumns table (in the reference database) for the
special fitting table.
You can accomplish this either by adding the row directly to the
mscolumns table in the database, or by inserting a record in the
mscolref.unl file.
9. Add necessary rows to the mscodelist table (in the reference database)
for any columns that are codelisted for the special fitting.
Mgmt.
B: System/App
You can accomplish this either by adding rows directly to the
mscodelist table or by inserting records in the mscodref.unl file. For
information about codelists, see the appendix entitled EE Databases.
10. Add the new special fitting entry to the manual part table.
11. Run the Update reference schema process to add your new special
fitting to the database.
Reports
You can create or modify standard and rule check reports. The report
template library is delivered in the win32app\eerway\report directory.
Delivered reports are created using the RISRPT product and are compatible
with the DB Access (DBA) product. Reports may also be created using the
native RDBMS report writing product.
Error Messages
Error messages for the delivered commands are located in the error.msg
files in both win32app\eerway\msg and win32app\eenuc\msg. In these files,
the hard-coded error message name is to the left of each = (equal sign). You
cannot change this name. To the right of each = is the message itself, which
you can modify. Use a standard text editor to modify the error.msg files.
421
________________
EE Raceway Modeling Reference Guide - February 2003
EE Environment Variables
This section lists and describes the environment variables that are delivered when you
download EE Raceway. They include Microstation, EE Nucleus, and EE Raceway-specific
variables.
These environment variables can be modified using the Start > Programs > EENUC > EE
Configure command.
For MicroStation:
For EE Raceway:
MS_CACH Sets the memory to be allocated for a design file editing session. This
variable will override the user preferences setting.
422
________________ Appendix B: EE Environment Variables
The following are the environment variables that are recognized by the EE Nucleus product.
An asterisk (*) indicates that you cannot override a particular value.
Mgmt.
B: System/App
EE_CUSTOM_REFSQL User-defined reference database sql file.
EE_CUSTOM_REFCMD User-defined reference database cmd file.
The following are the environment variables defined in the win32app\eenuc\.EErc file,
delivered with the EE Nucleus product. An asterisk (*) indicates that you cannot
override a particular value.
For EE Raceway:
The following are the environment variables defined in the win32app\eenuc\bin\EE file,
delivered when you download the EE Nucleus product.
The following are the environment variables defined using the EE Configure command,
delivered when you download the EE Nucleus product. An asterisk (*) indicates that
you cannot override a particular value.
423
________________
EE Raceway Modeling Reference Guide - February 2003
424
________________ Appendix C: EE Databases
Appendix C EE Databases
All EE databases you create will be relational databases; that is, they are based on the relational data model in
which a relation is a two-dimensional table comprised of rows and columns. Most relational databases use
Standard Query Language (SQL).
The EE products attach to their relational databases through Intergraph Corporation’s Relational Interface
System (RIS), a generic relational database interface. RIS isolates the differences in specific vendors’
Relational Database Management Systems (RDBMS), allowing generic network access to all EE databases
generated with the following RDBMS’s: Standard Engine (SE) Informix, On-line Informix, Oracle, and Ingres.
Descriptions of the EE databases and the Intergraph software, RIS, that supports it.
C: EE Databases
Schema descriptions for the EE project database and the EE reference database.
The Electrical Engineer product line is supported by two relational databases: a project database and a reference
database.
The project database contains information applicable to a particular project. A project is an associated
collection of drawings and their database.
The reference database contains information applicable to multiple projects, such as symbol and part
information. (For those familiar with EDES, the reference database replaces the concept of shared part entity
files and active entity files.) One reference database can be accessed by multiple project databases. Thus, you
are not forced to re-enter common information for each project. The reference database is identified when you
enter a project. You can report and query from the reference database as well as the project database.
425
________________
EE Raceway Modeling Reference Guide - February 2003
426
________________ Appendix C: Database and RIS Procedures
INFORMIX users will now have to create all databases in ANSI mode. Check the
documentation delivered with the product for information on infxcreate, or see INFORMIX
documentation for other creation methods.
After you have created an empty database, you must use the RIS Schema Manager product to create a schema.
Access RIS Schema Manager through the Database Utilities option in the EE Environment. (See the appendix
entitled RIS Schema Manager for detailed information on using the RIS Schema Manager product.) This
process will create the risschema definition file. You can usually locate this file in the RIS product directory,
but it can exist anywhere as long as the parameters file (win32app\ingr\share\RISversion\parms) points to it.
The risschema file is an ASCII file that contains the names, ownerships, and locations of all RIS schemas and
databases. The risschema_mgr process updates and maintains the file. You can manage the risschema file in
C: EE Databases
any of the following ways:
— You can create and maintain your own risschema file, using the risschema_mgr process. The process
resides locally on your machine and recognizes any RIS schema on any database, local or remote, that was
created using RIS Schema Manager.
— You can locate the risschema file from another workstation using the risschema_mgr process and access any
schemas created on that machine.
Once you have created a schema on your empty database, you need to populate that database with EE tables and
default information. To do so, use the Update Schema option under Database Utilities (see Database Utilities,
page 50). For more information about the risschema file, see the appendix entitled RIS Schema Definition File.
427
________________
EE Raceway Modeling Reference Guide - February 2003
Update an existing empty RIS schema with EE tables and default information.
— OR —
Modify an existing RIS schema’s tables to conform to the structure of a given .sql file. If Update
schema is used with a .sql file that has a different structure than the original .sql file, the process will:
— modify existing tables if the definition of that table has changed in the .sql file. The process replaces
the old table definition with the new table definition keeping column data where column names
match.
— load those tables having a unique index with data from the .unl files that are listed in the .cmd files.
Where a table lacks a unique index, the process loads it only if the table is empty.
You should run the Update schema process from the EE Environment Project Menu. To run it outside of the
EE Environment, you must first export the variable ENV_MSGS to win32app\ingr\eenuc\msg, and then key in
the command line syntax for the process.
This is the command line syntax for the Update schema process:
win32app\eenuc\bin\create_db [-v] [-q .sql file] [-c .cmd file] schema name
— an SQL (.sql) file which contains the table and column structure.
If you want to load a schema with default information, you can also include:
— a command (.cmd) file that defines which .unl files to load into which tables;
— AND —
428
________________ Appendix C: Update Schema (create_db) Process
Example:
$ create_db -q win32app\ingr\eerway\db\rwayref.sql -c
\win32app\ingr\eerway\db\rwayref.cmd sample_ref
This will populate an empty sample_ref schema, created through the risschema_mgr process on an existing
schema, with EE Raceway tables and default reference information.
You can use this process to execute ANY valid RIS-supported SQL statement upon an existing
schema. Simply place it in a file and call that filename with the -q option.
C: EE Databases
429
________________
EE Raceway Modeling Reference Guide - February 2003
You will access the reference database during the following procedures:
1. When editing/reviewing annotation for EE Raceway elements (title blocks, one-lines, RCPs, straights,
fittings, and so forth) during a design session.
3. Reporting.
Default Attributes
Some tables exist in the reference schema to support default attributes, including, for example, the drawing,
one-line, RCP, tray_spec, and tray_part tables. Each table must contain at least a subset of the column/attribute
structure as its corresponding table in the project schema. For example, if the reference schema is custom-built,
the project schema must be custom-built accordingly. But if the project schema is custom-built, the reference
schema needs to be custom-built only if you want defaults for any new column to exist in the reference schema.
Some of the columns in the reference schema tables are required and cannot be modified or
deleted.
Keys
In addition to the default attribute columns, the reference schema tables contains two additional columns:
key_column and key_description. The actual column names are defined by the values of the key_columns and
key_description in the mscatalog entry for the given table. The key_column field is a unique index used to
identify a particular row of default attributes in the reference schema. Each of the tables is delivered with one
entry called DEFAULT. If the system cannot find a key for some reason, it uses the DEFAULT key attributes.
430
________________
Appendix C: Reference Schema - General Description
C: EE Databases
431
________________
EE Raceway Modeling Reference Guide - February 2003
Codelists
Codelists are tables in the reference database which contain all available values for a particular column of a
table in the project database. For example, the codelist table ol_type in the reference database will contain all
possible values that can be loaded into the column ol_type in the straight, fitting, and one_line tables in the
project database.
During loads of the project database, the reference database codelists are matched to the annotated values. Only
values in the reference database codelist tables are loaded into the project database. The system issues you a
warning if an annotated value does not match a value in the codelist.
index_column index_value
1 1 - blank
2 2 - approved
3 3 - approved
4 4 - approved
5 5 - approved
6 6 - approved
7 7 - approved
8 8 - approved
9 9 - approved
10 10 - approved
11 11 - not approved
432
________________ Appendix C: Codelists
ee_car_num ee_cardinal
0 TOP LEFT
1 CENTER LEFT
2 BOTTOM LEFT
6 TOP CENTER
7 CENTER CENTER
8 BOTTOM CENTER
12 TOP RIGHT
13 CENTER RIGHT
C: EE Databases
14 BOTTOM RIGHT
code
RACEWAY
433
________________
EE Raceway Modeling Reference Guide - February 2003
434
________________ Appendix C: Codelists
C: EE Databases
The ee_system table must be loaded in the reference database before you can create any raceway design
files. You can add, remove, or update any of the systems delivered with EE Raceway. The system
table contains the system_num column, which is an integer value the software uses to uniquely identify
a system name.
435
________________
EE Raceway Modeling Reference Guide - February 2003
system_num system_name
1 Control
2 Communication
3 High Voltage
4 Low Voltage
5 Alarm
6 Instrumentation
7 Signal
8 Digital
9 Analog
10 Thermocouple
11 RTD
12 Medium Voltage
13 Normal Lighting
14 Emergency Lighting
15 Security
16 Fire Safety
17 DC Power
18 Control and Signal
index_column index_value
1 STRAIGHT
2 ELBOW
3 WYE
4 CROSS
11 PULLBOX
12 CONDUIT BODY
14 DROPOUT
436
________________ Appendix C: Codelists
index_column index_value
1 <blank>
2 VERTICAL
3 INSIDE VERTICAL
4 OUTSIDE VERTICAL
5 HORIZONTAL
6 LEFT HORIZONTAL
C: EE Databases
7 RIGHT HORIZONTAL
8 REDUCER
9 LEFT REDUCER
10 RIGHT REDUCER
437
________________
EE Raceway Modeling Reference Guide - February 2003
index_column index_value
1 <blank>
2 RIGID
3 BENDABLE
4 FLEXIBLE
5 ADJUSTABLE
index_column index_value
1 English
2 Metric
438
________________ Appendix C: Codelists
C: EE Databases
not null
index_value char(20) wire/cable code description
index_column index_value
AC AC
AD AD
AG AG
AH AH
AM AM
AN AN
AP AP
AR AR
AS AS
CP CP
CQ CQ
CV CV
CW CW
CX CX
439
________________
EE Raceway Modeling Reference Guide - February 2003
index_column index_value
\C single conductor
PR "pair 2 conductors
TR "triad" 3 conductors
index_column index_value
36 AWG 36 AWG
34 AWG 34 AWG
32 AWG 32 AWG
30 AWG 30 AWG
28 AWG 28 AWG
27 AWG 27 AWG
440
________________ Appendix C: Codelists
26 AWG 26 AWG
24 AWG 24 AWG
22 AWG 22 AWG
20 AWG 20 AWG
18 AWG 18 AWG
16 AWG 16 AWG
14 AWG 14 AWG
12 AWG 12 AWG
10 AWG 10 AWG
8 AWG 8 AWG
6 AWG 6 AWG
4 AWG 4 AWG
3 AWG 3 AWG
2 AWG 2 AWG
1 AWG 1 AWG
1/0 AWG 1/0 AWG
2/0 AWG 2/0 AWG
3/0 AWG 3/0 AWG
4/0 AWG 4/0 AWG
250 MCM 250 MCM
300 MCM 300 MCM
350 MCM 350 MCM
400 MCM 400 MCM
C: EE Databases
500 MCM 500 MCM
600 MCM 600 MCM
700 MCM 700 MCM
750 MCM 750 MCM
800 MCM 800 MCM
900 MCM 900 MCM
1000 MCM 1000 MCM
1250 MCM 1250 MCM
1500 MCM 1500 MCM
1750 MCM 1750 MCM
2000 MCM 2000 MCM
441
________________
EE Raceway Modeling Reference Guide - February 2003
index_column index_value
BLK BLACK
W WHITE
R RED
GR GREEN
ORN ORANGE
BL BLUE
W/BLK WHITE/BLACK
R/BLK RED/BLACK
GR/BLK GREEN/BLACK
ORN/BLK ORANGE/BLACK
BL/BLK BLUE/BLACK
BLK/W BLACK/WHITE
R/W RED/WHITE
GR/W GREEN/WHITE
BL/W BLUE/WHITE
BLK/R BLACK/RED
W/R WHITE/RED
ORN/R ORANGE/RED
BL/R BLUE/RED
R/GR RED/GREEN
ORN/GR ORANGE/GREEN
BLK/W/R BLACK/WHITE/RED
W/BLK/R WHITE/BLACK/RED
R/BLK/W RED/BLACK/WHITE
GR/BLK/W GREEN/BLACK/WHITE
ORN/BLK/W ORANGE/BLACK/WHITE
BL/BLK/W BLUE/BLACK/WHITE
BLK/R/GR BLACK/RED/GREEN
W/R/GR WHITE/RED/GREEN
R/BLK/GR RED/BLACK/GREEN
GR/BLK/ORN GREEN/BLACK/ORANGE
ORN/BLK/GR ORANGE/BLACK/GREEN
BL/W/ORN BLUE/WHITE/ORANGE
BLK/W/ORN BLACK/WHITE/ORANGE
W/R/ORN WHITE/RED/ORANGE
ORN/W/BL ORANGE/WHITE/BLUE
W/R/BL WHITE/RED/BLUE
BLK/W/GR BLACK/WHITE/GREEN
W/BLK/GR WHITE/BLACK/GREEN
R/W/GR RED/WHITE/GREEN
GR/W/BL GREEN/WHITE/BLUE
ORN/R/GR ORANGE/RED/GREEN
442
________________ Appendix C: Codelists
BL/R/GR BLUE/RED/GREEN
BLK/W/BL BLACK/WHITE/BLUE
W/BLK/BL WHITE/BLACK/BLUE
R/W/BL RED/WHITE/BLUE
GR/ORN/R GREEN/ORANGE/RED
GR/R/BL GREEN/RED/BLUE
BL/R/ORN BLUE/RED/ORANGE
BLK/ORN/R BLACK/ORANGE/RED
BRN BROWN
Y YELLOW
C: EE Databases
COLUMN_NAME TYPE DESCRIPTION
index_column index_value
443
________________
EE Raceway Modeling Reference Guide - February 2003
index_column index_value
444
________________ Appendix C: Codelists
C: EE Databases
The Yes-No values delivered with EE Raceway are:
index_column index_value
0 NO
1 Yes
445
________________
EE Raceway Modeling Reference Guide - February 2003
3 0 0 0 2 180 - 246 CC
3 0 0 0 2 90 - 246 CLB
3 0 0 0 3 90,180 - 246 CT
3 0 0 0 3 90 90 246 CGUAM
3 0 0 0 4 90,180,270 - 246 CX
3 0 0 0 4 90,180 90 246 CGUAW
3 0 0 0 5 90,180,270 90 246 CEABY
446
________________ Appendix C: Fitting Environment Rules
Non-Planar Angle = 90
C: EE Databases
447
________________
EE Raceway Modeling Reference Guide - February 2003
448
________________ Appendix C: Updating Schemas
Updating Schemas
Before you can update (that is, load with EE tables and default data) a schema, you must create the schemas
using one of the currently-supported RDBMS’s (INFORMIX, ORACLE, INGRES). Additionally, you must
use the schema creation form in RIS Schema Manager to create a valid RIS schema on the database.
Schema name
This field accepts the name of the RIS schema to be updated. No paths are required, since this is a schema
name, not a database name. Given the schema name, RIS will know where the appropriate database is located.
Schema password
This field accepts the name of the password for the specified schema, if one exists.
C: EE Databases
Sql and Cmd Files
Accept the names of the sql and cmd (command) files associated with each application. The sql file contains
the commands used to create tables, views, and to grant permissions within the schema, while the command file
loads the schema tables with default data. These fields require a full path to the files.
The application checkboxes to the left of these fields allow you to specify which EE product(s) are supplying
the sql and cmd files to the process. If you select multiple applications, then Update project schema runs each
application sequentially against the database.
Schema name
This field accepts the name of the RIS schema to be updated. No paths are required, since this is a schema
name, not a database name. Given the schema name, RIS will know where the appropriate database is located.
Schema password
This field accepts the name of the password for the specified schema, if one exists.
449
________________
EE Raceway Modeling Reference Guide - February 2003
Accept the names of the sql and cmd (command) files associated with each application. The sql file contains
the commands used to create tables, views, and to grant permissions within the schema, while the command file
loads the schema tables with default data. These fields require a full path to the files.
The application checkboxes to the left of these fields allow you to specify which EE product(s) are supplying
the sql and cmd files to the process. If you select multiple applications, then Update reference schema runs
each application sequentially against the database.
Schema Names
When creating your RIS schemas, you should use the same name as your project, since this will be the default
name when you enter the project. However, you can override the default by exporting the $EE_SCHEMA
variable in your $HOME/.EErc file to be your project schema name.
450
________________ Appendix C: Modifying the Reference Schema
An existing database schema can also be modified. The SQL statements in the .sql file are the input to the
Update schema process. The table definitions that exist in this file determine how the tables will look when
complete. Therefore, columns can be added or removed from an existing schema according to the "create
table" statements in the .sql file. For example, columns are added into the .sql file for the one_line table, these
columns will be added into the existing rows of the existing one_line table. When this process finds a "create
table" statement for a table that exists in the schema, the following actions take place:
4. Loads new table with saved row information for column names that were in previous definition.
C: EE Databases
If rows exist in the updated table, any new columns that are added will be blank in each row. The new
table will have only those columns specified in the "create table" statement in the table definition.
Therefore, you need only to modify the ".sql" file in order to modify a schema.
The following is a list of schema modification rules for Update Schema to keep in mind.
1. You lose any columns and column information that you have not specified in the "create table" statement.
If you had used the RDBMS to alter the table by adding a column and then run Update schema without
making the appropriate change to the ".sql" file, you would lose any data that may have been on that
column.
2. Columns that you added into an existing loaded table would have no data stored in them.
3. Renaming of a column is processed by removing the column and adding another. The removed column in
such a case will lose its data and the added column will be blank.
4. You can modify the size of a column, for example, from "char(10)" to "char(200)" or "smallint" to
"integer", but changing from "char" to "integer" is dangerous and an illegal conversion can occur. If you
modify a character column to make it smaller (resizing char(20) to be char(10), for example), then any
row containing data which exceeds the new character limit will be lost.
5. The .unl file will always be loaded into a table which has a unique index. Any duplicate rows will be
counted and ignored; the unique index prevents the entry of duplicate information when updating any EE
application. If a table does not have a unique index, then the .unl file will be loaded only if the table is
empty.
Table names can be changed except for table names that begin with the letters "ms" and "ee_". They must also
be changed appropriately in the MSCATALOG table in order for the software to run properly. Keep in mind
that the columns within the tables in the reference schema must be a subset of the columns of the corresponding
tables in the project schema.
451
________________
EE Raceway Modeling Reference Guide - February 2003
The databases are initially loaded with the *.unl files as defined in the command file. The Update schema
process initiates the command file which automatically finds and loads the information in the .unl files into the
database. These files can be edited by the system manager to include additional defaults, part data, and codelist
values. Use caution when editing these files since they are in a format for loading sequentially into a table.
Certain columns are defined in the .sql file as being non-null which means the data entered from the .unl file
must not be null for that column.
There are two ways to modify existing rows in the reference schema.
— OR —
1. the RDBMS’s interactive query product, such as INFORMIX’s ISQL or FORMS, or ORACLE’s
sqlplus, or INGRES’s SQL.
3. DB Access’s Database Edit Utility (see the section in the appendix entitled EE Manager for more
information on this utility)
The following steps can be used as a guideline for modifying the reference schema before it is updated:
1. To see which .unl files are being loaded into the reference database, look at the command (.cmd) file you
will be using. The following is a typical example of what can be contained in this file:
These lines tell the update schema process that the file "olt.unl" is to be inserted into the ol_type table. In
this case the "olt.unl" file will exist in the current directory but a full path name can be specified on this
file (e.g. FILE win32app\ingr\eerway\db\olt.unl). The delimiter is one character long. It tells the process
that the "|" character separates each column of data in the olt.unl file.
Do not remove any lines from this file that would effect the current .unl files from being
loaded. All existing .unl files must be loaded for proper product execution.
2. Edit the desired .unl file making sure the delimiter "|" is used between each field. Each line represents a
row to be inserted into the database and each field represents the corresponding column in the database.
The following is an example of what a line in the "olt.unl" file might look like:
1|TRAY|240|241|204|0|0|1|
452
________________ Appendix C: Modifying the Reference Schema
In this example, "1" is the index_column value, "TRAY" is the index_value column value, "240" is the
ee_spec_table column, etc. If in the "olt.unl" file you would like to add additional entries, you can edit
this file. Make sure you line up the delimited fields with the tables’ columns.
The following example demonstrates how to load a new .unl file containing your own specification information
into the reference database.
1. cd win32app\ingr\eerway\db
2. Edit the command file rwayref.cmd. Insert the following lines into this file:
3. Create a new file in the current directory, naming it catalog.unl. Edit this file to include any tray
specification information you want to load into the reference database, separating each column of data
with a pipe symbol (|). For example:
C: EE Databases
4. When you have finished editing the .unl file, run the Update reference schema process to load the
specification information into the tray_spec table.
453
________________
EE Raceway Modeling Reference Guide - February 2003
An asterisk (*) indicates that you must not modify the column name. You should not modify
those column names having a prefix of "ee_".
approv_status
This codelist table defines the available approval status values: blank, approved, not approved, and so
forth. See the section entitled Codelists earlier in this appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify an approved status
description.
index_value: the column that contains the name of each available approved status.
away_part
This table stores the part specification information for the one-line type AIRWAY.
ee_tl_qual: the codelisted column used to define additional information about the three-line type.
454
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_angle: the column used to define the airway fitting bend angle.
ee_symbol: the column used to define the airway part EDEN symbol name to the EE software.
ee_spec_key: the key to the appropriate airway specification table row containing general specification
information.
ee_spec2_key: if the current airway part is a reducer, this column is the key to the row in the other
airway specification.
ee_part_key: the unique key to the appropriate reference database record for the default values.
away_spec
This table stores the general specification information for the one-line type AIRWAY. EE Raceway
uses airways to reserve space for the routing of cable or other raceway material, and also to maintain
connectivity to a raceway system.
C: EE Databases
ee_units* integer no no
ee_out_ht_diam* real dups no
ee_out_width* real no yes
ee_extension* real no yes
ee_transition* real no yes
ee_radius* real no yes
ee_xs_cell* Char( 6) no yes
ee_spec_key* Char( 28) uniq no
ee_description Char( 40) no yes
ee_out_ht_diam: the column used to define the airway outside diameter or height to the EE raceway
software.
ee_out_width: the column used to define the airway outside width to the EE raceway software.
ee_extension: the column used to define the airway fitting extension length to the EE raceway
software.
ee_transition: the column used to define the airway fitting transition length to the EE raceway
software.
ee_radius: the column used to define the airway fitting bend radius to the EE raceway software.
455
________________
EE Raceway Modeling Reference Guide - February 2003
ee_xs_cell: the column used to define the airway cross section graphic that is used during sketch
propagation. The only valid entries are: A, B, or C. The associated shapes are shown below.
ee_spec_key: the unique key to the appropriate reference database record for the default values.
cardinal
This codelist table defines the available cardinal point locations (top left, center left, bottom left, and so
forth). Refer to the section entitled Codelists earlier in this appendix for a detailed description of this
table.
ee_car_num: an integer value used by the software to uniquely identify a cardinal point description.
ee_cardinal: the column that contains the name of each available cardinal point.
456
________________
Appendix C: EE Raceway Reference Database Schema Description
cond_body
This table stores the specification information for the manual fitting CONDUIT BODY.
C: EE Databases
volume real no yes
style Char( 20) no yes
ee_pull_point integer no yes
vendor: the codelisted column used to define the vendor of the conduit body special fitting.
ee_part: the column used to define the conduit body part number.
ee_symbol: the column used to define the conduit body part EDEN symbol name to the EE software.
ee_dimension_1: the column used to define a conduit body dimension value to eden and the raceway
reports.
ee_dimension_2: the column used to define a conduit body dimension value to eden and the raceway
reports.
ee_dimension_3: the column used to define a conduit body dimension value to eden and the raceway
reports.
457
________________
EE Raceway Modeling Reference Guide - February 2003
ee_dimension_4: the column used to define a conduit body dimension value to eden and the raceway
reports.
ee_dimension_5: the column used to define a conduit body dimension value to eden and the raceway
reports.
ee_dimension_6: the column used to define a conduit body dimension value to eden and the raceway
reports.
ee_part_key: the unique key to the appropriate reference database record for the default values.
ee_pull_point: the codelisted column used to define the conduit body as a cable pull point.
cond_fill_calc
This table is used to specify the maximum allowable percent fill of a conduit based on the armor type
of the cable outer jackets and number of cables within the conduit. This calculation assumes a
homogeneous mixture of either all LEAD or all NON-LEAD armor types for the cable outer jackets for
the cables routed within the same conduit. If the cables contained in a conduit exceed the maximum
allowable conduit fill, then the conduit is marked as being overfilled.
ee_rule_set: identification of the rule set that applies to the raceway system fill calculations, for
example NEC 1990.
458
________________
Appendix C: EE Raceway Reference Database Schema Description
cond_part
This table stores the part specification information for the one-line type CONDUIT.
ee_tl_qual: the codelisted column used to define additional information about the three-line type.
C: EE Databases
ee_angle: the column used to define the conduit fitting bend angle.
ee_symbol: the column used to define the conduit part EDEN symbol name to the EE software.
ee_spec_key: the key to the appropriate conduit specification table row containing general
specification information.
ee_spec2_key: if the current conduit part is a reducer, this column is the key to the row in the other
conduit specification.
ee_part_key: the unique key to the appropriate reference database record for the default values.
459
________________
EE Raceway Modeling Reference Guide - February 2003
cond_spec
This table stores the general specification information for the one-line type CONDUIT.
vendor: the codelisted column used to define the vendor of the conduit specification.
ee_dimension_1: the column used to define a conduit dimension value to eden and the raceway
reports.
ee_out_ht_diam: the column used to define the conduit outside diameter to the EE raceway software.
ee_extension: the column used to define the conduit fitting extension length to the EE raceway
software.
ee_transition: the column used to define the conduit fitting transition length to the EE raceway
software.
ee_radius: the column used to define the conduit fitting bend radius to the EE raceway software.
weight: the column used to define the conduit weight per unit length.
460
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_xs_cell: the column used to define the conduit cross section graphic that is used during sketch
propagation. The only valid entries are: A, B, or C. The associated shapes are shown below.
ee_spec_key: the unique key to the appropriate reference database record for the default values.
drawing
This table defines both the columns that you can annotate for title blocks and their default column
values.
C: EE Databases
ee_key* Char( 28) uniq no
ee_description* Char( 40) no yes
ee_key: the unique key to the appropriate reference database record for the default values.
drawing_type
This codelist table defines what drawing types are available for use. Refer to the section entitled
Codelists earlier in the appendix for a detailed description of this table.
ee_code: the column used by the software to uniquely identify a drawing type description.
code_desc: the column that contains the description of each available drawing type.
461
________________
EE Raceway Modeling Reference Guide - February 2003
drop_point
This table defines both the columns you can annotate for drop point symbols and their default column
values.
ee_dist_down_ol: the column used to define the distance along the one-line to the drop point.
ee_dist_to_rcp: the column used to define the distance between the one-line and the rcp.
ee_key: the unique key to the appropriate reference database record for the default values.
duct_spec
This table stores the general specification information for the one-line type DUCTBANK.
ee_out_ht_diam: the column used to define the ductbank outside height to the EE Raceway software.
ee_out_width: the column used to define the ductbank outside width to the EE Raceway software.
462
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_xs_cell: the column used to define the ductbank cross section graphic that is used during sketch
propagation. The only valid entries are: A, B, or C. The associated shapes are shown below.
ee_spec_key: the unique key to the appropriate reference database record for the default values.
ee_cond_x_area
This table stores the cross sectional area of conduit identified by its nominal size.
C: EE Databases
nominal_size: the column used to define a conduit nominal size that corresponds to the same column
in the cond_spec table.
ee_dimension_1: the column used to define a conduit dimension value that corresponds to the same
column in the cond_spec table.
ee_area: the column used to define the cross sectional area of the conduit of the given nominal size.
ee_graphic_only
EE applications use this table to define which columns in the project database cannot be posted back to
graphics through the Post Attribute process.
table_name: the name of the desired table containing a column that cannot be posted.
column_name: the column within table_name that cannot be posted back to the graphics.
463
________________
EE Raceway Modeling Reference Guide - February 2003
ee_pcbl_code
This codelist table defines the codes that are used in the ee_pseudo_cable table for the EERWAY
Conduit Sizing command. Refer to the section entitled Codelists earlier in this appendix for a detailed
description of this table.
index_value: the column that contains the description of each available ee_pcbl_code.
ee_pcbl_color
This codelist table defines the colors that are used in the ee_pseudo_cable table for the EE Raceway
Conduit Sizing command. Refer to the section entitled Codelists earlier in this appendix for a detailed
description of this table.
index_value: the column that contains the description of each available ee_pcbl_color color.
ee_pcbl_config
This codelist table defines the cable configurations that are used in the ee_pseudo_cable table for the
EE Raceway Conduit Sizing command. Refer to the section entitled Codelists earlier in this appendix
for a detailed description of this table.
index_value: the column that contains the description of each available ee_pcbl_config.
464
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_pcbl_insul
This codelist table defines the insulation types that are used in the ee_pseudo_cable table for the EE
Raceway Conduit Sizing command. Refer to the section entitled Codelists earlier in this appendix for
a detailed description of this table.
index_value: the column that contains the description of each available ee_pcbl_insul.
ee_pcbl_size
This codelist table defines the cable/wire sizes that are used in the ee_pseudo_cable table for the EE
Raceway Conduit Sizing command. Refer to the section entitled Codelists earlier in this appendix for
a detailed description of this table.
C: EE Databases
Column Name Type Index Null
index_column Char( 20) uniq no
index_value Char( 20) dups yes
index_value: the column that contains the description of each available ee_pcbl_size.
ee_pcbl_volt
This codelisted table defines the cable/wire voltage ratings that are used in the ee_pseudo_cable table
for the EE Raceway Conduit Sizing command.
index_value: the column that contains the description of each available ee_pcbl_volt.
465
________________
EE Raceway Modeling Reference Guide - February 2003
ee_pseudo_cable
This table defines the cable/wires that are used in the EE Raceway Conduit Sizing command.
ee_system
This codelist table defines the systems that are available to contain EE Raceway graphics. Refer to the
section entitled Codelists earlier in the appendix for a detailed description of this table.
system_num: an integer value used by the software to uniquely identify a system name.
system_name: the column that contains the name of each available system.
466
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_units
This codelist table defines the units that are used for one-line dimension values. Refer to the section
entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify an ee_unit description.
index_value: the column that contains the description of each available ee_unit.
ee_unique
EE applications use this table to define which columns make a row in a table unique for single data
entry. If a table is not represented in the ee_unique table, a row will be loaded into the appropriate
table for each graphic element.
C: EE Databases
table_name Char( 32) uniq yes
column_name Char( 32) uniq yes
ee_comp_type* Char( 10) uniq yes
blank_allowed integer no yes
table_name: the name of the table that requires single data entry. Multiple rows in the database could
contain the same table name if multiple columns are required to make an entry unique.
column_name: the name of the column in table_name that makes an entry unique.
ee_comp_type: is used by the EE processors to define what product will use the entry. In some
entries, where the information crosses products, this column is used to further describe what would
make an entry unique.
blank_allowed: is used to define whether or not the column in column_name is allowed to be blank.
If not, then a blank column value would cause the EE processes to create a new row in the database.
ee_yes_no
This codelist table defines the possible column values for a ’yes/no’ question in a table column. Refer
to the section entitled Codelists earlier in this appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify the ’yes/no’ response.
467
________________
EE Raceway Modeling Reference Guide - February 2003
envelope
This table defines both the columns you can annotate for space envelopes and their default column
values. EE Raceway uses space envelopes to reserve blocks of space for raceway without maintaining
connectivity to any raceway system.
ee_key: the unique key to the appropriate reference database record for the default values.
Space envelopes are not available with EE Raceway at the time of this printing.
468
________________
Appendix C: EE Raceway Reference Database Schema Description
light_fixture
This table stores the specification information for the manually placed equipment LIGHT_FIXTURE.
C: EE Databases
num_wires Char( 4) no yes
num_phase_wires integer no yes
power_factor real no yes
area_class Char( 6) no yes
oper_temp_deg_c integer no yes
text_1 Char( 32) no yes
text_2 Char( 32) no yes
text_3 Char( 32) no yes
text_4 Char( 32) no yes
ee_units integer no no
ee_pull_point integer no yes
ee_symbol: the column used to define the light fixture EDEN symbol name to the EE software.
ee_dimension_1: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_2: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_3: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_part_key: the unique key to appropriate reference database record for the default values.
469
________________
EE Raceway Modeling Reference Guide - February 2003
fl_amps: the column used to define a light fixture’s full load amps.
ee_dimension_4: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_5: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_6: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_7: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_8: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
ee_dimension_9: the column used to define a light fixture dimension value to EDEN and the raceway
reports.
item_code_num: the column used to define a light fixture’s item code number.
vendor: the codelisted column used to define the vendor of the equipment light fixture.
num_wires: the column used to define the number of wires in a light fixture.
num_phase_wires: the column used to define the number of phase wires in a light fixture.
text_1: the column used to describe characteristics about the light fixture.
text_2: the column used to describe characteristics about the light fixture.
text_3: the column used to describe characteristics about the light fixture.
text_4: the column used to describe characteristics about the light fixture.
ee_pull_point: the codelisted column used to define a light fixture as a cable pull point.
470
________________
Appendix C: EE Raceway Reference Database Schema Description
manual_part
This codelist table defines the available manually-placed special fittings (conduit body, pullbox).
Refer to the section entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify a manual_part description.
index_value: the column that contains the description of each available manual_part.
ee_part_table: an mscatalog number of the table containing special fitting part specification
information.
ee_rcp_ol_type: the index_column number from the one-line type codelist table for the EE raceway
connect point of the special fitting.
C: EE Databases
ee_manpart_type: the column used to tell the load processor to load the manual part into either the
project database "fitting" table or the "panel" table.
mscatalog
Microstation 32 requires that every database used in graphics contain a table called mscatalog. This
table holds the entity numbers for all other tables in the database. In general, there will be one row in
mscatalog for each database table that is linked to graphic elements. Any table not directly linked to
graphics/EE elements does not need to appear in mscatalog. Both DBAccess and RISRPT (RIS Report
Writer) use this table.
tablename: the name of the table in the database. It must exactly match the name of the desired table.
471
________________
EE Raceway Modeling Reference Guide - February 2003
entitynum: the entity number assigned to a table. It must be a positive integer in the range of 1 to
65535. The entity number uniquely identifies a particular table in the database. The MicroStation 32
database interface places the entity number of a table in the linkage it creates between a graphics
element and a table row. EE places the entity number in the EE header linkage of annotation in order
to identify which table the text is linked to.
reporttable: a temporary table used by MicroStation 32. Is is created for each table having graphic
linkages within a fence.
sqlreview: an sql select statement that MicroStation 32 uses to review rows and columns.
fencefilter: an sql select statement that MicroStation 32 uses to restrict elements during fence
operations.
dastable: specifies the name of the table that maps displayable attribute types to the sql select
statements used by MicroStation 32 for loading text into displayable attributes.
key_columns: a column containing the column_name which uniquely identifies a particular row in the
table. EE uses key_columns as the correlation key.
mscodelist
This table provides limited support for DMRS-like codelists. A codelist is a data structure that
represents a character string which is then represented in the database by integer or character codes.
The codelist approach minimizes storage requirements and simplifies database administration.
MicroStation 32, RISRPT, and DBAccess all support this table. EE uses this table to restrict input for
a particular column to a pre-defined set of values.
table_name: the name of the desired table containing a column with codelist values.
472
________________
Appendix C: EE Raceway Reference Database Schema Description
text_column: the column that contains the actual values represented by the corresponding code value
in code_column.
index_column: a column name that, if not NULL, will impose additional conditions to allow multiple
codelists to be represented in the same database table.
index_value: the column that provides the index to a specific list within a multiple codelist table.
mscolumns
This table specifies column-specific data for EE tables. In general, there is one row in mscolumns for
each column in an attribute table (for those attributes that exist in annotation). EE uses the mscolumns
information to control display of column information during annotation. A column that does not exist
as annotation linked to a graphics/EE element does not need to appear in mscolumns. The order in
which attributes appear on the annotation form is determined by the value in the column
ee_column_order.
C: EE Databases
Column Name Type Index Null
entitynum integer uniq no
attrnum integer uniq no
column_name Char( 32) no no
alias_name Char( 32) no yes
access_flag smallint no no
work_mode smallint no no
ee_column_order smallint no no
entitynum: the entity number assigned to the table whose columns are being described. Entity
numbers between mscatalog and mscolumns must be consistent.
column_name: the name of a column in the database. It must exactly match the column name in the
database.
access_flag: the column containing a code used to identify the accessibility of a particular column by
an EE user. A value of 0 indicates that the column is read_only, while a value of 1 indicates that it
allows read/write access.
work_mode: the column containing the code that identifies the use of a particular column by the EE
software. This column can be thought of as a filter which restricts the display of certain attributes
depending on the mode of work the user is performing. Since all EE Raceway column values are
displayed on the primary form, the work_mode value is set to zero.
473
________________
EE Raceway Modeling Reference Guide - February 2003
ee_column_order: the column used to determine the order in which to display attributes on the
annotation form.
ol_type
This codelist table defines the available one-line types (tray, wireway, conduit, and so forth). Refer to
the section entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify an ol_type description.
index_value: the column that contains the description of each available ol_type.
ee_part_table: an mscatalog number of the table containing the part specification information.
ee_rcp_part_table: an mscatalog number of the table containing special fitting part specification
information.
ee_max_run_angle: an integer containing the maximum allowed value of the sum of all bend angles
in a run. A value of zero states that the sum of all bend angles in a run is unlimited.
ee_priority_level: an integer value used to define the routing priority level of the one-line type. This
value is used to determine whether one one-line type can break or attach to another one-line type.
474
________________
Appendix C: EE Raceway Reference Database Schema Description
one_line
This table defines both the columns you can annotate for raceway one-lines and their default column
values.
add_weight: the column used to define an additional weight per unit length.
ee_ol_length: the column used to define the weight per unit length.
ee_spec_key: the key to the appropriate reference database record for the general specification
information on the three-line elements.
C: EE Databases
ee_key: the unique key to the appropriate reference database record for the default values.
panel
This table defines both the columns you can annotate for panels/equipment and their default column
values.
475
________________
EE Raceway Modeling Reference Guide - February 2003
ee_approv_date: the column used to define the date the approval status was changed.
ee_create_date: the column used to define the date the panel/equipment was created.
ee_last_rev_dat: the column used to define the date the panel/equipment was last revised.
ee_key: the unique key to the appropriate reference database record for the default values.
project
This table stores information for the project.
476
________________
Appendix C: EE Raceway Reference Database Schema Description
pullbox
This table stores the specification information for the manual fitting PULLBOX.
C: EE Databases
ee_out_ht_diam: the column used to define the pullbox outside height to the EERWAY software.
ee_out_width: the column used to define the pullbox outside width to the EERWAY software .
ee_dimension_1: the column used to define the pullbox dimension value to Eden and the raceway
reports.
ee_symbol: the column used to define the pullbox part Eden symbol name to the EE software.
ee_part_key: the unique key to the appropriate reference database record for the default values.
ee_pull_point: the codelisted column used to define a pullbox as a cable pull point.
477
________________
EE Raceway Modeling Reference Guide - February 2003
rcp
This table defines both the columns you can annotate for raceway connect points (RCPs) and their
default column values.
tag: the column used to define the raceway connect point tag.
ee_rcp_type: the codelisted column used to define the raceway connect point type.
ee_extension: the column used to define the raceway connect point fitting extension length.
ee_transition: the column used to define the raceway connect point fitting transition length.
ee_radius: the column used to define the raceway connect point fitting bend radius.
ee_part_key: the key to the appropriate reference database record for the values on the manually
placed fitting.
ee_key: the unique key to the appropriate reference database record for the default values.
rcp_type
This codelist table defines additional information about EE Raceway connect points (RCPs). Refer to
the section entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify a rcp_type description.
index_value: the column that contains the description of each available rcp_type.
478
________________
Appendix C: EE Raceway Reference Database Schema Description
tl_fit_env
This table is used by the manual fitting command to determine which fitting to place at an RCP based
on the intersecting one-lines and the fitting environment rules listed in this table.
ee_ol_type: the index_column number from the one-line type codelist table of the intersecting one-
lines.
ee_tl_type: the index_column number from the three_line type codelist table of the fitting to be placed
at the RCP. Zero if no check is to be performed.
C: EE Databases
ee_tl_subtype: the index_column number from the three_line subtype codelist table of the fitting to be
placed at the RCP. Zero if no check is to be performed.
ee_tl_qual: the index_column number from the three_line qualifier codelist table of the fitting to be
placed at the RCP. Zero if no check is to be performed.
ee_pln_angles: the column that contains the planar angles between the intersecting one-lines. Angles
must be defined relative from a single one-line.
ee_prp_angles: the column that contains the non-planar angles between the intersecting one-lines.
Angles must be defined relative from a single one-line.
ee_part_table: an mscatalog number of the table containing the fitting to be placed at the RCP.
ee_symbol: the column used to define the fitting EDEN symbol name to the EE software.
479
________________
EE Raceway Modeling Reference Guide - February 2003
tl_qual
This codelist table defines additional information about the available three-line types (rigid, bendable,
flexible, and so forth). Refer to the section entitled Codelists earlier in the appendix for a detailed
description of this table.
index_column: an integer value used by the software to uniquely identify a tl_qual description.
index_value: the column that contains the description of each available tl_qual.
tl_subtype
This codelist table defines the available three-line subtypes (vertical, horizontal, reducer, and so forth).
Refer to the section entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify a tl_subtype description.
index_value: the column that contains the description of each available tl_subtype.
tl_type
This codelist table defines the available three-line types (straight, elbow, wye, cross, and so forth).
Refer to the section entitled Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify a tl_type description.
index_value: the column that contains the description of each available tl_type.
480
________________
Appendix C: EE Raceway Reference Database Schema Description
to_equip
This table defines both the columns that you can annotate for equipment pointer symbols and their
default column values.
ee_eqp_table: the name of the reference database table containing the equipment specification
information.
ee_part_key: the key to the appropriate reference database record for the values on the equipment.
ee_eqp_key: the unique key to the appropriate reference database record for the default values.
to_support
C: EE Databases
This table defines both the columns you can annotate for support equipment symbols and their default
column values.
ee_key: the unique key to the appropriate reference database record for the default values.
to_support symbols are not available with EE Raceway at the time of this printing.
481
________________
EE Raceway Modeling Reference Guide - February 2003
tray_part
This table stores the part specification information for the one-line type TRAY.
ee_tl_qual: the codelisted column used to define additional information about the three-line type.
ee_angle: the column used to define the tray fitting bend angle.
ee_symbol: the column used to define the tray part EDEN symbol name to the EE software.
ee_spec_key: the key to the appropriate tray specification table row containing general specification
information.
ee_spec2_key: if the current tray part is a reducer, this column is the key to the row in the other tray
specification.
ee_part_key: the unique key to the appropriate reference database record for the default values.
482
________________
Appendix C: EE Raceway Reference Database Schema Description
tray_spec
This table stores the general specification information for the one-line type TRAY.
vendor: the codelisted column used to define the vendor of the tray specification.
C: EE Databases
ee_units: the codelisted column used to define the units of measurement.
ee_dimension_1: the column used to define a tray dimension value to eden and the raceway reports.
ee_out_ht_diam: the column used to define the tray outside height to the EE raceway software.
ee_dimension_2: the column used to define a tray dimension value to eden and the raceway reports.
ee_out_width: the column used to define the tray outside width to the EE raceway software.
ee_extension: the column used to define the tray fitting extension length to the EE raceway software.
ee_transition: the column used to define the tray fitting transition length to the EE raceway software.
ee_radius: the column used to define the tray fitting bend radius to the EE raceway software.
weight: the column used to define the tray weight per unit length.
483
________________
EE Raceway Modeling Reference Guide - February 2003
ee_xs_cell: the column used to define the tray cross section graphic that is used during sketch
propagation. The only valid entries are: A, B, or C. The associated shapes are shown below.
ee_spec_key: the unique key to the appropriate reference database record for the default values.
vendor
This codelist table defines the vendors that are available for specifications. Refer to the section entitled
Codelists earlier in the appendix for a detailed description of this table.
index_column: an integer value used by the software to uniquely identify a vendor name.
index_value: the column that contains the name of each available vendor.
wway_part
This table stores the part specification information for the one-line type WIREWAY.
484
________________
Appendix C: EE Raceway Reference Database Schema Description
ee_tl_qual: the codelisted column used to define additional information about the three-line type.
ee_angle: the column used to define the wireway fitting bend angle.
ee_symbol: the column used to define the wireway part EDEN symbol name to the EE software.
ee_spec_key: the key to the appropriate wireway specification table row containing general
specification information.
ee_spec2_key: if the current wireway part is a reducer, this column is the key to the row in the other
wireway specification.
ee_part_key: the unique key to the appropriate reference database record for the default values.
C: EE Databases
wway_spec
This table stores the general specification information for the one-line type WIREWAY.
vendor: the codelisted column used to define the vendor of the wireway specification.
ee_dimension_1: the column used to define a wireway dimension value to eden and the raceway
reports.
485
________________
EE Raceway Modeling Reference Guide - February 2003
ee_out_ht_diam: the column used to define the wireway outside height to the EE raceway software.
ee_dimension_2: the column used to define a wireway dimension value to eden and the raceway
reports.
ee_out_width: the column used to define the wireway outside width to the EE raceway software.
ee_extension: the column used to define the wireway fitting extension length to the EE raceway
software.
ee_transition: the column used to define the wireway fitting transition length to the EE raceway
software.
ee_radius: the column used to define the wireway fitting bend radius to the EE raceway software.
weight: the column used to define the wireway weight per unit length.
ee_xs_cell: the column used to define the wireway cross section graphic that is used during sketch
propagation. The only valid entries are: A, B, or C. The associated shapes are shown below.
ee_spec_key: the unique key to the appropriate reference database record for the default values.
486
________________
Appendix C: EE Raceway Project Database Schema Description
An asterisk (*) indicates that you must not modify the column name. You should not modify
those column names having a prefix of "ee_".
cabsch_spec
This table contains information about the cable schedule for underground cable design.
C: EE Databases
cable_type_code Char( 6) no yes
service_voltage Char( 7) no yes
undgrnd_length real no yes
abvgrnd_length real no yes
from_equi_numb Char( 15) no yes
from_detail Char( 8) no yes
not_used Char( 6) no yes
plan_assem_dwg Char( 20) no yes
to_equi_numb Char( 15) no yes
to_detail Char( 8) no yes
to_plan_drw_num Char( 20) no yes
cont_sta_type Char( 4) no yes
quan_term_kits Char( 6) no yes
ol_diagram_numb Char( 20) no yes
not_used2 Char( 8) no yes
remarks Char( 38) no yes
drawing_numb Char( 20) uniq yes
drawing_rev Char( 2) no yes
cable_numb: the column containing the area number, cable number, and cable number ID.
487
________________
EE Raceway Modeling Reference Guide - February 2003
plan_assem_dwg: the column containing plan drawings or standard assembly drawing number.
drawing_numb can have duplicate values but the combination of drawing_numb and
cable_numb should be unique.
488
________________
Appendix C: EE Raceway Project Database Schema Description
cndsch_spec
This table contains information about conduit schedule for underground conduit design.
C: EE Databases
pow_conduct_size Char( 7) no yes
pow_conduct_type Char( 4) no yes
pow_conduct_length real no yes
con_conduct_numb integer no yes
con_conduct_size Char( 7) no yes
con_conduct_type Char( 4) no yes
con_conduct_length real no yes
grnd_wire_size Char( 6) no yes
grnd_wire_type Char( 4) no yes
grnd_wire_length real no yes
ol_diagram_numb Char( 10) no yes
remarks Char( 16) no yes
drawing_numb Char( 20) uniq yes
drawing_rev Char( 2) no yes
conduit_numb: the column containing the area number, conduit number, and conduit number ID.
drawing_numb can have duplicate values, but the combination of drawing_numb and
conduit_numb should be unique.
conduit_for: the column defines the purpose of the conduit, for example power, control, and so forth.
cnd_from_where: the column containing the location name where the conduit starts from.
cnd_to_where: the column containing the location name where the conduit goes to.
489
________________
EE Raceway Modeling Reference Guide - February 2003
abvgrnd_cnd_len: the column containing the length of the above ground conduit.
490
________________
Appendix C: EE Raceway Project Database Schema Description
drawing
This table, used by all EE products, contains general information about each EE design file.
mslink: a unique integer value used by the software to identify a row in the drawing table.
ee_filename: the column containing the drawing file name and path.
C: EE Databases
sheet: the column used to contain the drawing sheet name.
load_date: the column containing the date that the load processor loaded the drawing into the project
database.
ref_db: the column containing the schema name of the EE reference database.
drop_point
This table associates a row in the rcp table with a row in the one-line table.
mslink: a unique integer value used by the software to identify a row in the drop_point table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_ol: the column containing the mslink of a row in the one_line table.
491
________________
EE Raceway Modeling Reference Guide - February 2003
ee_to_rcp: the column containing the mslink of a row in the rcp table.
ee_dist_down_ol: the column containing the distance along the one-line to the drop point.
ee_dist_to_rcp: the column containing the distance between the one-line and the rcp.
tag: the column that contains the name of the drop point.
duct_fill
This table defines the cable/conduit that are placed in a duct one-line.
ee_to_ol: the column containing the mslink of a row in the one-line table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_duct_cc_numb: cable/conduit area number, cable number, and cable number number ID.
ee_pseudo_cable
This table defines the wires/cables that fill conduit. This is performed with the EE Raceway Conduit
Sizing command.
mslink: a unique integer value used by the software to identify a row in the ee_pseudo_cable table.
ee_to_ol: the column containing the mslink of a row in the one-line table.
492
________________
Appendix C: EE Raceway Project Database Schema Description
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_quantity: the number of wires/cables associated with the given one-line of a given item_no.
item_no: the column containing the unique key to the ee_pseudo_cable table of the reference schema.
ee_system
This table contains the names of all systems from every EE Raceway drawing loaded into the project
database.
mslink: a unique integer value used by the software to identify a row in the ee_system table.
envelope
C: EE Databases
This table contains information about the raceway envelopes found in the drawing.
mslink: a unique integer value used by the software to identify a row in the envelope table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
493
________________
EE Raceway Modeling Reference Guide - February 2003
fitting
This table contains information about the raceway fittings found in the drawing.
mslink: a unique integer value used by the software to identify a row in the fitting table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_ol: the column containing the mslink of a row in the one-line table.
ee_to_rcp: the column containing the mslink of a row in the rcp table.
ee_out_ht_diam: the column containing the outside height or diameter of the fitting.
ee_weight: the column containing the fitting weight per unit length.
494
________________
Appendix C: EE Raceway Project Database Schema Description
cab_weight: the column containing the cable weight per unit length.
pds_east: the column containing the PDS east coordinate of the fitting (calculated by Load Database).
pds_north: the column containing the PDS north coordinate of the fitting (calculated by Load
Database).
pds_elev: the column containing the PDS elevation coordinate of the fitting (calculated by Load
Database).
vendor: the column containing the codelist value of the vendor of the one-line type specification.
ee_units: the column containing the codelist value of the design file units.
ee_tl_type: the column containing the codelist value of the three-line type.
ee_tl_subtype: the column containing the codelist value of the three-line subtype.
ee_tl_qual: the column containing the codelist value of the three-line qualifier.
ee_ol_type: the column containing the codelist value of the one-line type.
C: EE Databases
ee_description: the column containing the fitting part description.
fit_to_sys
This table links a fitting to each system of which it is a member.
ee_to_fit: the column containing the mslink of a row in the fitting table.
ee_to_sys: the column containing the mslink of a row in the ee_system table.
ee_percent: the column containing the percent amount of the fitting is contained in the system
identified by the mslink stored in ee_to_sys.
495
________________
EE Raceway Modeling Reference Guide - February 2003
mscatalog
This table contains the entity (table) numbers for all the tables in the EE Raceway project database.
There will be one row in the mscatalog for each database table.
tablename: the name of the table in the database. It must exactly match the name of the desired table.
entitynum: The entity number assigned to a table. It must be a positive integer in the range of 1 to
65535. The entity number uniquely identifies a particular table in the database.
reporttable: a temporary table used by MicroStation 32. Is is created for each table having graphic
linkages within a fence.
sqlreview: an sql select satement that MicroStation 32 uses to review rows and columns.
fencefilter: an sql select statement that MicroStation 32 uses to restrict elements during fence
operations.
dastable: specifies the name of the table that maps displayable attribute types to the sql select
statements used by MicroStation 32 for loading text into displayable attributes.
key_columns: a column containing the column_name which uniquely identifies a particular row in the
table. EE uses key_columns as the correlation key.
496
________________
Appendix C: EE Raceway Project Database Schema Description
mscolumns
This table specifies column-specific data for EE tables. There is one row in mscolumns for each
column in an attribute table. RISRPT and DBAccess use this table for reports. Currently, there are no
EE processors using this table.
entitynum: the entity number assigned to the table whose columns are being described. Entity
numbers between mscatalog and mscolumns must be consistent.
column_name: the name of a column in the database. It must exactly match the column name in the
C: EE Databases
database.
access_flag: the column containing a code used to identify the accessibility of a particular column by
an EE user. A value of 0 indicates that the column is read_only, while a value of 1 indicates that it
allows read/write access.
work_mode: the column containing the code that identifies the use of a particular column by an EE
user. This column can also be thought of as a filter. Display of certain attributes can be restricted
depending on the mode of work the user is performing. Since all EE Raceway column values are
displayed on the primary form, the work_mode value is set to zero.
ee_column_order: the column used to determine the order to display the attributes on the annotation
form.
497
________________
EE Raceway Modeling Reference Guide - February 2003
ol_to_sys
This table links a one-line to each system of which it is a member.
ee_to_ol: the column containing the mslink of a row in the one-line table.
ee_to_sys: the column containing the mslink of a row in the ee_system table.
ee_percent: the column containing the percent amount of the straight section is contained in the
system identified by the mslink stored in ee_to_sys.
one_line
This table contains information about the raceway one-lines found in the drawing.
mslink: a unique integer value used by the software to identify a row in the one_line table.
498
________________
Appendix C: EE Raceway Project Database Schema Description
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_rcp1: the column containing the mslink of the rcp placed at the start of the one-line in the design
file.
ee_to_rcp2: the column containing the mslink of the rcp placed at the end of the one-line in the design
file.
ee_out_ht_diam: the column containing the outside height or diameter of the one-line type.
ee_out_width: the column containing the outside width of the one-line type.
weight: the column containing the one-line type weight per unit length.
cab_weight: the column containing the cable weight per unit length.
vendor: the column containing the codelist value of the vendor of the one-line type specification.
C: EE Databases
ee_units: the column containing the codelist value of the design file units.
ee_ol_type: the column containing the codelist value of the one-line type.
ee_spec_key: the column containing the unique key to the one-line type specification table.
ee_radius: the column that contains the fitting bend radius of the three-line type specification.
499
________________
EE Raceway Modeling Reference Guide - February 2003
panel
This table contains information about all panels/equipment found in the drawing.
mslink: a unique integer value used by the software to identify a row in the panel table.
ee_approv_date: the column containing the date when the approval status changed.
ee_last_rev_dat: the column containing the date the panel/equipment was last revised.
ee_eqp_table: the column containing the name of the reference database table that contains additional
equipment information.
ee_part_key: the column containing the unique key to the appropriate record of equipment
information in the reference database table.
project
This table contains specification information for the project.
500
________________
Appendix C: EE Raceway Project Database Schema Description
mslink: a unique integer value used by the software to identify a row in the panel table.
panel_to_drw
This table links a panel/equipment to each drawing in which it exists.
C: EE Databases
ee_status integer no no
ee_to_panel: the column containing the mslink of a row in the panel table.
ee_asid: the column containing the asid number of the panel/equipment element in the design file
identified by the mslink stored in ee_to_drw.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_rcp: the column containing the mslink of a row in the RCP table.
ee_status: the column containing the revision status of the panel element in the design file (used by
the Load Database process).
rcp
This table contains information about all raceway connect points (RCPs) found in the drawing.
mslink: a unique integer value used by the software to identify a row in the rcp table.
501
________________
EE Raceway Modeling Reference Guide - February 2003
ee_rcp_type: the column containing the codelist value of the type of rcp.
rcp_to_drw
This table links an rcp to each drawing in which it exists.
ee_to_rcp: the column containing the mslink of a row in the rcp table.
ee_asid: the column containing the asid number of the rcp element in the drawing identified by the
mslink stored in ee_to_drw.
ee_to_drw: the column containing the mslink of a row in the drawing table.
pds_east: the column containing the PDS east coordinate of the rcp (calculated by Load Database).
pds_north: the column containing the PDS north coordinate of the rcp (calculated by Load
Database).
pds_elev: the column containing the PDS elevation coordinate of the rcp (calculated by Load
Database).
rcp_to_sys
This table links an rcp to each system of which it is a member.
ee_to_rcp: the column containing the mslink of a row in the rcp table.
ee_to_sys: the column containing the mslink of a row in the ee_system table.
502
________________
Appendix C: EE Raceway Project Database Schema Description
ee_percent: the column containing the percent amount of the fitting is contained in the system
identified by the mslink stored in ee_to_sys.
straight
This table contains information about the raceway straight sections found in the drawing.
C: EE Databases
pds_elev* real no yes
vendor Char( 20) dups yes
ee_units* Char( 20) no yes
ee_ol_type* Char( 20) no yes
ee_spec_key* Char( 28) dups yes
ee_part* Char( 20) no yes
material Char( 20) no yes
ee_description Char( 40) no yes
mslink: a unique integer value used by the software to identify a row in the straight table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_ol: the column containing the mslink of a row in the one-line table.
ee_out_ht_diam: the column containing the outside height or diameter of the straight section.
ee_out_width: the column containing the outside width of the straight section.
ee_weight: the column containing the straight section weight per unit length.
503
________________
EE Raceway Modeling Reference Guide - February 2003
cab_weight: the column containing the cable weight per unit length.
pds_east: the column containing the PDS east coordinate of the straight section (calculated by Load
Database).
pds_north: the column containing the PDS north coordinate of the straight section (calculated by
Load Database).
pds_elev: the column containing the PDS elevation coordinate of the straight section (calculated by
Load Database).
vendor: the column containing the codelist value of the vendor of the one-line type specification.
ee_units: the column containing the codelist value of the design file units.
ee_ol_type: the column containing the codelist value of the one-line type.
ee_spec_key: the column containing the unique key to the one-line type specification table.
str_to_sys
This table links a straight section to each system of which it is a member.
ee_to_str: the column containing the mslink of a row in the straight table.
ee_to_sys: the column containing the mslink of a row in the ee_system table.
ee_percent: the column containing the percent amount of the straight section is contained in the
system identified by the mslink stored in ee_to_sys.
504
________________
Appendix C: EE Raceway Project Database Schema Description
sys_to_drw
This table links a system name to each drawing in which the system exists.
ee_to_sys: the column containing the mslink of a row in the ee_system table.
ee_asid: the column containing the asid number of the system element in the drawing identified by the
mslink stored in ee_to_drw.
ee_to_drw: the column containing the mslink of a row in the drawing table.
to_support
This table links the raceway one-line with a support.
C: EE Databases
Column Name Type Index Null
mslink: a unique integer value used by the software to identify a row in the to_support table.
ee_to_drw: the column containing the mslink of a row in the drawing table.
ee_to_ol: the column containing the mslink of a row in the one-line table.
ee_ol_coord: the column containing the distance along the one-line to the support.
505
________________
EE Raceway Modeling Reference Guide - February 2003
506
________________ Appendix D: Specification
Appendix D Specification
Your reference database contains the specification tables (<one-line type>_part and <one-line type>_spec) that
drive the EE Raceway product. These tables contain all attribute information for the available one-line types.
The <one-line type>_spec table contains all specifications, while the <one-line type>_part table contains the
relevant data for each of the fittings within a specification. The specifications available at the time of printing
are for tray, wireway, airway, and conduit.
For special fittings like conduit bodies and pullboxes, the reference database contains one table for each fitting
type. The two special fittings delivered by default with EE Raceway are conduit body and pullbox.
SPEC Process
The SPEC process resides in the win32app\eerway\bin directory. If you intend to add records to an existing
.unl file, copy the appropriate <one-line type>_spec.unl to a file called <one-line type>_spec.sav before
running the process. The process will then write all records to this .sav file.
To initiate the process, key in SPEC at the command prompt. The following information displays to the
D: Specs
screen:
Respond to the prompts according to your requirements. Enter your reference schema name and the appropriate
table name. The system will attach a .sav extension to the specified table name, and will then write all records
to that file. Indicate whether or not you are adding records to an existing file (Is this a restart
(y/n). If you answer n to the prompt, the system will overwrite any records already existing in the specified
.sav file.
507
________________
EE Raceway Modeling Reference Guide - February 2003
The system processes the information, and then displays the column values for the table name you specified, in
a format similar to the following example (for tray_spec):
Key in values to the right of the () for each column value. Each value is verified according to the parameters
defined inside the < >. Once you enter the final value for the displayed table, the system writes the
information to the .sav file and redisplays the column names. It also displays the column values you entered for
the previous record. For subsequent records, press <RETURN> to accept the displayed values (in ()) or key
in new values as necessary. Continue this process as long as you wish to add records to your .sav file.
You can exit the process at any point by pressing CTRL -C. Copy the .sav file back to the corresponding .unl
file to keep the records you have added.
508
________________ Appendix D: Sample .unl Files
tray_spec.unl
D: Specs
509
________________
EE Raceway Modeling Reference Guide - February 2003
tray_part.unl
For information about running Update Reference Schema, see Update Reference Schema in the section
entitled Electrical Engineer (EE) Environment.
tray_spec table
510
________________ Appendix D: Sample .unl Files
tray_part table
* For information about the codelist values, see the appendix entitled EE Databases .
D: Specs
511
________________
EE Raceway Modeling Reference Guide - February 2003
Available Fittings
The following is a list of the fittings currently supported by the EE Raceway Modeling product:
Straight
Elbow Horizontal 30,45,60,90, and
Adjustable
Elbow Inside Vertical 30,45,60,90, and
Adjustable
Elbow Outside Vertical 30,45,60,90, and
Adjustable
Wye Horizontal 90,45 left and 45
right
Wye Vertical 90
Wye Reducer 90
Cross Horizontal 90
Cross Vertical 90
Reducer Left Horizontal
Reducer Right Horizontal
Reducer Concentric
Conduit
body
Pullbox
512
________________ Appendix E: Eden Symbol Generation
You do not need a programming background to write Eden programs. However, you should be familiar with a
standard ASCII editor like vi or emacs. You can write Eden code using whatever case conventions make it
easiest for you to read.
Eden provides drawing commands called primitives. Primitives allow you to construct complex symbols by
using a combination of simple commands (place_line, draw_arc, etc.).
For additional information about the Eden symbol language, see the PDS Eden Interface Reference Guide.
Every Raceway symbol must contain a symbol processor definition and at least one of each of the following:
Graphical element
E: Eden Symbols
513
________________
EE Raceway Modeling Reference Guide - February 2003
The best way to explain how a symbol processor file works is to show an example:
Before creating an Eden symbol processor file, you should have consulted the PDS Eden
Interface Reference Guide or have taken a course in Eden symbol generation.
=========================================================================
!
! Symbol Name: HEL
!
! Description: Horizontal Tray Elbow, with or without extensions.
!
=========================================================================
SYMBOL_PROCESSOR ’HEL’
!
! Get Dimensions Required to create the horizontal elbow.
!
angle = DIMENSION[4]
height = DIMENSION[21]
halfwid = DIMENSION[22] / 2.0
extension = DIMENSION[23]
radius = DIMENSION[25]
ORG = 19
BND1 = 20
BND2 = 21
EXT1 = 22
EXT2 = 23
ARC = 24
NUMPTS = 4
If ( halfwid .eq. 0.0 .or. height .eq. 0.0 .or. angle .eq. 0.0) then
Call ABORT ( 0 )
Endif
!
! Add dimension of tray to radius
!
!
! Calculate distances distance variables
!
! val1 = bendpoint on primary oneline
! val2 = primary distance to bendpoint on bent oneline
! val3 = secondary distance to bendpoint on bent oneline
! val4 = extension point on primary oneline
! val5 = primary distance to extpoint on bent oneline
! val6 = secondary distance to extpoint on bent oneline
!
514
________________ Appendix E: Eden Symbol Generation
!
! Define bendpoints (point2 and point3) and bend origin (point4)
!
!
! Define Placepoints
!
!
! Define cross section points
!
!
! Draw First Extension
! E: Eden Symbols
If ( extension .ne. 0 ) then
Do i = 1, NUMPTS, 1
Call Define_Point( Point[NUMPTS+i], Point[i],-extension, 0,
0, 0)
Enddo
Call Draw_Complex_Surface ( 1, 0 )
Call Draw_Line_String ( NUMPTS, Point[1] )
Call Draw_Line_String ( NUMPTS, Point[NUMPTS+1] )
Call Draw_Complex_Surface ( -4, 0 )
Do i = 1, NUMPTS, 1
Call Draw_Line ( Point[i], Point[NUMPTS+i] )
Enddo
Call Draw_Complex_Surface ( -99, 0 )
Endif
515
________________
EE Raceway Modeling Reference Guide - February 2003
!
! Draw revolved shape
!
Call Define_Orientation_By_Points(Point[1],Point[2],Point[3])
!
! Draw Second Extension
!
Do i = 1, NUMPTS, 1
Call Define_Point(Point[NUMPTS+i], Point[i], extension, 0,
0, 0)
Enddo
Call Draw_Complex_Surface ( 1, 0 )
Call Draw_Line_String ( NUMPTS, Point[1] )
Call Draw_Line_String ( NUMPTS, Point[NUMPTS+1] )
Call Draw_Complex_Surface ( -4, 0 )
Do i = 1, NUMPTS, 1
Call Draw_Line ( Point[i], Point[NUMPTS+i] )
Enddo
Call Draw_Complex_Surface ( -99, 0 )
Endif
Stop
End
SYMBOL_PROCESSOR ’<name>’
Stop
End
This line defines the symbol name. When defining parts in the reference database, the name of the symbol
should correspond with the ee_symbol in the part table. For more information see the description of
databases in the Workflow and Procedures chapter.
516
________________ Appendix E: Eden Symbol Generation
The symbol in the example defines the symbol name as Tray Horizontal Elbow.
The symbol derives the values for angle, height, width, extension, and radius from the global array
DIMENSION. EE Raceway fills the DIMENSION array with values extracted from the reference database.
For a description of which database columns are associated with what dimensions, see the table immediately
following this description.
EE Raceway uses a Datum Point to define the location of the RCP relative to the symbol. It uses Placepoints to
define the point by which you can place a fitting using manual placement. In general, the one-line will pass
through a placepoint on the symbol and will terminate at the RCP.
The creation of the horizontal elbow symbol is fairly straightforward given a knowledge of Eden primitives.
The RCP is defined in the active location with the active orientation, while other critical points are defined
relative to the origin. Then the placepoints are defined at either end of the elbow. If the fitting has extensions,
they are drawn as a surface of projection of a line string. The elbow is drawn as a surface of revolution.
DIMENSIONS
The DIMENSION structure contains specific information that has been extracted from the database and passed
through to Eden.
.. ........... ..........
.. ........... ..........
50 Dimension 25 Spec Table - ee_dimension_25
517
________________
EE Raceway Modeling Reference Guide - February 2003
518
________________ Appendix F: EE File Structure
F: File Structure
This section describes the file structure for EE Nucleus and EE Raceway. It also describes the contents
of directories and some files. It identifies those files you can modify.
519
________________
EE Raceway Modeling Reference Guide - February 2003
Any file followed by a slash (name/) is a directory. Any file followed by an asterisk (*)
is an executable.
/usr/ip32/eenuc:
/usr/ip32/eenuc/bin:
/usr/ip32/eenuc/bin/c100:
/usr/ip32/eenuc/config:
/usr/ip32/eenuc/data:
/usr/ip32/eenuc/db:
520
________________ Appendix F: EE Nucleus File Structure
/usr/ip32/eenuc/doc:
F: File Structure
/usr/ip32/eenuc/forms:
/usr/ip32/eenuc/msg:
/usr/ip32/eenuc/sym:
The following list gives a brief description of some of the files. The files are grouped by directory.
eenuc/
— README – file containing description of product features and any fixes, problems,
comments, etc.
— remove.sh – shell script used by the remove utility in deltools used to remove EE Nucleus
from the machine.
bin/ – contains the EE shell script and the environment process. The EE shell script sets up
variables specifying the location of MicroStation 32, INFORMIX, EE Nucleus, and EE WPD,
and then invokes the EE environment. C100 for C100 executables or C400 for C400
executables.
521
________________
EE Raceway Modeling Reference Guide - February 2003
— background – process that reports the exit status of a process run in the background.
— batch – process that reports the exit status of a process run in batch mode.
— clip – clears interprocess communication left after a process finishes. Also kills stray
processes.
— menu_shell – shell executed around eemgr to run the Edit Database process.
config/ – Contains the file that assigns and exports any required variables. The file assigns
MicroStation 32 variables, INFORMIX variables, and product variables.
— assign – shell script that assigns and exports any required variables. This file can be edited.
data/ – Contains the ASCII files used to control certain environment procedures.
522
________________ Appendix F: EE Nucleus File Structure
F: File Structure
— ustn_tsk – DB Access file.
db/ – directory that contains the DB Access menu library (mgrdba_lib). Required DBAccess
files are also delivered in this directory.
523
________________
EE Raceway Modeling Reference Guide - February 2003
/usr/ip32/eerway:
/usr/ip32/eerway/bin:
/usr/ip32/eerway/bin/c100:
/usr/ip32/eerway/cfg:
/usr/ip32/eerway/config:
/usr/ip32/eerway/data:
524
________________
Appendix F: EE Raceway File Structure
/usr/ip32/eerway/db:
F: File Structure
/usr/ip32/eerway/dgn:
/usr/ip32/eerway/dgn/seed:
/usr/ip32/eerway/doc:
/usr/ip32/eerway/eden:
/usr/ip32/eerway/help_source:
525
________________
EE Raceway Modeling Reference Guide - February 2003
/usr/ip32/eerway/help_source/help_graphics:
/usr/ip32/eerway/mdlapps:
/usr/ip32/eerway/menus:
/usr/ip32/eerway/msg:
/usr/ip32/eerway/report:
526
________________ Appendix F: EE Raceway File Structure
/usr/ip32/eerway/sym:
F: File Structure
/usr/ip32/eerway/tmp: delivered empty
The following list gives a brief description of some of the files. The files are grouped by directory.
eerway/
— README – file containing a description of the product features and any fixes, problems,
comments, etc.
— remove.sh – shell script used by the remove utility in deltools used to remove EE Raceway
from the machine.
config/ – Contains the file that defines and exports all variables required by EE Raceway and
those MicroStation 32 variables required by EE Raceway.
— assign – shell script that defines and exports any required variables.
data/ – Contains the ASCII files used to control process and report management for the EE
Raceway product. These files can be modified.
527
________________
EE Raceway Modeling Reference Guide - February 2003
db/ – Contains the delivered sql files for the project and reference database. Also contains .unl
files required for bulk loading special tables and the mscatalog table in the project database.
Sample .unl files for bulk loading reference database tables are also provided.
dgn/ – Contains the seed file directory, available cell libraries, and any design files delivered
with the product.
help_source/ – contains the text and source files required to support on-line Help.
— mstr_rway.hp – master help pointer file containing pointers to both MicroStation 32 and EE
Raceway Help.
menus/ – Contains the all menus (panel and bar) supporting the product. Also contains all
symbol and icon files required to support delivered menus. You can supply additional menu
files.
528
________________ Appendix F: EE Raceway File Structure
— merge_pnl/ – directory containing the merged panel menu consisting of EE Raceway and
MicroStation.
F: File Structure
— rway.bar – bar menu source file.
msg/ – Contains EE Raceway message files and the file to correlate key-ins to EE Raceway
commands.
— alias.cmd – file used to correlate key-ins to commands. This file can be extended.
— command.msg – message file containing all messages for the command field. These
messages can be edited but messages can not be added.
— error.msg – message file containing all error messages for the error field. These messages
can be edited but messages can not be added.
— prompt.msg – message file containing all messages for the prompt field. These messages
can be edited but messages can not be added.
— rway_prj.tbl – file containing the entity numbers for the project database tables.
— rway_ref.tbl – file containing the entity numbers for the reference database tables.
— status.msg – message file containing messages for status field, prompting messages, and
logo. These messages can be edited but messages can not be added.
report/ – Contains the source (.ace)and compiled (.arc) SQL files for all delivered sch reports.
The source files may be edited by the user. There is an .ace and an .arc file for each report listed
below.
sym/ – Contains all symbol files for EE Raceway menus. This directory also contains the
available precision input forms.
tmp/ – Holds any temporary files. The software requires this directory.
529
________________
EE Raceway Modeling Reference Guide - February 2003
530
________________ Appendix G: Customizing Environment Files
Appendix G Customizing
Environment Files
This appendix contains printouts of the following files as they are delivered with EE Raceway:
File Location
eden.dat win32app\ingr\eerway\data
process.dat win32app\ingr\eerway\data
Environment
G: Customizing
report.dat win32app\ingr\eerway\data
rule_chk.dat win32app\ingr\eerway\data
print.dat win32app\ingr\eenuc\data
manager.dat win32app\ingr\eenuc\data
process.dat, report.dat, rule_chk.dat, and print.dat control the scrolling lists for the Process, Report,
Rule, and Output menus, respectively. You may want to write your own processes, reports or rule
checks or change their names from what is delivered. This section describes the syntax needed to
modify the scrolling list for the Process, Report, Rule, and Output.
The manager.dat file controls the scrolling list for the options available through the system manager
menu. You can add defaults to this screen by modifying the file.
eden.dat
#ident "@(#)Eden processes:eden.dat 13.1 0.0 (EE Raceway) 12/14/93"
#
# Note: No blanks lines allowed in this file.
#
# eden.dat
# This file is stored under the %EE_RWAY%\data directory.
# The syntax of this data file is :
#
# Title | Command Line | Prompt,Default,Path,Switch | , , ...
#
# The first column for a comment line must be the ’#’ character.
# The ’\’ is the line continuation character.
#
# The first field is the title which will appear on the scrolling list.
#
# The second field is a command line containing the name of the executable.
#
# The third field and each subsequent field will contain three sub-fields
# using the comma (,) as the delimeter
#
# They are :
# Prompt,Default,Path,Switch
# The default can be a global symbol or file.
# Any of the sub-fields in the third field can be omitted
#
# Change History:
# Added the ability to list/extract user functions 31-May-95
#
Compile EDEN Symbol | %EE_RWAY%\bin\eden.bat -c \
| Enter library name ,%EDEN_LIB%,, \
| Enter symbol source file ,,,\
| Enter option (-l=list or -o=insert),-O,,
#
531
________________
EE Raceway Modeling Reference Guide - February 2003
#
#
Delete EDEN Symbol | %EE_RWAY%\bin\eden.bat -d\
| Enter library name ,%EDEN_LIB%,, \
| Enter symbol name ,,,
#
#
#
List EDEN Symbol Library | %EE_RWAY%\bin\eden.bat -l \
| Enter library name ,%EDEN_LIB%,,
#
#
#
List EDEN User Functions | %EE_RWAY%\bin\eden.bat -u \
| Enter library name ,%EDEN_LIB%,,
#
#
#Create Parameteric Help Library | %EE_RWAY%\bin\eden.bat -C \
# | Enter library name ,%EDEN_LIB%,,
#
#
#
Merge EDEN Symbol Libraries | %EE_RWAY%\bin\eden.bat -m \
| Merge into library name ,,, \
| Merge from library name ,,,
#
#
#
Compress EDEN Symbol Library | %EE_RWAY%\bin\eden.bat -s \
| Enter library name ,%EDEN_LIB%,,
#
#
#
Extract EDEN Symbol From Library| %EE_RWAY%\bin\eden.bat -e \
n
| Enter library name ,%EDEN_LIB%,, \
\ ,,,
| Enter symbol name
d
# e
# n
.
Extract EDEN User Function From Library| %EE_RWAY%\bin\eden.bat -eu \
b
| Enter library name
a ,%EDEN_LIB%,, \
t ,,,
| Enter symbol name
#
-
# E
Edit EDEN Symbol File | %EE_RWAY% tor,notepad,, | Enter symbol file name,,,
#
# |
E
n
t
e
r
e
d
532
________________ Appendix G: process.dat
process.dat
#ident "@(#)data:process.dat 13.1 0.0 (EE Raceway) 12/14/93"
#
# Note: No blanks lines allowed in this file.
#
# process.dat
# This file is stored under the %EE_SCH%\data directory.
# The syntax of this data file is :
#
# Title | Command Line | Prompt,Default,Path,Switch | , , ...
#
# The first column for a comment line must be the ’#’ character.
# The ’\’ is the line continuation character.
#
# The first field is the title which will appear on the scrolling list.
Environment
G: Customizing
#
# The second field is a command line containing the name of the executable.
#
# The third field and each subsequent field will contain three sub-fields
# using the comma (,) as the delimeter
#
# They are :
# Prompt,Default,Path,Switch
# The default can be a global symbol or file.
# Any of the sub-fields in the third field can be omitted
#
# NOTE: Many processes run off the project or reference schema (or both).
# Two environment symbols have been set up for these schemas: EE_SCHEMA
# for the project schema and EES_REFDB for the reference. These symbols
# are exported by the EE environment when a project is entered. This was
# done to handle schema passwords. The symbol is exported as
# <schema_name>.<password> if a password is keyed in on the project form.
# So, any customized processes written should read these symbols in the
# process instead of passing them on the command line. The password will
# have to be handled accordingly.
#
#
Load Database | %EE_RWAY%\bin\load.exe \
| Enter design name,%RWAY_DGN%, %EE_CURPRJ%\rway\dgn,-f
#
#
#
Unload Design | %EE_RWAY%\bin\unld_cln.exe \
| Enter design name,%RWAY_DGN%, %EE_CURPRJ%\rway\dgn,-F
#
#
Unload Sheet | %EE_RWAY%\bin\unld_cln.exe -s \
| Enter sheet,,,
#
#
Cleanup database | %EE_RWAY%\bin\unld_cln.exe
#
#
Create Interference Envelope (default name) | %EE_RWAY%\bin\idet.exe \
| Enter design name,%RWAY_DGN%, %EE_CURPRJ%\rway\dgn,-f
#
#
Create Interference Envelope (given name) | %EE_RWAY%\bin\idet.exe \
| Enter one design name,%RWAY_DGN%, %EE_CURPRJ%\rway\dgn,-f \
| Enter envelope name,,,-e
533
________________
EE Raceway Modeling Reference Guide - February 2003
report.dat
#ident "@(#)data:report.dat 7.1 0.0 (EE Raceway) 6/1/92"
#
# Note: No blanks lines allowed in this file.
#
# report.dat
# The syntax of this data file :
# Title | Command Line | Report Name | Prompt,Default | , , ...
#
# The first field is the title which will appear on the scrolling list.
# The second field is the command field.
# The third field is the name of the report which can be a global symbol
# or a file name.
# The fourth field and each subsequent field will contain two sub-fields
# using the comma (,) as the delimeter.
#
# They are:
# Prompt,Default
# The default can be a global symbol or file.
# Any of the sub_fields in the third field can be omitted.
#
#
Project drawing list | %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib %EE_RPTDB% dummy \
| drwlst \
| Enter project schema,%EE_SCHEMA%
#
#
Material takeoff report | %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib %EE_RPTDB% dummy \
| mto_rpt \
| Enter project schema,%EE_SCHEMA%
#
#
Raceway bill of materials report| %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib %EE_RPTDB% dummy \
| rway_bom \
| Enter project schema,%EE_SCHEMA%
#
#
Raceway bill of materials by volume| %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib %EE_RPTDB% dummy \
| rway_bom_v \
| Enter project schema,%EE_SCHEMA% \
| Enter low range (PDS coordinates: east north elev) \
| Enter high range (PDS coordinates: east north elev)
#
#
Raceway Conduit Body report| %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib dummy %EE_RPTDB% \
| cond_body \
| Enter Reference schema,%EES_REFDB%
#
#
534
________________ Appendix G: rule_chk.dat
rule_chk.dat
#ident "@(#)data:rule_chk.dat 13.1 0.0 (EE Raceway) 12/14/93"
#
# Note: No blanks lines allowed in this file.
#
# rule_chk.dat
# The syntax of this data file is :
# Title | Command Line | Report Name | Prompt, Default | , , ...
#
# The first field is the title which will appear on the scrolling list.
# The second field is the command field.
# The third field is the report name which can be a global symbol or file.
# The fourth field and each subsequent field will contain two sub-fields
# using the comma (,) as the delimiter
#
Environment
G: Customizing
# They are: Prompt,Default
# The default can be a global symbol or file.
# Any of the sub_fields in the third field can be omitted.
#
#
Material takeoff blank part ID’s | %EE_NUC%\bin\dbashell.cmd %EE_RPTNAM% %EE_RPTDB% %EE_RWAY%\report\rwaydba_lib %EE_RPTDB% dummy \
| blank_ids \
| Enter project schema,%EE_SCHEMA%
#
#
535
________________
EE Raceway Modeling Reference Guide - February 2003
print.dat
#ident "@(#)env_data:print.dat 21.1 0.0 (EE Schematic) 3/9/94"
#
# Note: No blanks lines allowed in this file.
#
# print.dat
# This file is stored under %EE_NUC%\data directory.
# The first column of comment line must be #.
# The syntax of this data file is :
# TITLE | COMMAND | PROMPT,DEFAULT,PATH,SWITCH...
# The titles are the messages on the scrolling list.
# The command can be any command to output a file.
# The third field is made up of four parts: prompt,default,path and switch.
# (The path is not relevant). This field should be used to pass
# information to the command. A file name is automatically appended to
# the command as the last parameter.
#
TO SCREEN| SCREEN
#
# Local line printer
#
Local Printer| lp
#
# NQS print command to print to a laser printer
#
Laser Printer 80 columns | qpr -t text\
| Enter queue name,,,-q
#
Laser Printer 132 columns | %EE_NUC%\bin\eeqpr \
| Enter queue name,,,
#
# This is an example of a way to print to a VAX. The command "vaxprint"
# could be a shell script or an exported shell function.
#
#VAX Line Printer| vaxprint
#
536
________________ Appendix G: manager.dat
manager.dat
#ident "@(#)env:manager.dat 21.1 0.0 (EE Nucleus) 3/9/94"
#
# Note: No blanks lines allowed in this file.
#
# manager.dat
# This file is stored under the %EE_NUC%\data directory.
# The syntax of this data file is :
#
# Title | Command Line | Prompt,Default,Path,Switch | , , ...
#
# The first column for a comment line must be the ’#’ character.
# The ’\’ is the line continuation character.
#
Environment
G: Customizing
# The first field is the title which will appear on the scrolling list.
#
# The second field is a command line containing the name of the executable.
#
# The third field and each subsequent field will contain three sub-fields
# using the comma (,) as the delimeter
# n
# They are :
# b
Prompt,Default,Path,Switch
a
# The default can be a global
_ symbol or file.
r the third field can be omitted
# Any of the sub-fields in
# p
t
# .
Edit database | %EE_NUC%etnt -l %EE_NUC%\db\mgrdba_lib \
x
| Enter schema name,,, -s
e
#
# -
m
#Compress database - INFORMIX SE | vterm -x %EE_NUC%\bin\infxcompress -T compress
# d
# b
e
#Compress database - INFORMIX Online | vterm -x %EE_NUC%\bin\infx_ol -T compress
d
#
Create mscolumns table | %EE_NUC%\bin\mscrecol.cmd \
|Enter schema name,,,
537
________________
EE Raceway Modeling Reference Guide - February 2003
538
________________ Appendix H: alias.cmd file
The alias.cmd file is an ASCII file located in win32app\ingr\eerway\msg. You can use any text editor
to modify the file. The alias.cmd file contains instructions for adding an entry, the format of such an
entry, a sample entry, and a list of EE Raceway command names and the hard-code for each command.
The example in the alias.cmd file explains how to create an alias for a particular command. To the left
of the equal sign (=) in this example is the user-definable alias key-in name. The fixed (hard-coded)
command name is to the right of the equal sign. If you were to add this example to the alias.cmd file,
then the key-in EERWAY Remove Element would invoke the command EERWAY Delete
Element, just as would the key-in EERWAY Delete Element.
You do not need to add entries to the alias.cmd file; the command name key-ins in the file will invoke
the commands to which they correspond.
You need to key in just enough of the key-in name to make it unique. For example, if
the sample alias entry (in the file below) were added to alias.cmd, you would need only
to key in r e to invoke the command.
H: alias.cmd file
Since the EE Raceway software has a reserved set of names for each Raceway command
which are hard-coded into the EE Raceway software, any alias you add to this file must not
match any of the command name key-ins or hard-coded names listed below.
The following is a print-out of the alias.cmd file (the # symbols indicate comment lines):
539
________________
EE Raceway Modeling Reference Guide - February 2003
540
________________ Appendix H: alias.cmd file
H: alias.cmd file
541
________________
EE Raceway Modeling Reference Guide - February 2003
542
________________ Appendix I: rway.cmd
Appendix I rway.cmd
The file rway.cmd is the MicroMenu (umenu) command file that is used to attach the EE Raceway
menus. It is run automatically when you enter the EE Raceway environment. This file is located in the
directory path win32app\eerway\db and activates the rway.ammfile.
If you do not want the rway.cmd file to be executed, you can comment out the export
variable RWAY_CMD using the EE Configure command.
The rway.cmd file may also be edited by the user. MicroStation reads this file and processes the
commands as if keyed in by the user. You can disable any of these features by commenting out the
line(s) that enable the feature. (Place a pound sign (#) in front of any line you do not want executed.)
Below is the file as it is delivered in the product directory:
I: rway.cmds
543
________________
EE Raceway Modeling Reference Guide - February 2003
544
________________ Appendix J: Reports
Appendix J Reports
This section describes each report delivered with EE Raceway. It specifies the attributes used in the
report and describes some of the internal operation behind report generation. This information will be
helpful if you want to use a delivered report as a template for a customized report. The EE Raceway
reports report on the project database, the reference database and, in some cases, both.
All EE Raceway reports are currently written for RIS-DBACCESS. Documentation explaining how to
create and compile customized reports with RIS-DB ACCESS is available in the DB ACCESS
Reference Guide, the Project Data View Reference Guide, and the RIS Report-Writer Reference Guide.
All EE Raceway reports are compatible for use with either RIS Report-Writer (RISRPT) or DB Access
(DBA).
Usage:
-s <schema name> This is the name of any current RIS schema, It is used as a "default"
J: Reports
schema to enter DB Access. It doesn’t have to be the schema your
report is running off of.
-l <template library> This is the library of templates created to run reports from. Created
through DB Access, Project Dataview, or RIS Report-Writer this is
your report source code, layout, and print conditions.
-t <report template> The name of the report you wish to run from your report template
library.
-M <menu template> The name of the menu you wish to run from your menu template
library.
-w <where clause> Used to restrict the report output to a certain type of condition, i.e.
"where name = ’joe smith’ and number = 32".
545
________________
EE Raceway Modeling Reference Guide - February 2003
-o <output filename> All reports have a hardcoded, default file name that they write to. If
you wish to override this name, the "-o" option can be used. (The
current standard is that the output filename be the same as the template
name, with a ".rpt" added to the end.)
-S <schema list> This is the list of schemas your report actually runs through. *
-F <database find> selects one character string from the database based on the select
statement entered (i.e. "select value_a from table_b
where....") and places the result into the third parameter (wtr_p2))
[wtr_p0]...[wtr_p5] These are parameters that can be passed to a report template, and
referenced by the literal string "wtr_p0"... The first parameter is read
into wtr_p0, etc. up to a maximum of six parameters (wtr_p5).
When you create a template, and use a schema from the schema list, whatever that
schema’s position was in that list (first, second, third, etc.) the report template will look
at the schema in that same position when it is executed. Thus, be careful of how your
list looks before you develop a report template.
Certain variables may be exported, and will be picked up as defaults if switches are not used. They
are:
It is useful to export these variables before entering DB Access, RIS Dataview or RIS Report-Writer to
create or alter existing templates.
* (The schemas in this list need to be in the same order as they were in DBA_SCHEMA_LIST when
the report was originally developed. The correct order is <project schema> <reference
schema>, since all EE Raceway reports were developed with the project schema listed first and the
reference schema listed second. Example: "-S prj_schema ref_schema".)
546
________________ Appendix J: Project Drawing List (drwlst)
Information Output:
Drawing.
drawing_type, filename, sheet, load_date, ref_db.
Associated Software/Files
1. Project Database
3. dba_rpt - the RIS process, found in $EE_NUC/bin, used to execute the $EE_RWAY/report/rwaydba_lib
drwlst template.
J: Reports
547
________________
EE Raceway Modeling Reference Guide - February 2003
Information Output:
System.
system_name
Straight.
ee_ol_type, ee_tl_length, ee_out_width, ee_out_ht_diam, ee_part,
description
Fitting.
ee_ol_type, ee_tl_type, ee_tl_subtype, ee_out_width,
ee_out_ht_diam, ee_part
Associated Software/Files
1. Project Database
3. dba_rpt - the RIS process, found in $EE_NUC/bin, used to execute the $EE_RWAY/report/rwaydba_lib
mto_rpt template.
548
________________
Appendix J: Raceway Bill of Materials Report (rway_bom)
Information Output:
Straight.
ee_ol_type, ee_tl_length, ee_out_width, ee_out_ht_diam, ee_part,
description
Fitting.
ee_ol_type, ee_tl_type, ee_tl_subtype, ee_out_width,
ee_out_ht_diam, ee_part
Associated Software/Files
1. Project Database
3. dba_rpt - the RIS process, found in $EE_NUC/bin, used to execute the $EE_RWAY/report/rwaydba_lib
rway_bom template.
J: Reports
549
________________
EE Raceway Modeling Reference Guide - February 2003
Any Raceway component extending outside the clipping volume defined by the High and Low Range
Coordinates will not be included in the report output.
You can find the coordinates you want to use by using the active point coordinate display on the precision input
form. The coordinate values need to be in subunits and entered in the form field with a space between the
coordinates: easting northing elevation For example, 234 532 34
It should be understood that westing and southing coordinates must be the negative of their
opposite directional coordinate. For instance, a westing coordinate of 100 should be keyed in as
a value of -100 in the easting direction, and a southing coordinate of 3000 should be keyed in as
a value of -3000 in the northing direction.
550
________________
Appendix J: Raceway Bill of Materials by Volume Report (rway_bom_vol)
Information Output:
Straight.
ee_ol_type, ee_tl_length, ee_out_width, ee_out_ht_diam, ee_part,
description
Fitting.
ee_ol_type, ee_tl_type, ee_tl_subtype, ee_out_width,
ee_out_ht_diam, ee_part
Associated Software/Files
1. Project Database
3. dba_rpt - the RIS process, found in $EE_NUC/bin, used to execute the $EE_RWAY/report/rwaydba_lib
rway_bom_vol template.
J: Reports
551
________________
EE Raceway Modeling Reference Guide - February 2003
Information Output:
System.
system_name
Straight.
ee_ol_type, ee_tl_length, ee_out_width, ee_out_ht_diam, ee_part,
description
Fitting.
ee_ol_type, ee_tl_type, ee_tl_subtype, ee_out_width,
ee_out_ht_diam, ee_part
Associated Software/Files
1. Project Database
3. dba_rpt - the RIS process, found in $EE_NUC/bin, used to execute the $EE_RWAY/report/rwaydba_lib
blank_ids template.
552
________________ Appendix K: RIS Schema Manager
Mgr.
K: RIS Schema
The RIS Schema Manager is a stand-alone utility for creating, changing, and dropping RIS schemas. It
can also be used to display information about any existing schemas. You can access RIS Schema
Manager from EE Database Utilities or by clicking Start > Programs > RIS version number > RIS
Schema Manager. This form consists of a list of all the schemas known to RIS and several buttons
corresponding to the actions of the Schema Manager. If you select any of the buttons, RIS initiates that
particular action by displaying one of the forms defined below. If you select one of the schemas in the
list, then information about that schema is displayed.
When you select Reset, any active secondary forms are erased, and the RIS Schema Manager rereads
the risschema file. When you select Cancel (X), RIS Schema Manager terminates.
For more detailed information on the RIS Schema Manager, refer to the Relational Interface System
(RIS) Reference Guide.
553
________________
EE Raceway Modeling Reference Guide - February 2003
554
________________ Appendix K: Create Schema Form
Mgr.
K: RIS Schema
This form creates new RIS schemas, and corresponds directly to the RIS create schema
statement. You can enter database-specific information on the Create Schema form using one of three
methods:
1. Key in all information in the input fields. This is your only alternative if the schema is created
on a database which is unknown to RIS.
2. Select an existing schema on the RIS Schema Manager form. The database-specific
information about that schema is entered in the Create Schema input fields. This method is
particularly convenient when creating additional schemas for a database.
3. Select the Display Databases button. A form listing all the known RIS databases is displayed.
If you select one of the databases, information about that database is entered into the Create
Schema input fields.
Selecting the Local Machine button fills the Node Address field with the addresses of the local
machine.
Selecting the Force button forces the system to create the schema despite corrupted data or other errors
it may encounter.
To change the order of the Network Protocol fields, select one of the Network Protocol fields; its
value will be replaced with the value of the field below it. The value you selected originally moves to
the bottom of the list.
If the selected database type requires additional information, input fields for that information display.
Once you have entered all necessary information, select Run to create the schema.
Selecting Reset clears all input fields on the form. Selecting Cancel (X) exits the form.
555
________________
EE Raceway Modeling Reference Guide - February 2003
To select the schema to be altered, either enter the schema name in the
Schema Name field, or select a schema from the list on the RIS Schema
Manager form.
You must enter both the original and new passwords to modify the schema
password. To modify the user password, you need only to enter the new
password.
To modify the schema node, enter the new addresses in the Node Address
fields. This action can also be used to change the order of the fields or to
change the order of the protocols. When you have entered all necessary
information, select Run to alter the schema. Selecting Reset clears all the
fields on the form. Selecting Cancel (X) exits the form.
556
________________ Appendix K: Data Definition Form
Mgr.
K: RIS Schema
This form consists of a list of all the tables, views, and
indexes defined for the schema specified in the schema
name field. The form buttons represent the data
definition actions of the Schema Manager. Selecting
any of these buttons initiates an action, and displays one
of the subforms defined in following sections. If the
selected schema requires a password, then you must
enter it before the subforms (Create Table, Drop
Table, and Alter Table) will accept input.
557
________________
EE Raceway Modeling Reference Guide - February 2003
If the name of an existing table is entered into the Table Name field, or chosen from the list
on the Data Definition form, the definition of that table will be loaded into the Create Table
form. This can be useful when creating several similar tables.
This form has two sets of Control buttons. There is the usual set, in the upper right corner of
the form, which behaves as expected. Then there is the second set, referred to as the Mode
Control buttons, which is used to execute and reset the different modes of the form. The
Create Table operates in three modes which are represented by the three buttons: Insert
Column, Drop Column, and Modify Column. These three buttons place the form in a
particular mode, while choosing the Mode Run button actually causes the action to take
place. Selecting the Mode Reset button clears the form mode.
In Insert Column Mode, new columns can be added to the table definition. If a column is
chosen in the table definition list, the new column is inserted in front of the chosen column.
Otherwise the new column is appended to the list. Select the Mode Run button to insert the
column.
In Drop Column Mode, columns can be dropped from the table definition. The column to be
dropped must be specified by keying in the column name in the Column Name Search field,
or by selecting the column in the table definition list. Select the Mode Run button to drop the
column.
In Modify Column Mode, column definitions can be modified. The column to be modified
must be specified by keying in the column name in the Column Name Search field, or by
selecting the column in the table definition list. Select the Mode Run button to modify the
column.
Once the table definition is complete, select Run to create the table. Select Reset to clear the
form. Select Cancel (X) to exit the form.
The Create Table form is used only to create new tables. It cannot be used to modify
existing tables. The ability to load existing table definitions into the form exists just to
provide a template or starting point for a new table.
558
________________ Appendix K: Create Table Form
Mgr.
K: RIS Schema
Definition form. The table to be dropped can be specified by
keying in the table name in the Table Name field or by selecting
the table from the list on the Data Definition form. Selecting Run
drops the table. Selecting Reset clears the form. Selecting Cancel
(X) exits the form.
Once the new column is defined, select Run to alter the table. Selecting Reset clears the
form. Selecting Cancel (X) exits the form.
559
________________
EE Raceway Modeling Reference Guide - February 2003
Selecting Reset clears the form. Selecting Cancel (X) exits the form.
Set Form
This form allows you to toggle the database mode ANSI setting on and off, and it also allows
you to specify which RDBMS(s) your schemas can use. Selecting Reset clears the form
settings. Selecting Cancel (X) exits the form.
560
________________ Appendix L: RIS Schema Definition File
Although you can use multiple files, it is still advisable to use only one schema file.
Multiple files often result in a large number of inconsistencies.
Definition
L: Schema
Access to the schema file is controlled by the presence of another file. This file is the schema lock file.
The name of the schema lock file is the same as the schema file with the addition of the .LCK
extension. The schema file is accessible only if the schema lock file exists. If the lock file does not
exist, then the schema file is in use. Sometimes when RIS is abnormally terminated, the schema lock
file is not replaced as it should be. In these cases, the lock file must be replaced manually.
The location of the schema definition file must be in the ris/parameters file on the client machine. The
parameters file describes the network address and filename of the schema definition file. The
locate schfile command in the interactive utility can be used to put the appropriate entry in the
parameters file.
If there is no network address given, the schema definition file will be created or used on the local
machine.
If the filename is not a full pathname, RIS will look for the file in the directory where RIS was
installed on the given machine.
The parameters file is shipped with a default schema definition file specification, referencing the file
risschema in the directory where RIS was installed.
The schema definition file consists of database and schema entries which are associated by a DBID
(database ID) key value. There can be multiple schema entries for each database entry. A line
separates entries. Here is a description of the fields in the schema definition file:
561
________________
EE Raceway Modeling Reference Guide - February 2003
ARCH The system architecture that the RIS/DBMS runs on. This
value is case-sensitive. The valid value is s370 and the default
value is s370.
OS The operating system that the RIS/DBMS uses. This value is
case-sensitive. The valid value is mvs and the default value is
mvs.
ENV The environment that the RIS/DBMS uses. This value is
case-sensitive. The valid value is cics and the default value is
cics.
NET_PROTOCOL The network protocol that RIS uses to get to the IBM machine
where the DBMS resides. This value is case-sensitive. The
valid value is lu6.2 and the default value is lu6.2.
RIS_LU or the name of the Clipper System Administrator assigned to the
HOST_LU logical unit that allows communication to the RIS program on
the IBM machine. There are two logical units, one on the
Clipper, the other on the IBM. The LU names are generated
when RIS is installed. This value is case-sensitive.
MODE The name the Clipper System Administrator assigned to the
mode that allows communication to the RIS program on the
IBM machine.
HOST_PROGRAM The name the IBM System Administrator called the RIS
server when it was installed on the IBM, the CICS transaction
name.
A schema file must be readable and writable by all users. All users must be able to
create and delete files in the directory where the schema file is located.
CHECKSUM:1249378903
TIMESTAMP:728930074
——————————————————————————–
DBID=2
DTYPE=X
DBNAME=/usr/ee/sample_ref
PROTOCOL=X
NETADDR=0001349b.08-00-36-32-e4-00
PROTOCOL=T
NETADDR=129.135.142.155
PROTOCOL=
NETADDR=
PROTOCOL=
NETADDR=
DIR=/usr/informix
SQLEXEC=
DBTEMP=
TBCONFIG=
——————————————————————————–
DBID=1
DTYPE=X
DBNAME=/usr/ee/sample
PROTOCOL=X
NETADDR=0001349b.08-00-36-32-e4-00
PROTOCOL=T
NETADDR=129.135.142.155
PROTOCOL=
562
________________ Appendix L: RIS Schema Definition File
NETADDR=
PROTOCOL=
NETADDR=
DIR=/usr/informix
SQLEXEC=
DBTEMP=
TBCONFIG=
——————————————————————————–
SCHNAME=sample_ref
USR=ee
USRPASS=pz_-!=%#oa/#@?%qHt%h&jXJ2vj(tyeY%i)pV
BEGIN_GRANTEES
END_GRANTEES
DBID=2
——————————————————————————–
SCHNAME=sample
Definition
L: Schema
USR=ee
USRPASS=’<j8,H:.zW%wU5yg)U:IeK9tGB6R@Ezn:˜>’k
BEGIN_GRANTEES
END_GRANTEES
DBID=1
Note that there is a list of protocols in the database entry. This allows for additional protocols in the
future. Currently, only the first protocol in the list will be used.
All these entries are created by the create schema statement. If the file is corrupted or removed,
they can be recreated by reissuing the create schema statements.
563
________________
EE Raceway Modeling Reference Guide - February 2003
564
________________ Appendix M: EE Manager
Appendix M EE Manager
EE Manager is an environment created specifically for system manager functions. It is a process
separate from the EE environment and should only be run by a system manager or by someone who
has a working knowledge of the overall EE system.
To run EE Manager, the environment variable SYS_PASSW_FILE must be set to a complete path of
a password file. For detailed information on setting environment variables, see Appendix N.
SYS_PASSW_FILE=d:\users\EEpasswd
where \users is the path and \EEpasswd is the password file name. The password file will be created
the first time you enter EE Manager using the file name you specified. Make sure the directory path
to the password file exists. Once SYS_PASSW_FILE is set, double click on the EE Manager icon to
display the Verify Password form.
M: EE Manager
EE Manager will prompt you for a password and, if you are entering the environment for the first
time, will prompt you to re-enter the password for verification. Once you have successfully entered
your password, the EE Manager form displays:
565
________________
EE Raceway Modeling Reference Guide - February 2003
In this Appendix
Edit Database edits any schema that exists in the RIS dictionary. It uses DB Access to query
and edit tables, delete rows, and update rows.
566
________________ Appendix M: Database Edit Functions
M: EE Manager
Buttons at the bottom of the Database Edit form provide functions for manipulating the attached relational
database. These buttons include various Query functions, which allow you to search the database, and functions
which enable you to change, delete, and insert a row or group of rows.
A group of rows that match the current "query" criteria is called a universe. A universe is located by selecting
Process Query in the Database Edit environment.
Field Descriptions
Initialize Query — Initializes (clears) the current find criteria.
Edit Query — Displays the Edit Query screen, which shows the current find criteria. From this screen
you can edit the current find criteria, save the current find criteria as a file to the attached library, or load
find criteria from a file in the attached library.
Current Row — Controls the display of rows in the current universe. Select the arrows to move forward
and backward through the rows in the universe. To go directly to a certain row, place the screen cursor on
the slide bar button, press and hold the middle button on the mouse and drag the button. The number on
the button changes to reflect the row. Release the mouse button to display the row. You can place the
screen cursor at any point along the slide bar and press <D> to move the slide bar button directly to a new
row, or edit the value displayed in the field.
Process Query — Searches the database to find all rows of the current table that meet the find criteria. If
no find criteria exist, this command finds all rows in the current table.
567
________________
EE Raceway Modeling Reference Guide - February 2003
Review — Generates a formatted column-by-column listing of the current universe. You can generate a
review for all rows with database linkages to graphic elements within a fenced area in a design file.
Update Active — Lets you enter data without changing the displayed row in the database. When you
select Update Active, you can enter data on the displayed row without changing the database. When you
are certain the data is correct, you can use the Insert Row command to add the displayed data as a row to
the database. You can also use the Update Active command to enter information for a new row when
attaching new linkages in graphics.
Fields On/Off — Toggles all column fields ON or OFF. You can toggle individual fields ON or OFF by
selecting the field’s corresponding column name on the Database Edit screen.
Add Query — Used with the AND/OR toggle and relational operators to establish find criteria.
Selecting Add Query puts the screen in Add Query mode. As long as this command is active, any key-in
in the screen menu is added as find criteria and is NOT made as a change in the database. Relational
Operators let you search for ranges of column values such as greater than and less than. The field under
the AND/OR toggle lets you edit the active relational operator. You can either edit the displayed value or
select the right side of the field (a small box with dashes). A box containing a list of the various relational
operators displays. You can select a relational operator from the list to make it the active relational
operator.
= : equal to (default)
!= : not equal to
< : less than
> : greater than
<= : less than or equal to
>= : greater than or equal to
!! : substring search
The AND/OR toggle lets you establish either a logical AND or OR operation. AND finds any rows that
contain both the previous find criteria and any current column value you specify. OR finds any row that
contains either the previous find criteria or any current column value you specify. Multiple column
searches are processed in order, with logical AND having precedence over logical OR.
Change All — Changes the value for one or multiple columns for all rows in the current universe.
Change Row — Activates the Change Row mode, which overrides the key-in mode for Key Columns,
Add Query columns, and Update Active fields. Fields with these key-in modes are placed only when
you customize a screen menu. By default, the Database Edit screen has only Change Row fields.
Insert Row — Inserts a new row based on the column values for the displayed row.
Insert Row will not create a new row if a column is a SERIAL column (INFORMIX) or if it has a
UNIQUE INDEX and a displayed column value duplicates the value for an existing row. You can use the
Update Active command to enter the column values you want for a row and then Insert Row to create a
row with the displayed information.
Delete All — Deletes all rows in the current universe from the database upon user verification.
568
________________ Appendix M: Database Edit Functions
Delete Row — Deletes the displayed row from the database upon user verification.
M: EE Manager
569
________________
EE Raceway Modeling Reference Guide - February 2003
570
________________ Appendix N: EE Configure
Appendix N EE Configure
EE Configure is a process created specifically for setting environment variables for EE Raceway on a
Windows NT platform. This process is separate from EE Environment and allows changes to the value
of a variable in the ee.cfg file. Double-click on the EE Config icon to display the Configure EE
Environment form.
Field Descriptions
Enter the EE File Name — The field below this label contains the complete path and filename
where the current configuration file ee.cfg is located.
N: EE Configure
User Environment Variables — The list below this label contains the list of all the
environment variables along with their path.
Variable — The field next to this label displays the Environment Variable name when any row
is selected in the list menu.
Value — The field next to this label displays the value of the Environment Variable when any
row is selected in the list menu.
Descrip — The field next to this label displays the description associated with the selected
Environment Variable.
Set — The Set button writes the corresponding variable and its value to the list.
Delete — The Delete button deletes the corresponding variable and its value from the list.
Reset — The Reset button writes the contents of the ee.cfg file to the list.
571
________________
EE Raceway Modeling Reference Guide - February 2003
Browse — The Browse button lets you select the required ee.cfg file.
Steps
1. Double click on the EE Configure icon, the Configure EE Environment form displays the list
of user environment variables and their corresponding value.
2. Select the environment variable you want to change from the User Environment Variables list.
3. The name of the environment variable appears in the Variable field. This same field can be
used to add a new variable.
4. The corresponding value of the environment variable appears in the Value field. The
description, if any, appears in the Descrip field.
6. Click on the Set button to accept the new value. The User Environment Variables list now
contains the new value for this variable.
7. To delete the variable, click on the Delete button. The variable will no longer appear in the User
Environment Variables list.
8. To edit the values of other variables, continue the same process as above. When complete, click
on OK to accept the changes and to overwrite the ee.cfg file. Click on Cancel to disregard any
changes.
572
________________ Glossary
Glossary
absolute path name The sequence of directories, beginning with the root directory (/) that
locates a file. See also path name and relative path name.
active depth The plane in a 3-D design upon which you can place elements and perform
manipulations.
active process The process which is displayed in the Process ID field; it controls the
message fields, the menus, and the keyboard. The active process has a
highlighted window icon strip.
application software Software designed to meet specific needs, unlike system software which
runs other software.
batch processing A method of processing data which collects a series of operations into a
group (or ‘‘batch’’) and executes the group in a continuous stream without
user intervention.
batch queue A queue, or channel for moving requests, created through NQS. A batch
queue handles scheduling for processes submitted through the Batch
options screen menu.
branch point A point on a pipeline which separates piping segments so that they can be
assigned different segment parameters. A branch point allows for
placement of branch components.
cancel button The button located in the upper right corner of a form containing a red X or
the word cancel. Select the cancel button to exit the form or option.
N: EE Configure
cell A permanent association of elements that can be stored and placed as a
group, and then manipulated as individual elements.
confirm button A button that appears in the upper right corner of a form and contains a
green check mark or the word confirm. Select the confirm button to initiate
a specified option.
573
________________
EE Raceway Modeling Reference Guide - February 2003
coordinate system A geometric relation used to denote the location of points in the design
cube. The most common coordinate system is the rectangular coordinate
system, whereby points are located by traversing the X, Y, and Z axes of the
design cube. Normally, coordinate systems have their origin defined as
0,0,0, though this is not required. Other coordinate systems are used to more
easily express the coordinates of specific geometric entities. For example,
you can use a spherical coordinate system to help define points on a sphere,
and you can use a cylindrical coordinate system to help define points on a
cylinder.
coordinates An ordered set of absolute or relative data values that specify a location in a
coordinate system.
core files The image files written by System V for a number of reasons, the most
common of which are memory violations, illegal instructions, bus errors,
and user-generated quit signals.
cursor The pointer that the user moves on the screen to indicate an item or area.
data button The mouse button used to place data points and tentative points, to accept
previously selected elements, and to select commands from forms and
menus.
data entry field The field on a screen used to accept user-supplied data. Also known as
key-in field.
data point A point placed by pressing the data button on the mouse. Data points select
commands from the panel menus and Menu Bar, place elements, identify
and accept elements, and activate windows and perform window
manipulations.
database table The part of the database that is made of rows and columns and contains
information about the project and design elements.
574
________________ Glossary
display-list box A small box with horizontal dashes located at the end of a form key-in field.
When selected, a list of the data available for that field is displayed. Input
can then be selected from the list with a data point instead of keying in the
information.
dragging Another term for the dynamic function that attaches the cursor to an element
so you can see it move.
easting A term used in plane surveying that describes an east, or positive, difference
in longitude.
entity An object (project, drawing, element, and so forth.) of interest about which
information is stored; a relational database table.
file specification A path name that tells the system where to locate a file.
filename A user-defined name given to an interactively created file. The name should
be relevant to the contents of the file.
form An interface or screen menu designed with the I/FORMS product. Because
many of the screen menus in the application software are built with
I/FORMS, you must have the FORMS_S product on your workstation.
full path name The name of the entire path or directory hierarchy to a file, including the file
name. See also relative path name.
N: EE Configure
gadget A portion of a form, such as a button, a field, or a checklist, that responds to
information. Gadgets can display default values or act as data entry areas.
header The first items of information in a file which precede any actual data. The
header contains information on the structure and contents of the file.
575
________________
EE Raceway Modeling Reference Guide - February 2003
invert elevation The lowest point on the internal diameter of the pipe.
key-in field The field on a screen used to accept user-supplied data. Also known as a
data entry field.
menubar The strip at the top of the screen that contains icons for selecting
commands.
message area The area that appears in the MicroStation Command Window when you are
working in a design file. It is divided into the Command Status field, the
Current Command field, the Prompt field, and the Key-in field.
NFS Network File System, the system that provides access to data that is
distributed among machines through an interconnection of host computers
and workstations. NFS allows you to mount a remote resource to your local
workstation so you can access the data as though it were local. NFS is
usually used to access centralized data on a server.
node address The hard-wired Ethernet address assigned to each node when it is
manufactured. It is necessary for each node to identify and communicate
with another node in the network.
node name A name, or alias, that can be assigned to the node address of a device on a
network.
northing A term used to describe a north coordinate location in the plant coordinate
system.
576
________________ Glossary
nozzle A special equipment modeling primitive that contains the connection point
to piping. This point does NOT include a gasket allowance, but rather
represents the face-of-flange coordinate.
NQS Network Queuing System, the software package that allows you to define
network-wide batch and device queues. Use of NQS involves setting up
local resource queues on the system(s) where the resources reside and
setting up ‘‘pipe queues’’ on the systems that are to have access to the
resources.
origin In coordinate geometry, the point where the x, y, and z-axes intersect.
orthogonal view A view which is a projection of the model onto a plane along lines which
are orthogonal to the plane.
path name The sequence of directories leading to a file. See also absolute path name
and relative path name.
pipe queue A controlled channel for moving requests to batch or device queues on
remote systems and for receiving status and/or data in response.
N: EE Configure
place data point To identify a specific element, or indicate a specific point in the design file.
plane A spatial element in geometry that may or may not have a boundary, but is
level, having no elevations or depressions, and is three-dimensional.
relative path name The sequence of directories leading from the current directory to a particular
file. See also path name and absolute path name.
577
________________
EE Raceway Modeling Reference Guide - February 2003
row A unit of related information in a table. One collection of column values for
a table.
rubberbanding The animation dynamic that enables you to specify the position of a data
point while the element changes as you move the cursor.
schema file A file that outlines the overall logical structure of a rule base or a database.
server In network operations, the node which maintains common data or performs
a common task needed by clients. All network operations (database, NFS,
NQS) between two or more nodes establish a client/server relationship.
Structured Query Language developed by IBM for creating, modifying, and querying
Language SQL relational databases.
symbology The display style of an element, including color, style, and weight.
table A collection of data for quick reference, either stored in sequential locations
in memory or printed as an array of rows and columns of data items of the
same type.
values Data, either entered by the user or determined by the software, that are
stored in an attribute.
view The defined area of vision on a screen. A view allows you to see a
prescribed volume of the design cube. Views are created with their own x,
y, and z axes. The x,y plane of the view is parallel to the screen, while the
z-axis can be thought of as coming straight out of the view towards you.
The view axes maintain this relationship regardless of the rotation with
respect to the design cube. See also active depth.
virtual memory External memory for a computer that can be used as if it were an extension
of the computer’s internal memory. The software uses virtual memory to
store data. This means that unneeded files and data, stay on the disk until
they are called for. Because the internal processing memory stores a
minimal amount of data, the software can perform processing more quickly.
578
________________ Glossary
working directory The directory from which you are accessing files.
N: EE Configure
579
________________
EE Raceway Modeling Reference Guide - February 2003
580
________________ Index
Index
A annot_form 529
access column 179, 234, 290 application
activate manager information 27, 109, 415, 425
design volume coordinate system 320 approval status codelist 432
plant coordinate system 320 archive
active form 46
angle 256 option 86
one-line type parameters archive project
access column 290 network protocol
clear 291 TCP/XNS 46
display toggle 290 remote node name/address 46
list column 290 asid id
override 291 display 316
save to memory 289 highlight 309
select 290 assign 522, 527
parameters 146 attributes
point default 430
coordinates display 121 setting raceway 256
define 145 automatic
active coordinate system 320 fit 151
add propagation 298
query 568 size 151
systems 245
airway B
place 132 background 522
alias.cmd 529, 539 bar commands
alter palette 98
schema form 556 basic
N: EE Configure
table form 559 concepts
angle database 115
active 256 drawing 108
annotate propagation 113
element 178 setup 27, 110
access column 179, 234 workstation skills 26
by group 233 batch 522
clear button 180, 235 bill of materials 549
display toggle 179, 234 by volume 72, 327, 550
list column 179, 234 bin/ 521, 527
override button 180, 235 blank part ids 552
override keys 179, 234
select button 180, 235 C
source column 179, 234 cable
model 285 code codelist 439
one-line 178, 233 color codelist 441
RCP 178 configuration codelist 440
insulation type codelist 444
581
________________
EE Raceway Modeling Reference Guide - February 2003
582
________________ Index
N: EE Configure
current row box 567 RCP 214
delete all 568 design
edit query 567 commands 129
initialize query 567 conduit sizing 155
insert row 568 define duct cross section 164
process query 567 file
review 568 command menu bar 96
toggle 568 insert one-line vertex 160
update active 568 insert RCP 138
load 323, 332 option 63
batch file 335 palette 99
palette 102 place
procedures 427 drop point 142
project 115 equipment pointer 144
reference 115 manual fitting 147
relational 427 one-line 132
report 326 rotate cross section 140
rule checks 329 route around vessel 135
setup 33 set
583
________________
EE Raceway Modeling Reference Guide - February 2003
584
________________ Index
N: EE Configure
display information 301 password 565
highlight purge 81
by asid id 309 rway.cmd 543
by link 312 seed
by sector/word 307 English 528
identifying 103 metric 528
modify commands 173 structure
modifying 175 EE
move 186 nucleus 520
placing 129 EE raceway 524
propagate 194 fittings 195, 512
by group 241 delete 216
type edit/insert manual fitting 198
display 316 environment rules 446
engineering place by rule 207
units 267 by group 243
enter place manual fitting 147
menu 40 floppy/network toggle 86
585
________________
EE Raceway Modeling Reference Guide - February 2003
G J
graphic joints
symbology 262, 264, 266 minimize 219
graphics environment by group 248
palettes 97
group K
annotate 233 key-ins
copy 231 precision 104, 119
define 226 keys 430
delete 251 drop point 431
minimize joints 248 equipment pointer 431
propagate 241 one-line 430
override 115
H RCP 431
help_graphics 528
help_rway.hp 528 L
help_rway.s 528 levels
help_source/ 528 set active 299
highlight library
element cell 269, 271
by asid id 309 eden symbol 353, 357, 359, 361
by link 312 eden user function 363
by sector/word 307 eden user functions 355
propagation errors 314 link
horizontal spacing 165 display 317
highlight 312
I list
identifying column 179, 234, 290
elements 103 eden symbol library 353
IGDS toggle 83 user functions 355
increase size only 157 load 527
increase/decrease size 157 database 323, 332
information about elements 301 batch file 335
initialize query 157, 567 lock model 282
input
precision 119 M
insert main form
one-line vertex 160 EE
RCP 138 archive 46
row 568 restore 48
586
________________ Index
N: EE Configure
messages by group 241
display fields 93 reference schema 451
error 377 remove RCP 214
MicroMenu umenu 543 replace systems by group 246
midpoint modify element
on segment 123 palette 98
minimize form 120 modify group
minimize joints 219 palette 100
by group 248 move
model element 186
annotate 285 model annotation 283
move annotation 283 move/move to toggle 121
commands 280 one-line segment 190
using 281 one-line vertex 192
create model cell 271 mscrecol.sh 522
lock 282 msg/ 523, 529
unlock 284 mslink
model commands display 317
palette 101 highlight 312
587
________________
EE Raceway Modeling Reference Guide - February 2003
msseed.dgn 528 P
mstr_rway.hp 528 palettes
mstr_rway.s 528 bar commands 98
database 102
N design 99
network/floppy toggle 86 EERWAY 97
new users Integrated Commands 97
database preparation 427 MicroStation commands 98
nucleus model commands 101
file structure 520 modify 99
modify element 98
O modify group 100
one-line runtime setup 101
annotate 233 setup commands 100
changing sizes 178, 233 utilities 102
delete parameters
duplicates 211 active 111
vertex 217 active angle 256
insert vertex 160 color 256
keys 430 one-line type 289
modify route 204 access column 290
move segment 190 clear 291
move vertex 192 display toggle 290
place 132 list column 290
route around vessel 135 override 291
type override keys 290
codelist table 434 save to memory 289
define 260 select 290
display 318 propagation 297
parameters 289 raceway 256
access column 290 set active 146, 289
clear 291 part verification 297
display toggle 290 password
list column 290 echo toggle 46, 48, 52, 55
override 291 file 565
override keys 290 PCS 320
save to memory 289 PDS
select 290 reference model from 372
priority 434 review attributes 371
set active 294 review clash 375
types 110 window to named PDS item 374
output option 89 percent fill 157
override percentage of raceway
button changing 221
annotate element 180, 235 place
keys 115, 179, 234, 290 drop point 142
one-line type equipment pointer 144
parameters 291 field routed raceway 161
setting 263 fitting by rule 207
by group 243
manual fitting 147
588
________________ Index
N: EE Configure
unload insert 138
design 336 keys 431
sheet 338 type
processing toggle 53, 55, 65 codelist table 435
processor weight 257
file 513 README 521, 527
product receive
menu 42 option 84
removal 521, 527 reduce run 125
product.def 521, 527 reducers 195
project reeprj 522
database 115 reference
schema description 487 database 115
drawing list 547 schema description 454
schema guide 25
general description 448 schema 510
update 449 description 430
prompt.msg 529 modifying 451
updating 449
589
________________
EE Raceway Modeling Reference Guide - February 2003
590
________________ Index
N: EE Configure
conduit sizing attributes 268 stub up 167
defaults 256 subsystems 295
symbology control 262 sym/ 523, 529
text defaults 266 symbol
setup eden
commands 253 compile 349
conduit sizing attributes 268 compress 359
create cell 269 delete 351
define extract 361
one-line type 260 list library 353
system 258 merge libraries 357
lock model 282 file
model 280 edit eden 366
model annotation 285 generation 513
move 283 example 514
propagation 297 processor file 513
set symbology 110
raceway defaults 256 changing 264
symbology control 262 control 264
591
________________
EE Raceway Modeling Reference Guide - February 2003
592
________________ Index
utilities (continued) X
review PDS clash 375 XNS/TCP toggle
schema 51 archive project 46
toggle construction display on/off 306
window to named PDS item 374
V
vendor
codelist table 438
specification 507
vertical spacing 165
vessel
routing around 135
volume
bill of materials 72, 327, 550
W
weight
RCP 257
window to named PDS item 374
wire
code codelist 439
color codelist 441
configuration codelist 440
insulation type codelist 444
size codelist 440
voltage codelist 443
wireway
place 132
workflow 107
databases 115
drawing process 108
N: EE Configure
drawing setup 110
eden symbol generation 513
one-line types 110
parameters 111
place one-line 112
propagation 113
propagation parameters 111
reports 117
setup 109, 110
symbology 110
systems 110
working
units 104
workstation
skills 26
upgrading 28
wyes 195
593
________________
EE Raceway Modeling Reference Guide - February 2003
594
EE Raceway Modeling
Reference Guide Addendum
February 2003
DPDS3-PB-200005C
For PDS version 07.02.00.**
Table of Contents
PDS Electrical Raceway Environment .................................................................... 597
Modeling......................................................................................................................... 598
Load Reference Schema ................................................................................................. 599
Utilities ........................................................................................................................... 601
Palettes in the EE Raceway Graphics Environment (replaces 5.4).......................... 602
Modify Element Commands (replaces 9.2) ............................................................. 607
Rotate Element................................................................................................................ 609
Rotate Copy Element...................................................................................................... 611
Mirror Element ............................................................................................................... 613
Mirror Copy Element...................................................................................................... 615
Modify Group Commands (replaces 9.3) ................................................................ 617
Rotate Group................................................................................................................... 619
Rotate Copy Group ......................................................................................................... 621
Mirror Group .................................................................................................................. 623
Mirror Copy Group......................................................................................................... 625
Move Group.................................................................................................................... 627
Annotate Model........................................................................................................ 628
Reference PDS Model (replaces 16.2)..................................................................... 629
EE Raceway Project Database Schema Description (replaces panel) ..................... 631
EE File Structure (replaces Appendix F) ................................................................. 633
EE Nucleus File Structure .............................................................................................. 634
EE Raceway File Structure............................................................................................. 637
596
PDS Electrical Raceway Environment
When you select the Electrical Raceway Environment command on the PD_Shell form,
the EE Raceway Environment form displays.
Commands
Modeling – Allows you to open a design file in the PDS Raceway modeling
environment.
Load Reference Schema – Allows you to update the Raceway reference schema.
Utilities – Allows you to access EE Raceway commands for EE Raceway processes,
EDEN symbols, reporting, and rule checks.
597
EE Raceway Modeling Reference Guide Addendum – February 2003
Modeling
This option allows you to select a design file to open in the modeling environment.
Steps
1. Select a design area from the list.
2. Click Accept.
The Raceway Designer form displays.
3. Select a model from the list.
4. Click Accept.
The selected model displays in MicroStation.
598
Load Reference Schema
This option allows you to update the reference schema for the active project. You can
use this command to update an existing empty RIS schema with EE tables and default
information, or to modify the tables in an existing RIS schema to conform to the structure
of a given .sql file. If you update the schema with a .sql file that has a different structure
from the original .sql file, the command makes the following changes:
— Adds new tables listed in the .sql file.
— Modifies existing tables if the definition of that table has changed in the .sql file. The
process replaces the old table definition with the new table definition, keeping
column data where column names match.
— Load those tables that have unique index numbers with data from the .unl files that
are listed in the .cmd files. If a table lacks a unique index, the process loads it only if
the table is empty.
Field Descriptions
Reference Schema – Specifies the reference schema for the active project.
SQL File Network Address – Specifies the network address of the SQL file
containing the correct table and column structure.
SQL File Path – Specifies the file path of the SQL file containing the correct table
and column structure.
SQL Filename – Specifies the file name of the SQL file containing the correct table
and column structure.
CMD File Network Address – Specifies the network address of the CMD file that
defines which .unl files to load into which tables.
599
EE Raceway Modeling Reference Guide Addendum – February 2003
CMD File Path – Specifies the file path of the CMD file that defines which .unl files
to load into which tables.
CMD Filename – Specifies the file name of the CMD file that defines which .unl
files to load into which tables.
600
Utilities
This option accesses the EE Raceway Process, EDEN, Report, and Rule commands.
Commands
Process – This command accesses all available EE Raceway processes. These
processes allow you to manipulate drawings and the project database. Refer to
sections 4 and 14 of the EE Raceway Reference Guide for more information on this
command.
EDEN – This command allows you to design and maintain your own symbols for
Raceway elements. Refer to sections 4 and 15 of the EE Raceway Reference Guide
for more information on this command.
Report – This command accesses the standard EE Raceway reports. These reports
contain information on the project and reference databases. Refer to section 4 and
Appendix J of the EE Raceway Reference Guide for more information on this
command.
Rule – This command accesses the standard EE Raceway Rule Checks. These rule
checks are reports that identify violations of certain design rules by working on the
project database. Refer to section 5 and Appendix J for more information on this
command.
601
EE Raceway Modeling Reference Guide Addendum – February 2003
This section presents the palettes that are used in the EE Raceway graphics environment.
Palettes are groups of commands that are accessible from the EERWAY command menu
bar on the MicroStation command window. This section presents the palettes in the order
that they are accessible if you look at each menu going from left to right across the
EERWAY command menu bar on the MicroStation command window.
Next to each icon is the name of the form or command it represents. You should become
familiar with the name and functionality of each command on each palette. Each
command is described in full in later sections of this text.
EERWAY
This palette is activated by selecting File from the MicroStation command window, then
selecting EERWAY from the resulting menu.
Integrated Commands
This palette is activated by selecting File from the MicroStation command window, then
selecting Integrated Commands > Palette from the resulting menu.
602
Bar Commands
This palette is activated by selecting File from the MicroStation command window, then
selecting Bar Commands from the resulting menu. This palette contains the
MicroStation commands as discussed in the MicroStation documentation.
Modify Element
This palette is activated by selecting Modify Element from the EERWAY palette, or it
can be activated by selecting Modify Element from the Modify palette as shown later in
this section.
This palette can also be activated by selecting Modify from the MicroStation command
window, then selecting Modify Element Commands from Modify menu, then selecting
Palette.
603
EE Raceway Modeling Reference Guide Addendum – February 2003
Design
This palette is activated by selecting Design from the MicroStation command window,
then selecting Palette from the resulting menu.
Modify
This palette is activated by selecting Design from the MicroStation command window,
then selecting Modify from the resulting menu.
604
Modify Group
This palette is activated by selecting Modify Group from the Modify Palette. You can
also activate this palette by selecting Modify from the MicroStation command window,
then selecting Modify Group Commands, then selecting Palette.
Setup Commands
This palette is activated by selecting Setup from the MicroStation command window,
then selecting Palette.
605
EE Raceway Modeling Reference Guide Addendum – February 2003
Model Commands
This palette is activated by selecting Model Commands from the Setup Commands
palette.
Runtime Setup
This palette is activated by selecting Runtime from the MicroStation command window,
then selecting Palette.
606
Modify Element Commands (replaces 9.2)
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (pp 181-182 in the PDS
7.1 version of the document).
The following information has been modified:
• Rotate, Rotate Copy, Mirror, and Mirror Copy commands
See the following text for details.
The Modify Element palette is activated by selecting the Modify Element command
from the Modify palette, or by selecting Modify from the EERWAY Command Menu
Bar, then selecting Modify Element Commands, then selecting Palette.
The Modify Element commands manipulate individual elements, including RCPs, one-
lines, and three-lines, within the design file. You can use individual commands to move,
copy, and delete specified elements, to review or edit element annotation, and to check
for duplicate one-lines and coincident RCPs in the design file. Modify Element
commands also allow you to propagate one-lines in your raceway model.
Note: Do not use MicroStation commands to manipulate or modify EE Raceway
elements (one-line, three-lines, annotation, and so forth). Doing so will cause
serious problems and/or destroy the EE Raceway model. Use only these EE
Raceway modify commands to manipulate EE Raceway elements.
Annotate Element — Places, reviews, and edits intelligent annotation for raceway
elements.
Copy Element — Copies an element as specified within the design file.
Move Element — Moves an element to a specified location in the design file.
Clone Element — Copies an element multiple times in the same direction.
607
EE Raceway Modeling Reference Guide Addendum – February 2003
608
Rotate Element
This command rotates individual raceway elements as specified within the design file.
You can use this command to move one-lines, RCPs, drop points, equipment pointers,
and annotation. If an RCP is rotated, all attached one-lines will be rerouted to the new
position of the RCP. All associated annotation, three-line fittings, and equipment
pointers will also be moved.
If a one-line is rotated, all attached RCPs will be moved and all attached one-lines will be
rerouted to the new one-line position. All associated annotation, three-line fittings, and
equipment pointers will also be moved.
Field Descriptions
Rotation Point – Displays the location of the rotation point.
Plan View – Specifies the angle at which to rotate the element on the plan view
plane. The selected elements are rotated about the up-down axis passing through the
rotation point.
East Elevation – Specifies the angle at which to rotate the element on the east
elevation plane. The selected elements are rotated about the east-west axis passing
through the rotation point.
North Elevation – Specifies the angle at which to rotate the element on the north
elevation plane. The selected elements are rotated about the north-south axis passing
through the rotation point.
Angle – Key-in field used to specify the angle for each plane. To change the angle,
click the button for the plane and type the angle in the Angle field.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
609
EE Raceway Modeling Reference Guide Addendum – February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Rotate Element command.
The Rotate Element precision input form displays.
2. Identify the element you intend to rotate and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable
element, the system displays the message Element not found. The message
disappears when you identify a valid element.
3. Specify the point around which to rotate the element.
The Specify Rotation form displays.
4. Specify the planes and angles at which to rotate the element.
5. Click Accept.
The element rotates to the specified position.
610
Rotate Copy Element
This command creates rotated copies of individual raceway elements as specified within
the design file. You can use this command to copy and rotate one-lines and their
associated elements.
Field Descriptions
Rotation Point – Displays the location of the rotation point.
Plan View – Specifies the angle at which to rotate the element on the plan view
plane. The selected elements are rotated about the up-down axis passing through the
rotation point.
East Elevation – Specifies the angle at which to rotate the element on the east
elevation plane. The selected elements are rotated about the east-west axis passing
through the rotation point.
North Elevation – Specifies the angle at which to rotate the element on the north
elevation plane. The selected elements are rotated about the north-south axis passing
through the rotation point.
Angle – Key-in field used to specify the angle for each plane. To change the angle,
click the button for the plane and type the angle in the Angle field.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
611
EE Raceway Modeling Reference Guide Addendum – February 2003
Steps
1. Select the Rotate Copy Element command.
The Rotate Copy Element precision input form displays.
2. Identify the element you intend to rotate and copy and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable
element, the system displays the message Element not found. The message
disappears when you identify a valid element.
3. Specify the point around which to rotate the element.
The Specify Rotation form displays.
4. Specify the planes and angles at which to rotate the element.
5. Click Accept.
The element copy displays at the specified position.
612
Mirror Element
This command flips individual raceway elements about a point as specified within the
design file. You can use this command to mirror one-lines, RCPs, drop points,
equipment pointers, and annotation. If an RCP is rotated, all attached one-lines will be
rerouted to the new position of the RCP. All associated annotation, three-line fittings,
and equipment pointers will also be moved.
If a one-line is mirrored, all attached RCPs will be moved and all attached one-lines will
be rerouted to the new one-line position. All associated annotation, three-line fittings,
and equipment pointers will also be moved.
Field Descriptions
Mirror Point – Displays the location of the specified mirror point. The primary
vector of the orientation tee denotes the mirror plane’s normal vector. The elements
are rotated about the plane formed by the secondary and the normal.
Angle – Specifies the angle by which to rotate the orientation tee. To change the
displayed angle, select the field and type a new angle.
About – Specifies the axis about which to rotate the orientation tee. To change the
displayed axis, toggle among the three axes (Primary, Secondary, Normal) until the
appropriate axis displays.
I Button – Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis,
and the Normal axis with the positive Z axis.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
613
EE Raceway Modeling Reference Guide Addendum – February 2003
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Mirror Element command.
The Mirror Element precision input form displays.
2. Identify the element you intend to mirror and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable
element, the system displays the message Element not found. The message
disappears when you identify a valid element.
3. Specify the point about which to mirror the element.
The Orient Mirror form displays.
4. Specify the mirror plane on which to mirror the element. The primary vector of the
orientation tee denotes the mirror plane’s normal vector.
5. Click Accept.
The element rotates to the specified position.
614
Mirror Copy Element
This command creates mirrored copies of individual raceway elements as specified
within the design file. You can use this command to copy and mirror one-lines and their
associated elements.
Field Descriptions
Mirror Point – Displays the location of the specified mirror point. The primary
vector of the orientation tee denotes the mirror plane’s normal vector. The elements
are rotated about the plane formed by the secondary and the normal.
Angle – Specifies the angle by which to rotate the orientation tee. To change the
displayed angle, select the field and type a new angle.
About – Specifies the axis about which to rotate the orientation tee. To change the
displayed axis, toggle among the three axes (Primary, Secondary, Normal) until the
appropriate axis displays.
I Button – Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis,
and the Normal axis with the positive Z axis.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Mirror Copy Element command.
The Mirror Copy Element precision input form displays.
615
EE Raceway Modeling Reference Guide Addendum – February 2003
2. Identify the element you intend to mirror and copy and accept it with <D>.
The system highlights the specified element. If you do not locate an acceptable
element, the system displays the message Element not found. The message
disappears when you identify a valid element.
3. Specify the point around which to mirror the element.
The Orient Mirror form displays.
4. Specify the plane on which to mirror the element. The primary vector of the
orientation tee denotes the mirror plane’s normal vector.
5. Click Accept.
The element copy displays at the specified position.
616
Modify Group Commands (replaces 9.3)
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (pp 229-230 in the PDS
7.1 version of the document).
The following information has been modified:
• Rotate, Rotate Copy, Mirror, Mirror Copy, and Move Group
commands
See the following text for details.
The Modify Group commands define and manipulate groups within a design file.
Groups are temporary associations of Raceway and other elements in your model. The
Modify Group commands allow you first to define a group of elements and then to
manipulate the group in part or as a whole.
The Modify Group palette is activated by selecting the Modify Group command from
the Modify palette, or by selecting Modify from the EERWAY Command Menu Bar,
then selecting Modify Group Commands, then selecting Palette.
You can use individual Modify Group commands to move, copy, and delete elements of
specified groups, and to review or edit element annotation. You can also propagate one-
lines in a particular group using these commands.
Note: Do not use MicroStation commands to manipulate or modify EE Raceway
elements (one-line, three-lines, annotation, and so forth). Doing so will cause
serious problems and/or destroy the EE Raceway model. Use only these EE
Raceway modify commands to manipulate EE Raceway elements.
617
EE Raceway Modeling Reference Guide Addendum – February 2003
Topics
Define Group — Identifies raceway elements for inclusion in a particular group.
Copy Element by Group — Copies within the design file some or all elements of a
specified group.
Annotate Element by Group — Places, reviews, and edits intelligent annotation for
raceway elements within a specified group.
Clone Group — Copies a group multiple times in the same direction.
Propagate Element by Group — Expands some or all one-line elements of a
specified group into three-dimensional elements.
Place Fitting by Rule Group — Places non-standard fittings using a set of rules
defined in the reference database.
Add Systems Group — Defines multiple systems for a single one-line.
Replace Systems Group — Changes the defined active system type of a one-line.
Minimize Joints by Group — Reduces to a minimum the number of vertices of
some or all one-lines in a specified group.
Delete Element by Group — Removes from the design file some or all elements of a
specified group.
Rotate Group – Rotates some or all elements of a specified group to a new location
in the design file.
Rotate Copy Group – Copies and rotates some or all elements from a specified
group to a new location in the design file.
Mirror Group – Mirrors some or all elements from a specified group to a new
location in the design file.
Mirror Copy Group – Copies and mirrors some or all elements from a specified
group to a new location in the design file.
Move Group – Moves some or all elements from a specified group to a new location
in the design file.
618
Rotate Group
This command rotates a group of raceway elements as specified within the design file.
You can use this command to move one-lines, RCPs, drop points, equipment pointers,
and annotation. If an RCP is rotated, all attached one-lines will be rerouted to the new
position of the RCP. All associated annotation, three-line fittings, and equipment
pointers will also be moved.
If a one-line is rotated, all attached RCPs will be moved and all attached one-lines will be
rerouted to the new one-line position. All associated annotation, three-line fittings, and
equipment pointers will also be moved.
Field Descriptions
Rotation Point – Displays the location of the rotation point.
Plan View – Specifies the angle at which to rotate the group on the plan view plane.
The selected elements are rotated about the up-down axis passing through the rotation
point.
East Elevation – Specifies the angle at which to rotate the group on the east elevation
plane. The selected elements are rotated about the east-west axis passing through the
rotation point.
North Elevation – Specifies the angle at which to rotate the group on the north
elevation plane. The selected elements are rotated about the north-south axis passing
through the rotation point.
Angle – Key-in field used to specify the angle for each plane. To change the angle,
click the button for the plane and type the angle in the Angle field.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
619
EE Raceway Modeling Reference Guide Addendum – February 2003
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Rotate Group command.
The Rotate Group precision input form displays.
2. Identify the group you intend to rotate and accept it with <D>.
The system highlights the specified group. If you do not locate an acceptable group,
the system displays the message Group not found. The message disappears when you
identify a valid group.
3. Specify the point around which to rotate the group.
The Specify Rotation form displays.
4. Specify the planes and angles at which to rotate the group.
5. Click Accept.
The group rotates to the specified position.
Note: These steps are applicable for groups in Entire Group mode. For groups in Single
Element mode, you can accept or reject constituent elements and set the rotation
point and planes for each accepted element.
620
Rotate Copy Group
This command creates a rotated copy of a group of raceway elements as specified within
the design file.
Field Descriptions
Rotation Point – Displays the location of the rotation point.
Plan View – Specifies the angle at which to rotate the group on the plan view plane.
The selected elements are rotated about the up-down axis passing through the rotation
point.
East Elevation – Specifies the angle at which to rotate the group on the east elevation
plane. The selected elements are rotated about the east-west axis passing through the
rotation point.
North Elevation – Specifies the angle at which to rotate the group on the north
elevation plane. The selected elements are rotated about the north-south axis passing
through the rotation point.
Angle – Key-in field used to specify the angle for each plane. To change the angle,
click the button for the plane and type the angle in the Angle field.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Rotate Copy Group command.
621
EE Raceway Modeling Reference Guide Addendum – February 2003
622
Mirror Group
This command flips a group of raceway elements about a point as specified within the
design file. If an RCP is rotated, all attached one-lines will be rerouted to the new
position of the RCP. All associated annotation, three-line fittings, and equipment
pointers will also be moved.
If one-lines are mirrored, all attached RCPs will be moved and all attached one-lines will
be rerouted to the new one-line position. All associated annotation, three-line fittings,
and equipment pointers will also be moved.
Field Descriptions
Mirror Point – Displays the location of the specified mirror point. The primary
vector of the orientation tee denotes the mirror plane’s normal vector. The elements
are rotated about the plane formed by the secondary and the normal.
Angle – Specifies the angle by which to rotate the orientation tee. To change the
displayed angle, select the field and type a new angle.
About – Specifies the axis about which to rotate the orientation tee. To change the
displayed axis, toggle among the three axes (Primary, Secondary, Normal) until the
appropriate axis displays.
I Button – Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis,
and the Normal axis with the positive Z axis.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
623
EE Raceway Modeling Reference Guide Addendum – February 2003
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Mirror Group command.
The Mirror Group precision input form displays.
2. Identify the group you intend to mirror and accept it with <D>.
The system highlights the specified group. If you do not locate an acceptable group,
the system displays the message Group not found. The message disappears when you
identify a valid group.
3. Specify the point about which to mirror the group.
The Orient Mirror form displays.
4. Specify the mirror plane on which to mirror the group.
5. Click Accept.
The group moves to the specified position.
Note: These steps are applicable for groups in Entire Group mode. For groups in Single
Element mode, you can accept or reject constituent elements and set the mirror
point and mirror plane for each accepted element.
624
Mirror Copy Group
This command creates a mirrored copy of a group of raceway elements as specified
within the design file.
Field Descriptions
Mirror Point – Displays the location of the specified mirror point. The primary
vector of the orientation tee denotes the mirror plane’s normal vector. The elements
are rotated about the plane formed by the secondary and the normal.
Angle – Specifies the angle by which to rotate the orientation tee. To change the
displayed angle, select the field and type a new angle.
About – Specifies the axis about which to rotate the orientation tee. To change the
displayed axis, toggle among the three axes (Primary, Secondary, Normal) until the
appropriate axis displays.
I Button – Reorients the orientation tee along the identity matrix. It realigns the
Primary axis with the positive X axis, the Secondary axis with the positive Y axis,
and the Normal axis with the positive Z axis.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Mirror Copy Group command.
The Mirror Copy Group precision input form displays.
625
EE Raceway Modeling Reference Guide Addendum – February 2003
2. Identify the group you intend to mirror and copy and accept it with <D>.
The system highlights the specified group. If you do not locate an acceptable group,
the system displays the message Group not found. The message disappears when you
identify a valid group.
3. Specify the point around which to mirror the group.
The Orient Mirror form displays.
4. Specify the plane on which to mirror the group.
5. Click Accept.
The group copy displays at the specified position.
Note: These steps are applicable for groups in Entire Group mode. For groups in Single
Element mode, you can accept or reject constituent elements and set the mirror
point and mirror plane for each accepted element.
626
Move Group
This command moves a group of raceway elements to a new location in the design file.
Before Using This Command
You can enter all values for the placement of points through a precision input form.
Using the form, you can locate elements, route one-lines, accept input, reject input, reset
a command action, and exit a command. You must be familiar with precision input and
its functions before using this command. For detailed information about precision input,
see Precision Input Form.
At any point during this operating sequence, you can exit the command session either by
pressing <Esc> or by selecting Cancel (X) on the precision input form. To reset a
command action by one step or to reject a highlighted element, press <R> or select
Reject on the precision input form.
Steps
1. Select the Move Group command.
The Move Group precision input form displays.
2. Identify the group you intend to move and accept it with <D>.
The system highlights the specified group. If you do not locate an acceptable group,
the system displays the message Group not found. The message disappears when you
identify a valid group.
3. Specify an origin point from which to move the group.
4. Specify a placement point to which to move the group.
The group moves to the specified position.
627
EE Raceway Modeling Reference Guide Addendum – February 2003
Annotate Model
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (p. 285 in the PDS 7.1
version of the document).
The following information has been modified:
• Automatic sheet number
See the following text for details.
This command adds or changes the annotation for the model. This command cannot
prevent the duplication of sheet numbers within a project. The Load Database process,
however, will prevent such duplication. The sheet number should be unique for each
drawing. If the user does not specify a sheet number, the sheet number is automatically
set to match the .dgn file name of the raceway model.
Steps
1. Select the Annotate Model command.
The Annotate Element form displays.
2. Select the Column value field for sheet on the form and key in a new sheet number.
If you want to display the annotation in the model, toggle the Display fields in the
form to On.
3. Select Confirm to accept the new annotation.
—OR —
Select Cancel (X) to exit the command without saving your changes.
4. If you toggled Display to On, you are prompted to place the annotation in the model.
628
Reference PDS Model (replaces 16.2)
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (pp 372-373 in the PDS
7.1 version of the document).
The following information has been modified:
• Display, Snap, and Locate toggles
See the following text for details.
The Reference PDS Model command attaches and detaches models from the PDS
project to the model as reference files. The model to attach can be from any discipline
and design area in the project.
Parameters
Disciplines – Lists all disciplines. Select the discipline that contains the model you
want to attach; then, click Attach.
Areas – Lists all design areas defined in the active project. Select the design area that
contains the model you want to attach; then, click Attach.
Area/Model – Specifies whether to attach all models in a design area or an individual
model.
— Attach by Area – Attaches all model in the selected design area.
— Attach by Model – Displays all models in the design area so you can select
which model you want to attach.
Propagated/Sparse – Specify whether you want to attach the sparse model or the
corresponding propagated model. This option only displays if you are attaching a
structural model.
Display Toggle – Specify whether to display the reference model in the active model
views.
Snap Toggle –Allows you to snap to any segment in the reference file.
629
EE Raceway Modeling Reference Guide Addendum – February 2003
Locate Toggle – Allows you to data point to any component in the reference file.
Apply To Discipline – Defines the settings for the Display, Snap, or Locate toggles
for the all attached models in the discipline of the selected model.
Apply To All – Defines the settings for the Display, Snap, or Locate toggles for all
the attached models in all disciplines.
Attach – Attaches a reference model. You must select a Discipline and a Design Area
before you can select a reference model to attach.
Detach – Detaches the selected reference model. You must click Show Attachments
and select the reference model you want to detach before clicking Detach.
Show Attachments – Displays all reference models attached to the active model.
Exit – Exits the Reference Model command.
630
EE Raceway Project Database Schema
Description (replaces panel)
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (pp 487 and 500 in the
PDS 7.1 version of the document).
The following information has been modified:
• PDS coordinates in Panel table
• Note about ee72upg.exe file
See the following text for details.
This section lists and describes the tables in the EE Raceway project database schema,
and includes detailed information about the columns that comprise each table.
Note: An asterisk (*) indicates that you must not modify the column name. You should
not modify those column names having a prefix of "ee_".
panel
This table contains information about all panels/equipment found in the drawing.
Note: For project databases created with EE Raceway versions prior to 7.2, it is
necessary to use the ee72upg.exe utility in the \eenuc\bin folder to add the new
pds_east, pds_north, and pds_elev columns to the panel and msconfig tables of
the existing project database. Before running the upgrade utility, use EE
Configure to verify that values are set for EERD_TBLS, PROJECT_LOCATION,
and EE_SCHEMA.
631
EE Raceway Modeling Reference Guide Addendum – February 2003
mslink: a unique integer value used by the software to identify a row in the panel table.
panel: the column containing the panel/equipment name
panel_descrip: the column containing the panel/equipment description.
ee_approv_status: the column containing the approval status of the panel/equipment.
ee_approv_date: the column containing the date when the approval status changed.
ee_create_date: the column containing the panel/equipment creation date.
ee_last_rev_dat: the column containing the date the panel/equipment was last revised.
ee_eqp_table: the column containing the name of the reference database table that
contains additional equipment information.
ee_part_key: the column containing the unique key to the appropriate record of
equipment information in the reference database table.
pds_east: the column containing the PDS east coordinate of the panel (calculated by
Load Database).
pds_north: the column containing the PDS north coordinate of the panel (calculated by
Load Database).
pds_elev: the column containing the PDS elevation coordinate of the panel (calculated by
Load Database).
632
EE File Structure (replaces Appendix F)
Note: The information in this section supersedes the information in the corresponding
section of previous versions of the EE Raceway Reference Guide (pp 529-540 in the PDS
7.1 version of the document).
The following information has been modified:
• Windows folder listings replace CLIX directory structure
See the following text for details.
This section describes the file structure for EE Nucleus and EE Raceway. It also
describes the contents of directories and some files. It identifies those files you can
modify.
By default, the PDS Component Loader delivers these files to /win32app/ingr/.
The directory tree for EENUC and EERWAY is shown below.
633
EE Raceway Modeling Reference Guide Addendum – February 2003
\eenuc\bin
\eenuc\data
\eenuc\db
\eenuc\doc
\eenuc\font
\eenuc\forms
634
\eenuc\help
\eenuc\msg
\eenuc\share
\eenuc\sym
The following list gives a brief description of some of the files. The files are grouped by
directory.
eenuc
— readme.txt – file containing description of product features and any fixes,
problems, comments, etc.
— remove.exe – command used to remove EE Nucleus from the machine.
— .EErc – File containing global symbol definitions.
— EEnotice.txt – File containing release notices.
— license.txt– copyright notice file.
bin – contains the EE executable files and the environment process. The EE
executable files set up variables specifying the location of MicroStation,
INFORMIX, EE Nucleus, and EE Raceway, and then invokes the EE
environment.
— background – process that reports the exit status of a process run in the
background.
— batch – process that reports the exit status of a process run in batch mode.
— create_db – create database process.
— dba_rpt – DBAccess report process.
— dba_shell.cmd – command executed around dba_rpt.
635
EE Raceway Modeling Reference Guide Addendum – February 2003
636
EE Raceway File Structure
This section lists and describes the directories and files delivered with EE Raceway.
\eerway
\eerway\bin
\eerway\data
\eerway\db
\eerway\dgn
637
EE Raceway Modeling Reference Guide Addendum – February 2003
\eerway\doc
\eerway\eden
\eerway\mdlapps
\eerway\msg
\eerway\report
\eerway\sym
\eerway\tmp
Delivered empty
The following list gives a brief description of some of the files. The files are grouped by
directory.
eerway
— readme.txt – file containing a description of the product features and any fixes,
problems, comments, etc.
638
— remove.exe – executable file used to remove EE Raceway from the machine.
bin – contains all process delivered with the EE Raceway product.
— idet – Interference Detection Envelope File Creation process.
— load – processor to load the project database.
— rmon – Controlling processor for interactive manipulations.
— unload_cln – contains the unload sheet, unload drawing, and clean database
processes.
data – Contains the ASCII files used to control process and report management for
the EE Raceway product. These files can be modified.
— eden.dat – controls Eden processes.
— process.dat – controls process management.
— report.dat – controls standard report management.
— rule_chk.dat – controls rule check report management.
db – Contains the delivered sql files for the project and reference database. Also
contains .unl files required for bulk loading special tables and the mscatalog table in
the project database.
Sample .unl files for bulk loading reference database tables are also provided.
dgn – Contains the seed file directory, available cell libraries, and any design files
delivered with the product.
— rway_schma.dgn – displays the structure of the EE Schema.
639
EE Raceway Modeling Reference Guide Addendum – February 2003
640
— seed – contains the available seed design files.
— seed.dgn – delivered English drawing seed file. This may be customized.
— msseed.dgn – delivered metric drawing seed file. This may be customized.
doc – contains documentation information on EE Raceway including README files
from previous releases.
eden – contains the Eden symbol library.
— eden.lib – the Eden symbol library file.
mdlapps
msg – Contains EE Raceway message files and the file to correlate key-ins to EE
Raceway commands.
— alias.cmd – file used to correlate key-ins to commands. This file can be extended.
— command.msg – message file containing all messages for the command field.
These messages can be edited but messages cannot be added.
— error.msg – message file containing all error messages for the error field. These
messages can be edited but messages cannot be added.
— prompt.msg – message file containing all messages for the prompt field. These
messages can be edited but messages cannot be added.
641
EE Raceway Modeling Reference Guide Addendum – February 2003
— rway_prj.tbl – file containing the entity numbers for the project database tables.
— rway_ref.tbl – file containing the entity numbers for the reference database tables.
— status.msg – message file containing messages for status field, prompting
messages, and logo. These messages can be edited but messages cannot be added.
report – Contains the source (.ace)and compiled (.arc) SQL files for all delivered sch
reports.
The source files may be edited by the user. There is an .ace and an .arc file for each
report listed below.
— rwaydba_lib – DB Access template library.
sym – Contains all symbol files for EE Raceway menus. This directory also contains
the available precision input forms.
— rwaybar.sym – symbol file for the bar menu.
— rwaypnl.sym – symbol file for the panel menu.
tmp – Holds any temporary files. The software requires this directory.
642
Index
annotate Mirror Group command, 624
model, 629 model
Annotate Model command, 629 annotate, 629
EE Modify Element commands, 608
file structure, 634 Modify Group commands, 618
Nucleus Move Group command, 628
file structure, 635 palettes
Raceway bar commands, 604
file structure, 638 design, 605
element EE Raceway, 602
mirror, 614 EERway, 602
mirror copy, 616 Intergrated Commands, 602
modify, 608 model commands, 607
rotate copy, 610, 612 modify, 605
file structure modify element, 604, 608
EE, 634 modify group, 606, 618
EE Nucleus, 635 runtime setup, 607
EE Raceway, 638 setup, 606
group PDS
mirror, 624 reference model, 630
mirror copy, 626 Reference PDS Model command, 630
modify, 618 reference schema
move, 628 load, 599
rotate, 620 Rotate Copy Element command, 612
rotate copy, 622 Rotate Copy Group command, 622
intergrated commands Rotate Element command, 610
Reference PDS Model, 630 Rotate Group command, 620
Load Reference Schema command, 599 schema
Mirror Copy Element command, 616 load reference, 599
Mirror Copy Group command, 626 utilities, 601
Mirror Element command, 614
643