pdms 11.5 installation guide

pdms1151/man1/doc1issue 010403

Installation GuideVersion 11.5

Windows 2000 and Windows XP

AVEVA Ltd, High Cross, Madingley Road, Cambridge CB3 0HB, UK

PLEASE NOTE:

AVEVA Solutions has a policy of continuing product development: therefore, theinformation contained in this document may be subject to change without notice.AVEVA SOLUTIONS MAKES NO WARRANTY OF ANY KIND WITH REGARD TOTHIS DOCUMENT, INCLUDING BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULARPURPOSE.While every effort has been made to verify the accuracy of this document, AVEVASolutions shall not be liable for errors contained herein or direct, indirect, special,incidental or consequential damages in connection with the furnishing, performance oruse of this material.

This manual provides documentation relating to products to which you may not haveaccess or which may not be licensed to you. For further information on which Productsare licensed to you please refer to your licence conditions.

Copyright 1991 through 2003 AVEVA Solutions Limited

All rights reserved. No part of this document may be reproduced, stored in a retrievalsystem or transmitted, in any form or by any means, electronic, mechanical,photocopying, recording or otherwise, without prior written permission of AVEVASolutions.The software programs described in this document are confidential information andproprietary products of AVEVA Solutions or its licensors.

For details of AVEVA's worldwide sales and support offices, see our website athttp://www.aveva.com

http://www.aveva.com/engineeringit/world/

VANTAGE PDMS Installation Guide contents-iVersion 11.5

Contents

1 Introduction.................................................................................................... 1-11.1 Contents of this Guide ........................................................................ 1-1

2 Hardware and Software Requirements........................................................ 2-12.1 Hardware............................................................................................. 2-1

2.1.1 Graphics Cards ...................................................................... 2-12.2 Software and Configuration ............................................................... 2-2

3 Installing PDMS ............................................................................................. 3-13.1 Basic Installation ................................................................................ 3-13.2 Uninstalling and Reinstalling ............................................................ 3-23.3 FLEXMAN License Manager ............................................................. 3-23.4 Remote Installation............................................................................. 3-2

4 Setting Up the Windows Environment......................................................... 4-14.1 Windows Control Panel ...................................................................... 4-14.2 Graphics Board Settings..................................................................... 4-24.3 Setting the License File Location....................................................... 4-24.4 PDMS Environment Variables ........................................................... 4-34.5 Running PDMS from a Command Prompt Window.......................... 4-54.6 Customising PDMS Start-Up ............................................................. 4-54.7 Plotting ................................................................................................ 4-7

5 Language Support......................................................................................... 5-15.1 Preparing Windows to Use Supported Languages ............................ 5-2

5.1.1 Windows 2000........................................................................ 5-25.1.2 Windows XP........................................................................... 5-2

5.2 Preparing PDMS to Use Latin-1, Latin-2 or Latin-Cyrillic Languages............................................................................................................. 5-3

5.3 Preparing PDMS to Use a Far Eastern Language ............................ 5-3

6 Running PDMS under Windows................................................................... 6-16.1 Spaces in Windows pathnames .......................................................... 6-16.2 Linking to Microsoft Excel.................................................................. 6-16.3 Windows Parameters .......................................................................... 6-2

Contents

contents-ii VANTAGE PDMS Installation GuideVersion 11.5

7 PDMS Projects............................................................................................... 7-17.1 The Sample Project............................................................................. 7-1

7.1.1 Copying Project SAM to Your User Area ............................. 7-17.1.2 Users and Teams in the Sample Project .............................. 7-27.1.3 MDBs in the Sample Project ................................................ 7-2

7.2 Creating PDMS Projects .................................................................... 7-37.2.1 The Sample Project and Your Own Projects ........................ 7-4

8 Installing AutoDRAFT ................................................................................... 8-18.1 Compatibility ...................................................................................... 8-18.2 The AutoDRAFT Software ................................................................. 8-18.3 Configuring AutoDRAFT with AutoCAD .......................................... 8-28.4 Installing and Configuring AutoCAD ................................................ 8-2

8.4.1 AutoCAD R2000i ................................................................... 8-38.4.2 AutoCAD R2002 .................................................................... 8-3

8.5 Getting Started with AutoCAD.......................................................... 8-48.6 Application Macros for Use with PDMS DRAFT .............................. 8-4

9 Upgrading Projects to Version 11.5............................................................. 9-1

10 Troubleshooting...........................................................................................10-110.1 General...............................................................................................10-110.2 License Manager Errors....................................................................10-110.3 Entering PDMS .................................................................................10-210.4 Starting Appware in DESIGN/DRAFT/ISODRAFT/

PARAGON/SPOOLER/ADMIN.........................................................10-310.5 Problems with Graphics ....................................................................10-3

VANTAGE PDMS Installation Guide 1-1Version 11.5

1 Introduction

This guide explains how to install and set up PDMS Version 11.5 on aworkstation running the Microsoft Windows 2000 or Windows XPoperating system (hereafter referred to jointly as 'Windows'). LocalAdministrator rights are required to perform the installation.This guide assumes you are familiar with the concepts of folder/filehierarchies for storing data on disks and with basic Windowsterminology and commands. If you are not, you may also need to refer toyour operating system documentation while you carry out theinstallation.The guide also assumes that you have already gained access to thePDMS installation files via a CD, from the AVEVA Web site, or by someother route.

1.1 Contents of this Guide

Hardware and software requirements are described in Chapter 2. Forcompletely up-to-date information, please see the AVEVA Website athttp://www.aveva.com/engineeringit and refer to the Customer SupportHardware pages. The Web pages also give hints on ways of setting upand running PDMS on different computers in order to achieve the mostefficient performance.Chapter 3, Installing PDMS, describes how to install PDMS 11.5 andlicense the software.Chapter 4, Setting Up the Windows Environment, explains how toconfigure the Windows operating system before you run PDMS.Chapter 5, Language Support, describes how to set up the WindowsEnvironment to use PDMS with different Language options.Chapter 6, Running PDMS under Windows, gives some advice on usingPDMS in a Windows environment.Chapter 7, PDMS Projects, describes the sample project that is suppliedas part of PDMS, and how to set up your own projects.Chapter 8, Installing AutoDRAFT, describes how to install and configurePDMS AutoDRAFT.

http://www.cadcentrewww.aveva.com/engineeringit

Introduction

1-2 VANTAGE PDMS Installation GuideVersion 11.5

Chapter 9, Upgrading Projects to Version 11.5, describes how to upgradeyour existing PDMS 11.3 or 11.3SP1 projects for use with PDMS 11.5. Noupgrade process is required to use PDMS 11.4 projects with PDMS 11.5.Chapter 10, Troubleshooting, describes some of the errors that you couldencounter when running PDMS.


2 Hardware and Software Requirements

This section describes the hardware and software configurations thatPDMS requires to run under Windows.

2.1 Hardware

The following list gives a minimum specification for your computer.• Processor Intel Pentium family, or equivalent.• Memory 128MB minimum; 256MB recommended.• Hard disk At least 670MB free space for a full

installation; more free space is recommended toallow for projects etc.

• Graphics Card See below.• CD drive CD-ROM will be used for media distribution.• Mouse Three-button mouse strongly recommended.

2.1.1 Graphics Cards

PDMS uses standard OpenGL for its 3D graphics.Due to the continuously and rapidly changing list of hardwareaccelerated OpenGL graphics cards commercially available, an up-to-date list of supported graphics cards cannot be included in thisdocument. However, the AVEVA Web pages(http://www.aveva.com/engineeringit) contain a current list of both testedand supported graphics cards.Other graphics cards which fully support the OpenGL standard shouldalso work, but AVEVA cannot offer assistance in configuring these. Youmay also find some problems, for example, when picking items in PDMS.


Hardware and Software Requirements


2.2 Software and Configuration

The following software should be installed and configured on yourcomputer to enable PDMS 11.5 to run.• PDMS 11.5 is fully supported under:

• Windows 2000 with Service Pack 2• Windows XP ProfessionalNote that Windows 2000 and Windows XP Service Packs and HotFixes from Microsoft are required for PDMS to run effectively.Please refer to the AVEVA Support web site, or contact the AVEVASupport team for details of the latest recommended Windows 2000and Windows XP environment for PDMS.

• PDMS 11.5 databases must be on an NTFS File System: FATCpartitions are not supported.

• The license manager must have a drive called C: available forwriting temporary information. In the case of double boot machines,where D: is the system disk for Windows XP/2000 and C: is used foran earlier version of Windows, the license manager will still work,since it does not require NTFS.

• Optionally, you can have Microsoft Excel installed for outputtingreports.


3 Installing PDMS

3.1 Basic Installation

Local Administrator rights are normally required to install PDMS.

1. To install PDMS from CD – Insert the CD into your CD-ROM drive.If you have AutoPlay enabled for the drive, the installation startsautomatically. Otherwise, run Start.htm on the CD.If you are installing PDMS from the network – Click Start>Run onthe Windows taskbar and type the path to the Start.htm file onyour network.

2. Click on CD CONTENTS and select the product which you want toinstall (in this case PDMS Version 11.5), then click INSTALL. ClickOK on any confirmation forms which appear.

3. On the File Download form, select Run this program from its currentlocation (IE 5.0) or Open (IE 5.5 later) to install the program filesdirectly from their current location onto your hard disk. Select Yeson the Security Warning query about an Authenticode signature.

4. This starts the InstallShield® Wizard, which will lead you throughthe rest of the installation process.

During the installation sequence, follow the on-screen instructions asthey appear. You will be given a choice between two levels of installation:• Full installation: Installs all available product components

(recommended for a new installation unless there are good reasonsfor restricting the options available to end users).

• Custom installation: Presents you with a list of all available productcomponents from which you can select those to be installed.

It is recommended that you use the default settings for folder paths etc.unless you have good reasons for doing otherwise. You must not useembedded spaces in folder path names.The process needs at least 670MB of free disk space for a full installationof all options. InstallShield checks that there is enough space availablebefore it starts, and warns you if there is not.

Installing PDMS


When the process is complete, select Start>Programs/Aveva/VANTAGEPDMS 11.5 to reach the Run PDMS, Make PDMS project and PDMS manualsoptions.

3.2 Uninstalling and Reinstalling

If InstallShield detects an existing PDMS installation, it will display theoptions for modifying/repairing/removing the files rather than simplyoffering the standard installation options.To remove installed components from your hard disk, or to add additionalcomponents to an existing installation, select Start>Settings>Control Paneland use the Add/Remove Programs tool.As an alternative procedure, repeat Steps 1 to 4 of the installationsequence detailed above. The InstallShield® Wizard will detect yourexisting installation and will give you the following options:• Modify: Displays the same list of options as the Custom installation.

Select new components to be added and/or deselect any currentlyinstalled components to be removed.

• Repair: Reinstalls all currently installed components (to correct anycorrupted files etc.).

• Remove: Removes all currently installed components.

3.3 FLEXMAN License Manager

You must install and set up the FLEXMAN license system before PDMScan be used. See the FLEXMAN Installation Guide.

3.4 Remote Installation

If you wish to have one server installation of PDMS accessed from remoteworkstations, you must ensure that the Windows system DLLs on eachremote workstation are upgraded to a suitable version for running thePDMS 11.5 application programs. You can achieve this by installingPDMS 11.5 itself in minimal form; that is, select the Custom Installationtype and then deselect everything except 'PDMS Core Components'.

Installing PDMS


In addition, this release includes a stand-alone 'Thin Client' installerwhich can be used on individual workstations to update the necessaryWindows system DLLs, and which also provides start menu shortcuts tothe main PDMS installation.The Thin Client installer is a self-extracting Installshield® executablewhich is held in the C:\AVEVA\PDMS11.5\thin_client_installer\subfolder. It is applicable when the main PDMS 11.5 product is installedeither from the 'Full Installation' option, or the 'Custom Installation'option with the 'Thin Client Installer' component selected.

Installing PDMS



4 Setting Up the Windows Environment

This chapter describes how to configure the Windows operating systembefore you run PDMS. Following installation of PDMS, you shouldperform the following steps:• Check the settings for your graphics board: See Section 4.2.• Ensure the FLEXMAN License Manager daemon is running, and

set environment variables relating to FLEXMAN: See Section 4.3.• Configure Windows parameters for PDMS: see Section 4.4.• You can then run PDMS by clicking on the PDMS shortcut or icon,

which will set up the remaining environment variables required.Note: In the following instructions it is assumed that PDMS 11.5 has

been installed in folder C:\AVEVA. If it has been installedelsewhere, substitute C:\AVEVA with the name of the installationfolder.

4.1 Windows Control Panel

The Windows Control Panel contains tools that are used to change theway Windows looks and behaves. This Install Guide describes how to useControl Panel tools to configure Windows to run PDMS.Open the Control Panel as follows:Windows 2000

Click Start, point to Settings, and then click Control Panel

Windows XPIf your computer is set up with the Classic Start menu, click Start,point to Settings, and then click Control Panel.If your computer is set up with the standard Start menu, click Startand then click Control Panel.

Setting Up the Windows Environment


4.2 Graphics Board Settings

You should set your display to a resolution of at least 1024 x 768 and thecolour depth to True colour or 16.7 million colours.This can be set by opening the Control Panel. Select Display and select theSettings tab. Make the appropriate selections on the form for yourgraphics card.Due to the rapidly changing list of hardware accelerated OpenGLgraphics cards commercially available, an up-to-date list of supportedgraphics cards, graphics device drivers and recommended device driverconfiguration cannot be included in this document. However, the AVEVASupport Web pages (http://www.aveva.com/engineeringit) contain acurrent list of both tested and supported graphics cards, along withadvice on configuration of graphics device drivers.

4.3 Setting the License File Location

Before you can use PDMS, you must set up the FLEXMAN licensesystem and connect to the FLEXMAN License Manager daemon (see theFLEXMAN Installation Guide),.Each User needs to set a license path that defines the location of thelicense file or service. For earlier versions of FLEXMAN, setting theenvironment variable LM_LICENSE_FILE did this. However, thisapplied to all software using FLEXlm. You can now setCADCENTRE_LICENSE_FILE instead that applies only to softwareusing our Vendor License Manager Daemon.To avoid users having to repeatedly set such an environment variable,FLEXlm itself now remembers the current setting in the WindowsRegistry. This Registry setting will initially come from the value of thecorresponding environment variable, but cannot then be modified bychanging the environment variable – you must use the FLEXlm utilitylmtools or the new command-line lmpath to query or set the licensepath.The environment variable can be set in one of three ways, either in thePDMS entry script, as a User Environment Variable in the Control Panelor manually in a command window.To set manually or in the PDMS entry script, type the following in acommand window or in the entry script before starting PDMS:

set CADCENTRE_LICENSE_FILE=Port@Computername




To set automatically:Windows 2000 and Windows XP• Open the Control Panel.• Select System, and pick the Advanced tab• Click on the Environment Variables button• Set the CADCENTRE_LICENSE_FILE user environment

variable to the location of the license obtained from AVEVA(Port@Computername). For example:

CADCENTRE_LICENSE_FILE744@licserv

To confirm the licence environment variable setting, open a commandwindow and type the command SET. You should see a list ofenvironment variables, including:

CADCENTRE_LICENSE_FILE=Port@Computername

or to check the Registry setting, typelmpath –status

You should see an output including the following:

lmpath - Copyright (C) 1989-2002 Globetrotter Software,Inc.

Known Vendors:

cadcentre: 744@licserv

...

4.4 PDMS Environment Variables

PDMS uses Windows Environment variables to locate folders containingPDMS system files and users project data. This allows you to locate thesefolders anywhere on the file system. The default location for PDMSsystem files is C:\AVEVA\PDMS11.5, but the location of the pdms11.5folder can be changed if desired when PDMS is installed.PDMS is supplied with a file evars.bat in the PDMS executables folder(C:\AVEVA\pdms11.5) which sets default values for the environmentvariables so that they point to the folder structure as installed. It alsosets the PATH variable to include the PDMSEXE folder containing PDMSexecutables.



You may need to modify this file to reflect the folder structure of yourown installation. The following is a list of the variables you may need toreset, with a brief description of each one and the default setting.Note that all environment variables must be UPPERCASE.It is recommended that users should not write to the pdms11.5installation folder or any of its contents:

PDMS System Environment Variables

The following environment variables refer to the location of PDMSsystem files.PDMSEXE Executable folder

C:\AVEVA\pdms11.5

PDMSEXEMAIN Copy of PDMSEXE, but can be a search pathC:\AVEVA\pdms11.5

CADCENTRE_LICENSE_FILE License fileSee section 4.3, Setting the License FileLocation

PDMSUI Application User Interface folder (PML 1)C:\AVEVA\pdms11.5\pdmsui

PMLLIB Application User Interface folder (PML 2)C:\AVEVA\pdms11.5\pmllib

PDMSDFLTS Applications defaults folderC:\AVEVA\pdms11.5\pdmsui\dflts

PDMSPLOTS Applications PLOTS folderC:\AVEVA\pdms11.5\pdmsui\plots

PLOTCADC Pointer to the PLOT executable.C:\AVEVA\pdms11.5\plot\plot.exe

PDMSHELPDIR Online help data files.C:\AVEVA\pdms11.5\onlinehelp

PDMS User Environment Variables

The following environment variables refer to the location of users PDMSfolders. Users must have write permission to these folders.PDMSWK Temporary PDMS work file folder

C:\temp

PDMSUSER Application Users save/restore setup area (or the users'home' folder)C:\AVEVA\pdms11.5\pdmsuser

PDMSREPDIR PDMS Applicationware Report Input and Output folder.C:\AVEVA\pdms11.5\pdmsui\reports



PDMSDFLTS Applications defaults folder. Note that individual usersmay not have permission to change PDMS Systemdefaults in C:\AVEVA\pdms11.5\pdmsui\dflts, butthey should have their own local defaults area. This isachieved by setting a PDMSDFLTS search path, e.g.‘C:\USERDFLTS C:\AVEVA\pdms11.5\pdmsui\dflts’

Project Environment Variables

For each PDMS project, four more environment variables must be set.For example, for a project ABC:ABC000 Project database folderABCISO Project ISODRAFT options folderABCMAC Project inter-DB connection macro folderABCPIC Project DRAFT picture file folderPDMS is installed with sample project data (See Chapter 7 PDMSProjects). PDMS Project Environment variables for these projects are setin evars.bat.

4.5 Running PDMS from a Command Prompt Window

You can run PDMS from a Command Prompt window rather than usingthe Start/Programs menu. To do this you must set your PATH variableto include the folder where PDMS is installed.Windows 2000 and Windows XP• Open the Control Panel.• Select System, and pick the Advanced tab.• Click on the Environment Variables button.• Edit the system variable Path to add the PDMS folder (for example,

C:\AVEVA\pdms11.5) to the list of folders in the Path variable.Once the Path variable includes the pdms11.5 folder, you can run pdmsby typing pdms at a command prompt.

4.6 Customising PDMS Start-Up

There is a batch (.bat) file supplied in C:\AVEVA\pdms11.5 calledpdms.bat which allows entry into PDMS.You can run PDMS using this batch file in any of the following ways:



• Use the shortcut in the Windows Start menu,Start>Programs>AVEVA>VANTAGE PDMS 11.5>Run PDMS

• You can create a shortcut on your desktop to run your batch file.With the cursor in the desktop area, click with the right-handbutton and select New>Shortcut. This shows a sequence of dialogs tohelp you create the shortcut. Type in the location of pdms.bat, forexample:C:\AVEVA\pdms11.5\pdms.batthen press Next and give the shortcut a name.Press Finish. You should now be able to double-click on the shortcuticon to enter PDMS.

• If you have C:\AVEVA\pdms11.5(the path name for the pdms.batfile) in your PATH environment variable, just type pdms in acommand window to execute the batch file.

• Otherwise, navigate to the folder where the batch file is stored andtype pdms or pdms.bat.

You can set up your own batch files to run PDMS. For example, you maywish to run design checking utilities every night, or update batches ofdrawings overnight.Begin by creating a batch file, for example, runpdmsmacro.bat.Type the following line into this file:

C:\AVEVA\pdms11.5\pdms.bat TTY SAM SYSTEM/XXXXXX /STRUC $M/mymacrofile

Where:• TTY tells PDMS not to start the PDMS GUI. This gives command line

only operation.• SAM is the project name.• SYSTEM/XXXXXX is the PDMS username/password to be used

when running the command macro• /STRUC selects the required MDB• mymacrofile is the pathname of a PDMS command macro, containing

the commands that you want to execute in PDMS.

In this example, running runpdmsmacro.bat will enter PDMS in projectSAM, as user SYSTEM/XXXXXX, in MDB /STRUC, and run the PDMScommand macro mymacrofile.The VANTAGE PDMS MONITOR Reference Manual provides moredetails on running PDMS batch programs.



4.7 Plotting

To plot in a Windows environment, we recommend that you use theplotcadc.bat file supplied in the pdms11.5 folder. Note that you may haveto modify the plotcadc.bat file to suit your local printer installation.The Network Plotter must be mapped using the NET USE command. Seeyour network documentation for more information.To run the plotcadc.bat file, give a command in the format:

C:\AVEVA\pdms11.5\plotcadc.bat plotfile format printer optionsWhere options are the AVEVA PLOT utility options, and may be omitted.See the PLOT User Guide for more information. Note that the optionsmust be enclosed in quotes.For example:plotcadc.bat c:\pdms\plot1 ps \\ntserver\NTPostScript

plotcadc.bat c:\pdms\plot1 hpgl \\ntserver\NThpgl 'CE=Y'


5 Language Support

By default, your PDMS project can use any language whose charactersare contained within the Latin-1 character set. The Languages coveredby the Latin-1 character set a listed in the table below. If you want to useany of the other, non-Latin-1 languages supported by PDMS, it isnecessary to configure your PDMS project and the Windows operatingsystem. This chapter describes how to use PDMS on Windows 2000 andWindows XP Professional in each of the supported language groups:

• Latin-1• Latin-2• Latin-Cyrillic• Far Eastern

Supported languages

Name Description Languages covered

Latin 1 ISO 8859-1 Latin alphabet 1 Danish, Dutch, English, Faroese,Finnish, French, German,Icelandic, Irish, Italian,Norwegian, Portuguese,Spanish, Swedish,

Latin 2 ISO 8859-2 Latin alphabet 2 Albanian, Czech, English,German, Hungarian, Polish,Rumanian, Serbo-Croat, Slovak,Slovene

Latin Cyrillic ISO 8859-5 Latin/Cyrillicalphabet

Bulgarian, Byelorussian,English, Macedonian, Serbo-Croatian, Ukrainian, Russian

Far Eastern Japanese, Korean, SimplifiedChinese, Traditional Chinese

PDMS does not support any other language character set, nor does itsupport the mixing of any of the above, except for mixing one FarEastern language with English.

Language Support


5.1 Preparing Windows to Use Supported Languages

5.1.1 Windows 2000

To add an additional language in Windows 2000, follow these steps:1. Open the Control Panel.2. Double-click Regional Options to show the Regional Options dialog.3. Click the Input Locales tab.4. In the Input Locales box, click the required language, and then

click Properties.5. In the Keyboard Layout box, click the required keyboard layout,

click OK, and then click OK.6. Click the General tab. Click to select the check box next to the

language group you wish to install, and then click Apply. Thesystem will either prompt for a Windows 2000 CD-ROM or accessthe system files across the network. Once the language isinstalled, Windows 2000 will prompt you to restart the computer.

5.1.2 Windows XP

To add an additional language in Windows XP, follow these steps:1. Open the Control Panel.2. Double-click Regional and Language Options.3. On the Regional options tab, under “Standards and formats”,

select the required language from the list.4. Click the Languages tab, and then click Details under "Text

services and input languages".5. Under “Default input language”, select the required language. If

the required language appears in the list, click OK.If it does not appear in the list, then click Add under "InstalledServices", and then click the language you want to add and thekeyboard layout you want to use for that language.To configure the settings for the Language bar, click LanguageBar under "Preferences". The Language bar is used to switchbetween languages while you are using PDMS. Click OK to closethe Language Bar Settings dialog.Click OK to close the “Text Services and Input Languages” dialog.

Language Support


6. Click the Advanced tab. Under ”Languages for non-Unicodeprograms”, select the required language. Click Apply. It may benecessary to install new code page conversion tables. Only memberof the Administrators group can install code page conversiontables. The system will either prompt for a Windows XP CD-ROMor access the system files across the network. Once the language isinstalled, Windows XP will prompt you to restart the computer.

Note: For Far Eastern language support, it is necessary have the EastAsian support option installed.

5.2 Preparing PDMS to Use Latin-1, Latin-2 or Latin-Cyrillic Languages

In PDMS ADMIN, you must specify a character set for each project byusing one of the following commands on the PDMS ADMIN commandline:

Command Languages covered

PROJECT CHARSET LATIN 1

(default)

Danish, Dutch, English, Faroese,Finnish, French, German, Icelandic,Irish, Italian, Norwegian, Portuguese,Spanish, Swedish,

PROJECT CHARSET LATIN 2 Albanian, Czech, English, German,Hungarian, Polish, Rumanian, Serbo-Croat, Slovak, Slovene

PROJECT CHARSET LATIN CYRILLIC Bulgarian, Byelorussian, English,Macedonian, Serbo-Croatian,Ukrainian, Russian

The corresponding font family must be selected for Draft and Isodraftdrawings. Use Project>Font Families and select the Font Type appropriatefor you chosen language.For details, see the VANTAGE PDMS ADMIN User Guide andVANTAGE PDMS ADMIN Command Reference Manual.

5.3 Preparing PDMS to Use a Far Eastern Language

You must ensure that your licence file is for the language version yourequire.

Language Support


Before you use PDMS, you must set the environment variableCADC_LANG as follows:CADC_LANG=Japanese KanjiCADC_LANG=KoreanCADC_LANG=Chinese Simplified ChineseCADC_LANG= TChinese Traditional ChineseIn PDMS ADMIN, you must specify the multibyte character set for eachproject by using the command corresponding to your required language:PROJECT MBCHARSET JAPPROJECT MBCHARSET KOR FILE /<font filename>PROJECT MBCHARSET CHI Simplified ChinesePROJECT MBCHARSET TCHIN FILE /<font filename>

Traditional Chinese

For details, see the VANTAGE PDMS ADMIN User Guide andVANTAGE PDMS ADMIN Command Reference Manual.


6 Running PDMS under Windows

6.1 Spaces in Windows pathnames

To run macros with spaces in the filenames, you must enclose thefilename in quotes, without a leading slash. For example:$m'c:\Program Files\Macros\space.mac' arg1 arg2

6.2 Linking to Microsoft Excel

You can make your reports load directly into a Microsoft Excelspreadsheet, as comma-separated files:• Select Utilities>Reports>Modify from the PDMS main menu bar.• Pick a report template.• Click on OK: the Modify Template form is displayed.• Select Options>Other Formats... from the Modify Template form menu

bar. This displays the Report Format form. From this form:• Choose the CSV option from the Format drop-down list.• Click on OK: this returns you to the Modify Template form.

• Select the Overwrite radio button• For the filename enter %PDMSUSER%/fname.csv (the .csv

extension is important).• In the System command text box enter 'cmd/c “C:\<excel folder>\excel.exe” %PDMSUSER%\fname.csv'

where C:\<excel folder> is the location of Excel on your system.Note that it is necessary to enclose Windows command argumentsin double quotation marks if the argument contains embeddedspaces. :\<excel folder>\

Running PDMS under Windows


6.3 Windows Parameters

The following setting can be used to improve performance whenrepositioning forms in PDMS. This is an optional Windows Parametersetting.Windows 2000Open the Control Panel. Select Display and select the Effects tab. On theform, uncheck Show Window Contents While Dragging.Windows XPOpen the Control Panel. Select Display, then select the Appearance tab andclick on the Effects… button. On the form, uncheck Show Window ContentsWhile Dragging and Show shadows under menus.


7 PDMS Projects

7.1 The Sample Project

PDMS is supplied with a sample project, which can be used in severalways:• It provides you with examples of the use of PDMS.• It provides you with sample libraries, catalogues and specifications

which enable you to use PDMS before you set up your own, and canbe used as starting points when you do start to create your own.

• It provides you with starting points for the tutorials in the followingmanuals:Pipework Design Using PDMSPipework Spooling Using PDMSStructural Design Using PDMSIndustrial Building Design Using PDMSSupport Design Using PDMSHVAC Design Using PDMSReporting from PDMSDrawing Production Using PDMS

• It provides an example of how to set up your own projects.The sample project is actually two projects in PDMS terms:• MAS (Master) provides data in read-only databases. This data

should not be deleted or changed in any way, or the rest of thesample project will become unusable.

• SAM (Sample) contains several MDBs which can be modified, andso they can be used for training,

7.1.1 Copying Project SAM to Your User Area

The sample project is loaded automatically when you install PDMS. Youshould copy the sample project to your user area and run it as supplied.

PDMS Projects


The project files are held in two directories: sam000 holds all designdata and catalogue data; sampic holds the DRAFT picture libraries.

7.1.2 Users and Teams in the Sample Project

Free User

The Free user has username/password SYSTEM/XXXXXX.

General UsersTeam Username/passwordCATS CATS/CATSDEMO DEMO/DEMOEQUI EQUI/EQUIHANGER HANGER/HANGERHVAC HVAC/HVACPIPE PIPE/PIPESAMPLE SAMPLE/SAMPLESTRUC STRUC/STRUC

General User with Administration Rights

There is a user named ADMIN who is a member of all teams exceptMASTER. In particular, ADMIN is a member of the following teams:

CATADMINDRAFTADMINHSADMINISOADMIN

Membership of these teams gives special administration rights withinthe corresponding constructor module.Each MDB contains databases with appropriate access rights. There arealso teams and users associated with each MDB with appropriate accessrights.

7.1.3 MDBs in the Sample Project

This section assumes that you are already familiar with PDMSdatabases.The sample project contains the following MDBs:

PDMS Projects


CATS An MDB for practising using Catalogues andSpecifications.

DEMO A demonstration MDB.EQUI An MDB for the Equipment tutorials.HANGER An MDB for the Support Design tutorial. This MDB

contains suitable pipework, steelwork and civils as astarting point.

HVAC An MDB for the HVAC Design tutorial. This MDBcontains suitable steelwork and civils as a starting point.

SAMPLE An MDB for the Reporting from PDMS and DrawingProduction tutorials. This MDB contains design data fromwhich reports and drawings can be produced. You canalso produce isometrics.

STRUC An MDB for the Structural Design tutorial.PIPE An MDB for the Pipework Design and Pipework Spooling

tutorials.

7.2 Creating PDMS Projects

For full information on setting up your own projects, see the VANTAGEPDMS ADMIN User Guide.You will need to create project folders for each project; for example, for aproject xyz:

md xyz000md xyzpicmd xyzisomd xyzmac

Set the corresponding environment variables that point to thesedirectories. You can do this by setting Environment Variables using theControl Panel, or by modifying the evars.bat file used to configureyour PDMS Windows installation. (see Chapter 4, Setting Up theWindows Environment, for further details). Alternatively, type thefollowing in an MS-DOS window:

set XYZ000=pathname\xyz000set XYZPIC=pathname\xyzpicset XYZISO=pathname\xyzisoset XYZMAC=pathname\xyzmac

Note: Users converting from Unix should note that there is no directequivalent of the .cshrc file in which these variables can be set.

PDMS Projects


Use the 'Make PDMS project' icon supplied to start the PDMS Makeprogram, then enter:

XYZ$m/%PDMSEXE%/makemac.macFINISH

Note: Users converting from Unix should note that the makemac.macfile is the same as on Unix. The executable for each module isalso named identically to that on Unix, e.g. DESIGN runs%PDMSEXE%/des. The extension '.exe' needed by Windows isadded automatically.

7.2.1 The Sample Project and Your Own Projects

You can add databases from the sample projects SAM and MAS to yourown projects from within PDMS ADMIN, using the Install options on themain menu bar. Note that these options are only available if you havethe project environment variables for SAM and MAS set.

Note on DRAFT Libraries:You must have DRAFT libraries available in your current project beforeyou can enter the module. You may find it convenient to install thelibraries supplied by AVEVA in the MAS project (using the Installoptions), even if you wish to create your own libraries for the project.


8 Installing AutoDRAFT

This chapter explains the steps needed to install and configureAutoDRAFT.Under Windows, AutoDRAFT may be run in stand-alone mode or it maybe run from PDMS DRAFT or ISODRAFT. You can use the adraftde,adraftbe and adraftse scripts as described in the VANTAGE PDMSAutoDRAFT User Guide. The DRAFT and ISODRAFT applicationwaregenerates interface files for AutoCAD, which are then used by thescripts.AutoDRAFT generates interface files for DRAFT, which can be importedusing the DRAFT applicationware.

8.1 Compatibility

The version of AutoDRAFT released with PDMS 11.5 is compatible withAutoCAD Releases 2000i and 2002.

8.2 The AutoDRAFT Software

AutoDRAFT software consists of three AutoCAD applications that runwith AutoCAD Releases 2000i and 2002, and PDMS application macrosto link the AutoDRAFT applications with PDMS DRAFT andISODRAFT.The three AutoCAD applications are:• AutoDRAFT Drawing Editor• AutoDRAFT Frame Editor• AutoDRAFT Symbol EditorAll three editors can be used with PDMS DRAFT. The AutoDRAFTDrawing Editor can be used with ISODRAFT.The Drawing Editor is used to modify drawings transferred from PDMSDRAFT or PDMS ISODRAFT.The Frame Editor is used to transfer AutoCAD drawings into backingsheets or overlay sheets in PDMS DRAFT.

Installing AutoDRAFT


The Symbol Editor is used to convert AutoCAD graphics into symboltemplates within PDMS DRAFT symbol libraries.

8.3 Configuring AutoDRAFT with AutoCAD

The AutoDRAFT 11.5 software is installed under the PDMS executablesfolder:

autodraftACAD

pdms11.5

autodraftfonts autodraftACADsource

• The autodraftACAD folder contains .bat files, AutoDRAFT scripts,AutoLISP programs, binary DRAFT menu files and an AutoCADlinestyle file.

• The autodraftfonts folder contains AutoCAD font files. All of theseare needed to run AutoDRAFT programs in AutoCAD.

• In addition to the AutoDRAFT binary menu files, text versions arealso provided. These are supplied in the autodraftACADsource folderfor reference/customisation. This folder should not be visible byAutoCAD.

Note: The AutoDRAFT software will only operate properly if AutoCADcan be run using the acad command. AutoDRAFT cannot beguaranteed to work if the AutoCAD executable acad has beenrenamed, or if the acad command runs a user-supplied file whichitself runs AutoCAD.

8.4 Installing and Configuring AutoCAD

In order to use AutoDRAFT, AutoCAD must be installed and configuredfor each computer where AutoDRAFT will be used. The AutoCADInstallation and Performance Guide supplied with AutoCAD describeshow to do this.



Configure AutoCAD so that it can find the extra menus and fonts used inAutoDRAFT. How you do this depends on your version of AutoCAD;typically:• In AutoCAD, move the cursor into the command region and click the

right-hand mouse button. Select Preferences, then Environment.• Add the appropriate paths to the autodraftACAD,

autodraftACADsource and autodraftfonts directories to theOptions>Files>Support File Search Path field.

The AutoDRAFT environment variable setting commands applicable toeach release of AutoCAD are listed in the following sections. Theenvironment variables are set within the supplied pdms.bat file. Theseshould be edited to suit the installed version of AutoCAD.

8.4.1 AutoCAD R2000i

set PDMS_ACAD=2000iset PDMS_ACAD_PATH=pathname for AutoCAD R2000 files

e.g. C:\Program Files\AutoCAD 2000i;C:\ProgramFiles\Common Files\Autodesk Shared

set ACAD_VERSION=%PDMS_ACAD%set path=location of autodraftACAD folder;%PDMS_ACAD_PATH%;

%path%Before running AutoDRAFT, you need to run AutoCAD R2000i and addthe following as file paths:Location of autodraftACAD folderLocation of autodraftACADsource folderLocation of autodraftfonts folder

8.4.2 AutoCAD R2002

set PDMS_ACAD=2002set PDMS_ACAD_PATH=pathname for AutoCAD R2002 files

e.g. C:\Program Files\Acad2002;C:\Program Files\Common Files\Autodesk Shared

set ACAD_VERSION=%PDMS_ACAD%set path=location of autodraftACAD directory;%PDMS_ACAD_PATH%;

%path%Before running AutoDRAFT, you need to run AutoCAD R2002 and addthe following as file paths:



Location of autodraftACAD directoryLocation of autodraftACADsource directoryLocation of autodraftfonts directory

8.5 Getting Started with AutoCAD

Before using the Drawing Editor make sure that AutoCAD has beencorrectly installed and configured by entering the command acad at theoperating system command prompt.

8.6 Application Macros for Use with PDMS DRAFT

The applicationware provides the additional menus and forms requiredto run the AutoDRAFT editors in AutoCAD directly from DRAFT andISODRAFT.


9 Upgrading Projects to Version 11.5

No upgrade procedure is required for PDMS 11.4 projects. You candirectly access PDMS 11.4 projects using PDMS 11.5.If you are upgrading from an earlier version of PDMS, it is necessary toupgrade your PDMS projects from each PDMS version to the next byusing the upgrade procedure supplied with the appropriate version ofPDMS. For example, to upgrade a project from PDMS 11.3 to PDMS11.5, it is first necessary to load the PDMS 11.4SP1 product, and use itsupgrade procedure to create a PDMS 11.4/11.5 version of your project.

Upgrading Projects to Version 11.5



10 Troubleshooting

Here are some suggestions about solving some problems you mayencounter when using PDMS under Windows.

10.1 General

Error: The dynamic link library DFORMD.dll could not be found in thespecified path.

Explanation: This is supplied with PDMS. Perhaps you have not set your PATHvariable. The PATH setting must include ‘C:\AVEVA\pdms11.5’.

Error: STOP The application failed to initialise properly (0xc0000135). Clickon OK to terminate the application.

Explanation: This occurs after a number of other errors. The most likely reason is aproblem with the PATH variable.

10.2 License Manager Errors

Error: When you start up lmgrd it says <time> (lmgrd) Can't make folderC:\FLEXlm, errno: 2 No such file or folder, etc.

Solution: There is no C: drive for the license manager to write to. As the SystemAdministrator or a Power User, you need to make a shared disk calledC:. This can be done on a networked or non-networked computer.Within the Windows Explorer’s File menu, create a new folder (e.g.D:\C_drive) and make it current. Select File>Properties and selectthe Share tab. Click on the Shared As: radio button and then click OK.Then from the Tools menu select Map Network Drive. Select C: fromthe Drive: drop-down list in the displayed form and type

\\hostname\C_drivein the Path box. Then click on OK. (C:) should now appear in the list ofavailable drives in Explorer.

Error: <time> (lmgrd) "<host>": Not a valid server hostname, exiting.Explanation: The hostname used by AVEVA to create the license file does not

correspond with the computer on which you are running PDMS. Thehostname comes from the variable COMPUTERNAME, which you can

Differences Between 10.5.4 and 11.3 on NT


obtain by typing 'env|findstr COMPUTERNAME' in a CommandPrompt window. Compare this with the license file contents, andresubmit if necessary.

Pop-up Mess.: FLEXlm: checkout failed: Cannot connect to license server (-15,10:10061) WinSock error code.

Explanation: lmgrd has not been started up - see above for details.

Pop-up Mess.: FlexLM: checkout failed: Cannot find license file (-1,73:2) No such fileor folder.

Explanation: lmgrd has not been started up - see above for details.

Pop-up Mess.: FlexLM: checkout failed: Licensed number of users already reached(-4,132).

Explanation: You have exceeded the permitted number of users specified in yourlicense file.

10.3 Entering PDMS

Error: (43,9) Environment Variable not defined for project name.Explanation: You have not set the environment variable for the project, e.g. XYZ000.

Error: (43,1) Project <xxx> not available!Error 7 allocating system database.

Explanation: The environment variable for the project does not point to the correctlocation. Either the disk and/or folder do not exist or are not readable.

Error: <username> not found.orBad password.

Explanation: You are trying to enter PDMS without a valid PDMS username and/orpassword.

Error: PDMSWK environment variable not set.Solution: Set PDMSWK to c:\temp or some other folder where PDMS can create

temporary files.

Error: Error 34 opening variables file.Explanation: You cannot create a file in the location pointed to by environment

variable PDMSWK.


Error: Project <xxx> is pre version 8.Explanation: This can happen if you have transferred the project from Unix using

FTP in ASCII rather than Binary format.

10.4 Starting Appware in DESIGN/DRAFT/ISODRAFT/PARAGON/SPOOLER/ADMIN

Error: Fatal Druid error handler UI_init. Couldn't even find the DefaultVisual.

Solution: The Display colour selection is incorrect. Refer to the Support pages onthe AVEVA website for information on supported graphics cards anddrivers.

Error: Syntax errors occur when entering PDMS, but before the initial formappears.orUsing the 'q directory ...' syntax results in the message 'The systemcannot find the path specified'.

Solution: This may be caused because the TEMP environment variable is not set,or points to a folder to which PDMS cannot write.

10.5 Problems with Graphics

Error: Cannot pick certain items in DESIGN 3D shaded views.Solution: There is probably a problem with the display driver for the graphics

board that you are using. Make sure you have the version of the displaydriver recommended on our supported display drivers Web page.

Error: Incorrect colours.Solution: Check the setting of your Display. The colour resolution should be set to

‘True Colour’ or 16.7 million colours.

Error: Graphics speed (for example in 3D views) is poor.Solution: Check the setting of your Display.

pdms 11.5 installation guide

Documents